扫码控制 API

更新时间:2024-06-20 06:53:14下载pdf

为了方便控制设备,给开发者提供了扫码控制能力。此能力可嵌入第三方 App,通过第三方 App 进行扫码,唤醒 H5 控制页面,从而达到设备控制的能力。

扫码控制时序图

扫码控制 API

前提条件

已开通商照 SaaS 服务能力。

接入指南

  1. 生成二维码。

    1. 登录 SaaS 管理后台。
    2. 选择项目。
    3. 登录增值应用配置模块。
    4. 选择设备二维码分享

    扫码控制 API

  2. 第三方应用接入流程。

    1. 第三方应用 App 进行二维码扫码识别,解析获取URL

    2. 获取 ticket 认证凭据。点击查看获取方式

    3. 将步骤 1 获取的 URL 地址尾部添加 ticket 参数,例如&ticket=xxxxx

    4. 通过 App 的 webView 组件访问步骤 3 变更后的 URL。

    5. 正常访问页面。

      说明: URL示例 https://wx-saas-lighting.ismartlife.me/#/views/scan_code/index?id=xxx&ticket=xxx

页面异常错误信息

错误信息 说明
获取信息失败,请重新扫描二维码 ticket 无效