接入步骤
本小节介绍接入方将 UBI SDK 接入到自有 APP 中的详细步骤。
创建应用
应用代表一个接入 UBI SDK 的租户账户，创建应用后百姓车联会为应用的所有者提供一个 APP ID 用于唯一标识该应用，以及一系列 access key 供应用接入 UBI SDK。不同应用的数据是隔离的，接入方可以根据业务需要要求百姓车联为其创建多个应用。百姓车联建议接入方创建两个应用，分别用于 UAT 环境和生产环境。
目前 UBI SDK 平台不支持在线申请创建应用，请联系百姓科服的技术对接人员，并提供必要的信息来创建应用。
接入方提供的信息
根据 数据存储方案 所述，UBI SDK 采集的手机传感器数据存储在接入方提供的 OSS 存储桶上。接入方需要为每个应用提供一个 OSS 存储桶的基本信息和具有读写权限的帐号。具体需要提供的信息如下表所示。
| 待提供信息 | 是否必需 | 示例 |
|---|---|---|
| OSS 所属地域 | 是 | cn-beijing |
| OSS 存储桶的名称 | 是 | user-data |
| Object key 的公共前缀 | 是 | thirdparty/bxcl/ubi/ |
| OSS 存储桶的 CDN 域名 | 否 | user-data.example-company.com |
| RAM 账户的 AccessKeyID | 是 | - |
| RAM 账户的 AccessKeySecret | 是 | - |
以上信息通过线下途径提供给百姓车联的研发即可。
注意
- 建议为不同应用提供独立的 OSS 存储桶和 RAM 账户。
- 建议提供所属地域为 cn-beijing（华北2 北京）的 OSS 存储桶。后续使用百姓车联的 MaxCompute 服务时会更顺畅。
应用关联的密钥
应用创建完成后，百姓车联会为接入方提供如下表所示的应用基本信息，这些信息在接入 UBI SDK 时需要用到。
| 属性 | 使用方式 |
|---|---|
| APP ID | 暂无使用场景，仅供留存 |
| AppCode | 使用 APPCODE 认证方式调用 UBI Passport 接口时使用该属性 |
| AppKey | 使用摘要签名认证方式调用 UBI Passport 接口时使用该属性 |
| AppSecret | 使用摘要签名认证方式调用 UBI Passport 接口时使用该属性 |
APP 接入 UBI SDK
创建应用完成后，业务方可以将 UBI SDK 接入到自己的 APP 中。百姓车联提供面向多种移动应用平台的 SDK，请参考对应平台的 SDK 接入文档完成 UBI SDK 的接入。