1. 云云对接
云云对接,即厂商自建设备云服务与 Homebase 云服务的对接,厂商智能家居设备连接自建云服务后,适配若琪智能家居协议,实现与 Homebase 云服务的对接。
1.1. 简介
1.2. 对接步骤
- 完成 企业认证
- 点击左下角 智能家居接入
- 点击 接入新品牌
填写品牌基本信息
- 品牌类型
- 公有:可以作为智能家居对外输出方案对外输出
- 私有:仅限于品牌创建者自有项目中的 C 端用户使用,不能通过若琪方案输出
- 品牌名称
- 品牌图标(大小:1024*1024px,只支持 png 格式,大小小于 2MB)
- 品牌描述(支持 Markdown 格式)
填写设备基础信息
- 安卓 App 下载地址
- iOS App 下载地址
- 服务联系方式
- 隐私政策页面地址(选填)
- 安装配置说明(支持 Markdown)
填写测试环境配置信息
- 授权配置 (上线后不可更改,开发过程中如若更改,用户基于上一种授权方式获取的授权将失效)
- OAuth2.0 授权(RFC6749)
- 授权地址(服务方用来授权给 Rokid 的调用地址)
- Token 地址(服务方用来给 Rokid 调用获取 token 的地址)
- Client ID(服务方分配给 Rokid 的 Client ID)
- Client Secret(服务方分配给 Rokid 的 Client Secret)
- 客户端授权类型 (约定 Rokid 发出的请求中授权信息携带方式)
- 授权范围(约定授权范围,选填)
- JWT 服务端授权(RFC7519)
- Souceld (默认已填写,不需要更改)
- AppKey (服务方分配给 Rokid 的 AppKey)
- AppSecret(服务方分配给 Rokid 的 AppSecret)
- OAuth2.0 授权(RFC6749)
- 接口基本信息
- 云端接口地址 (服务方提供的用于接收由 Rokid 发出的控制请求的地址)
- 自定义 Header(Rokid 调用服务方控制接口时需要携带的 header 信息,选填)
- 测试帐号(若琪 App 的注册手机号,可填写多个,用换行符分割)
- 授权配置 (上线后不可更改,开发过程中如若更改,用户基于上一种授权方式获取的授权将失效)
OAuth 2.0 流程自动检查 (页面上提供 OAuth2.0 流程自动检查功能,若出现如下提示,说明 OAuth2.0 流程正常,可进行下一步操作)
- 点击【发布到测试环境】,即可提交到测试环境进行自测(详细测试方法可见:厂商自测)
- 自测完成后,填写正式环境的配置信息,并点击【发布到正式环境】
发布上线(提交测试结果,您需提供如下信息)
我们会审核表单中信息,并根据测试报告内容进行真机测试验证,预计 1-2 个工作日可完成发布上线。
1.3. 相关文档
- 用户授权基于标准的 OAuth 2.0 协议,具体参考:符合 RFC6749 的 OAuth2.0
- 开发云端驱动,具体参考:若琪智能家居协议
- 调试云端驱动,可以使用:RHOME 桌面版调试工具 或 自定义接入