设备配网

更新时间：2024-06-20 07:22:03下载pdf

配网插件是一个免开发、主题可配置、支持多种配网模式的微信小程序插件，只需要通过简单参数的传入，即可实现在行业微信小程序中嵌入配网的功能，简单又方便。

配网方式

截止目前，配网插件能够支持单蓝牙、蓝牙双模（通信协议2.0以上）、Wi-Fi 慢闪热点配网、扫码配网（NB-IoT 短码、手机扫 Wi-Fi 设备）、无线 Zigbee 子设备配网、边缘网关配网。

配网简介：

在使用插件前，首先要在微信公众平台的“设置-第三方服务-插件管理”中添加插件。开发者可登录小程序管理后台，通过 appid：wxd2aa51ffacc3ff86 查找插件并添加。
设备配网

在微信小程序的 app.json 中增加插件相关设置（微信小程序插件使用文档）。

    plugins: {
      'tuya-ap-plugin': {
        version: '4.1.1', // 版本号
        provider: 'wxd2aa51ffacc3ff86' // 插件的 appid，无需修改
      },
    },

添加跳转至插件页面的 JavaScript 代码。

AP 配网：插件页面选择手动添加的AP配网后开始引导用户进行 4 个步骤完成配网。

wx.navigateTo({
	url: `plugin://tuya-ap-plugin/step1?ticket=${ticket}&clientId=${clientID}&gid=${asset_id}&toC=false`,
});

扫码配网：插件页面直接进行扫码配网

wx.navigateTo({
	url: `plugin://tuya-ap-plugin/virtual?ticket=${ticket}&clientId=${clientID}&gid=${asset_id}&toC=false`,
});

自动发现：插件页面直接进行蓝牙配网以及zigbee网关子设备配网

wx.navigateTo({
	url: `plugin://tuya-ap-plugin/auto?ticket=${ticket}&clientId=${clientID}&gid=${asset_id}&toC=false`,
});

路径参数：

参数名称	类型	是否必填	支持的配网方式	说明
ticket	String	是	AP 配网、扫码配网、自动发现	用户配网票据
gid	String	是	AP 配网、扫码配网、自动发现	资产 ID，设备需要绑定到某个资产中
uiMode	String	否	AP 配网、自动发现	主题色配置
wifiName	String	否	AP 配网	如果模组的 AP 配网模式下 Wi-Fi 名称有修改，这个需要传入修改后的值，默认是 SmartLife
wifiRecommed	String	否	AP 配网	如果有自定义配网指示图的需求话，可以将图片的 url 地址传入，不然就使用默认图片（图片的像素大小：宽-303px，高-228px ）
textArray	JSON.stringfy(Array)	否	AP 配网	配网说明文字，示例：[‘1. 断电 10 秒后，重新通电’，‘2. 找到重置按钮，并长按，直到指示灯开始慢闪’,'3. 查看 wifi 列表是否有 SmartLife 开头的 wifi ']

插件内置 13 个主题色，您可以通过 uiMode 参数切换主题色。默认值为 orange。

设备配网