小程序联网绑定

概述

鉴于以下原因，图灵推出小程序联网绑定方式：增加了蓝牙联网方式绑定，和微信公众号进行了解耦，解决了去微信进行授权、申请设备认证、次数限制等问题，此时设备绑定只需跟图灵服务端进行绑定。通过小程序联网绑定方式绑定后，在微信的“设置-设备”处不再显示相对应的设备。通过小程序联网绑定方式和通过公众号的联网不能混合使用，否则会出现绑定和解绑的混乱，建议使用小程序联网绑定。

微信很久没有对airkiss进行相关的维护了。
通过公众号向腾讯申请设备认证需要比较长的时间并且越来越难申请。
微信公众号管理接口每天有一定的上传和下载次数限制，当用户使用量比较大时，会影响到语音对讲及设备绑定功能等情况。
其他情况。

小程序联网接入

如果设备需要接入小程序联网，可接入图灵相关联网页面，需要在公众号设置该菜单；如果不需要接入，则不添加该项菜单设置。实际配置中需要将占位内容 {APPID}改成公众号真实的appid，将占位内容{APIKEY}改成图灵真实的apikey。菜单内容如下：（可参照公众号底部菜单设置说明文档）

小程序联网

小程序联网暂时支持声波、蓝牙、二维码 三种联网方式，可以根据自身情况选择其中一种或者多种，需要联系图灵相关人员开通此功能才可使用。实际效果图如下:

{
        "type": "view",
        "name": "小程序联网",
        "url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid={APPID}&redirect_uri=https://iot-ai.turingapi.com/mini-program/find-open-id/{APIKEY}&response_type=code&scope=snsapi_base&state=1&connect_redirect=1#wechat_redirect",
        "sub_button": []
}

蓝牙联网引导设置

在AI开发平台上可以对小程序的蓝牙配网进行引导设置。

Alt text

联网绑定流程

设备先通过蓝牙、声波、二维码等三种方式中的任意一种进行设备联网，待联网成功后调用图灵绑定接口进行设备和图灵云端服务的绑定，绑定成功后才可以使用语聊，绘本等功能。

蓝牙联网绑定流程

需要根据图灵提供的蓝牙配网协议文档进行联网接入(相关文档可联系图灵项目同事)，然后进行联网和绑定。

Alt text

声波联网绑定流程

设备端解析声波音频中的wifi账号和密码、加密后的openid等信息，然后进行联网和绑定。

Alt text

二维码联网绑定流程

设备端将扫描二维码获取到的字符串进行base64解码，解出来wifi账号和密码、加密后的openid等信息，然后进行联网。

Alt text

图灵绑定接口

设备端通过请求下述绑定接口进行设备和家长端的绑定。能够获取到真实openid时使用接口绑定1，否则使用绑定接口2。

绑定接口1

接口地址

https://iot-ai.turingapi.com/open/device/bind-wechat-user

请求方法

Method: POST
Content-Type: application/json

请求参数

参数	必选	类型	描述
deviceId	true	string	设备的 deviceId
apiKey	true	string	图灵平台上的 apikey
openId	true	string	微信公众号下的真实 openId

请求内容体形式

[
    {
        "deviceId": "vkkv00c000004374",
        "apiKey": "3c990a78c7f24bf***f0906173f09f30",
        "openId": "oZqE-0bP0aBEvHZBg6QeDsH8hm5s"
    }
]

返回结果示例

{
    "status": 200,
    "body": [
        {
            "openId": "oZqE-0bP0aBEvHZBg6QeDsH8hm5s",
            "apiKey": "3c990a78c7f24bf***f0906173f09f30",
            "deviceId": "vkkv00c000004374"
        }
    ]
}

绑定接口2

接口地址

https://iot-ai.turingapi.com/iot/bind_from_sinvoice
或 http://iot-ai.turingapi.com/iot/bind_from_sinvoice

请求方法

Method: POST
Content-Type: application/json

请求参数

参数	必选	类型	说明
openId	true	string	声波或二维码中包含该字段（openid处理后的值）
deviceId	true	string	设备id
apiKey	true	string	机器人的唯一身份ID，图灵AI开放平台获取

调用样例

{
    "openId":"TzSo7F",
    "apiKey":"3c990a78c7f24bf***f0906173f09f30",
    "deviceId":"vkkv00c000004894"
}

返回正确信息

返回结果中openId为真实的openid。

{
    "code": 0,
    "desc": "success",
    "meta": {
        "key": "SinvoiceDevice:TzSo7F",
        "deviceId": "vkkv00c000004894"
    },
    "openId": "oa4wQxFayI-O_s34Qti****cW5to"
}

返回错误信息

{
    "code": 41007,
    "desc": "openId错误或未绑定"
}