根据自身产品情况,配合阿里云IoT提供的WiFi配网方案,并配置对应的引导文案。设置默认配网方案及备选方案。

背景信息

针对有屏可输入设备,如手机、平板等,用户可以直接通过界面输入SSIDPASSWORD让设备连上WiFi网络。对于无屏设备,如插座、灯泡等,用户无法通过输入上网信息让设备接入网络,此时则需要对这些设备进行配网操作。

配网也就是将路由器的WiFi的SSIDPASSWORD通过某种方式传递到终端设备,让终端设备可以接入WiFi网络的过程。

阿里提供的WiFi配网方案有:一键配网(又称smartConfig或广播配网)、手机热点配网、设备热点配网、蓝牙辅助配网、零配(需设备支持)、摄像头扫码配网(需设备支持)。

说明 平台针对国际站公版App,推荐使用官方标准配网流程(设备热点配网)。公版App的“手动添加”将不再支持自定义配网。国际站公版App仅支持通过扫码和本地发现的方式进行自定义配网。
  • 通过品类入口(如“灯”“插座”等)进入平台官方标准配网引导,如果您设备所属品类在列表中,推荐您使用官方标准配网流程(设备热点配网)。
  • 如需使用自定义配网流程或没有品类入口的产品,请使用扫码配网方式进入配网流程。
配网入口

一键配网

一键配网是手机通过广播发送上网热点信息(路由器的SSIDPASSWORD),设备通过监听方式获取信息,并连接上网热点的方式。该方案只需要用户输入WiFi的密码,单击开始配网即可完成配网操作。

一键配网

手机热点配网

手机启动一个预定义热点(例如:热点名为aha,密码为12345678),设备先连接到手机热点获取路由器上网热点信息,再连接上网热点的方式。该方案需要WiFi切换相关的权限,如果没有授予权限可能会导致配网失败,建议将该方案作为备选方案。

手机热点配网

设备热点配网

设备开启设备WiFi热点,手机搜索发现到热点后连接到该热点,手机将路由器上WiFi热点的SSID/密码发送给WiFi设备,然后WiFi设备使用该SSID/密码连接WiFi热点。

设备热点配网

零配

通过已连接上网热点的WiFi设备,将热点信息发送给待配网设备的方式。该方案不需要用户在手机端输入WiFi热点的SSID/密码,因此称为零配。

零配

摄像头扫码配网

针对拥有摄像头及二维码解码能力设备,可以通过App生成携带SSID、password等信息的二维码,摄像头根据App的二维码画面解码出信息,连接路由器,即完成配网绑定流程。开发者将SSID、password信息传入SDK后,SDK会将完整二维码信息回调并开启局域网监听,开发者需要展现二维码并监听配网结果。

二维码中携带的信息如下。

Key 描述 是否必选
v version,版本号,区分为阿里的二维码规则,当前为Ali_1。 必选
s ssid,家庭路由SSID 必选
p password,家庭路由密码 必选
b BSSID,家庭路由的BSSID信息,Hex String,解决gbk编码等问题 必选
t token,绑定需要的Token信息,3 Bytes random string 可选

二维码按JSON规则拼接,示例如下。

{"v":"Ali_1","s":"Router","p":"12345678","b":"EC26CAB68CC","t":"93DAB7"}

配置配网方案和引导文案

公版App中,配网引导为必填参数,自有App中可以根据实际情况配置。

  1. 进入人机交互页面。
  2. 单击配网引导对应的未设置
  3. 选择默认配网方案和备选配网方案。
    选择配网方案
  4. 单击默认配网方案对应的编辑引导页面
    配置引导图和相关提示文案。设置配网文案
  5. 单击备选配网方案对应的编辑引导页面
    按照相同方法,配置备选方案的引导图和相关提示文案。