基于涂鸦云平台 OpenAPI 控制手指机器人

准备工作

• 涂鸦智能 App
• 智能网关
• Fingerbot

步骤一：将智能网关和 Fingerbot 连接到涂鸦智能 App

1. 按照提示将智能网关和 Fingerbot 设置为配网状态。通常为长按开启按钮。
2. 在涂鸦智能 App 中，发现并关联设备。

步骤二：在涂鸦 IoT 平台关联 Fingerbot

1. 创建全屋智能类型项目。

   1. 登录 IoT 工作台。
   2. 单击左侧导航栏中的云开发。
   3. 在云开发>项目页面，点击立即创建。
      
   4. 在创建项目页面，配置项目名称、项目描述和服务行业信息，选择全屋智能项目类型。
   5. 单击确定，完成项目创建。

2. 在项目详情页面，获取 API 授权密钥。
   

3. 关联 App 账号下的设备，并记录 Fingerbot 设备 ID device_id。

   1. 在顶部导航栏，单击关联设备。
   2. 在关联设备页面，单击关联 App 帐号下的设备页签右上角的添加 App 账号。
      
   3. 在扫码授权页面，通过涂鸦智能 App 扫描二维码。
   4. 单击确定。
   5. 在项目管理>设备列表，查看 Fingerbot 设备 ID。
      

4. 申请 API 权限。

   1. 选择 云开发 > API 管理> 产品中心。

   2. 在 所有产品 页面，单击授权管理和全屋智能设备管理 API 产品。
      

   3. 在 API 产品详情页，单击 开通。

   4. 在购买页面，选择产品类型和支付信息，单击立即购买。

   5. 在 API 产品详情页的已授权项目页签，单击新增授权。
      

   6. 在新增授权窗口，选择待授权的项目。

   7. 单击确定，完成授权。

步骤三：控制 Fingerbot

1. 调用获取设备详情 API，查看设备当前状态和详细信息。

   1. 选择 云开发 > API 管理>API 调试。
   2. 在 API 调试页面，调用 API。
      1. 选择项目。
      2. 选择需要调用的全屋智能设备管理 API 产品。
      3. 选择云平台接入区域，例如中国区。接入地址详情参见接入地址。
      4. 选择设备管理>获取设备详情 API。

         说明：在页面右侧区域的查看文档页签中，查看参数说明。

      5. 在 device_id， 输入 Fingerbot 设备 ID。
      6. 单击发起调用。
         

2. 在设备控制，调用获取设备支持的指令集 API，获取设备所支持的指令。
   

3. 在设备控制，调用控制设备 API，下发 switch 指令，开启或关闭 Fingerbot 。

   • 开启： { "code": "switch", "value":true }
   • 关闭： { "code": "switch", "value":false }
   

更多控制功能

你还可以通过 控制设备 API 为 Fingerbot 定时、设置工作模式等。示例指令如下：

• 定时：{"code": "timer","value":}
• 设置点击模式： {"code": "mode","value":click}
• 设置按拉模式： {"code": "mode","value":switch}

更多控制指令，请通过获取设备支持的指令集 API 获取。

Fingerbot 控制面板

Fingerbot 面板支持以下功能。

• 显示设备的状态、MAC 地址，共享设备以及固件版本等信息。
• 设置手指机器人摆臂上升和下降的幅度。
• 设置持续时间
• 显示电池电量
• 开启或关闭反向模式