Skip to content

wifi配网

说明:主要对 wifi 配网进行一些基础操作,例如搜索 wifi、连接 wifi 等。

注意事项

  • 配网时确保锁板亮屏
  • 确保连接的 wifi 是 2.4GHz 的 wifi

搜索wifi

搜索大约4秒返回结果

  • 调用方法
Dart
await StarCloudTool.cloudSDK.searchWiFi(
  lockId: widget.lock.lockId,
  onSuccess: (List<SearchWifiResult> result) {
    // TODO SUCCESS
  },
  onError: (err) {
    // TODO ERROR
  },
)
  • 参数说明
名称类型是否必需示例描述
lockIdintY500锁id
onSuccessTCallback<List<SearchWifiResult>>?N(result) {}搜索 wifi 成功回调
onErrorErrCallback?N(error) {}搜索 wifi 失败回调
  • 响应结构
Dart
class SearchWifiResult {
  String ssid; // wifi昵称
  int rssi; // 信号强度
}

连接wifi

  • 调用方法
Dart
await StarCloudTool.cloudSDK.connectWiFi(
  lockId: widget.lock.lockId,
  clientId: 'XXX',
  starLockPeerId: 'XXX',
  wifiName: 'TLINKTECH02',
  wifiPassword: 'ABCD2345678',
  onSuccess: () {
    // TODO SUCCESS
  },
  onError: (err) {
    // TODO ERROR
  },
)
  • 参数说明
名称类型是否必需示例描述
lockIdintY500锁id
wifiNameStringY"TLINKTECH02"wifi昵称
wifiPasswordStringY"ABCD2345678"wifi密码
clientIdStringY"XXX"创建应用时提供
starLockPeerIdStringY"XXX"创建应用时提供
onSuccessVoidCallback?N() {}连接 wifi 成功回调
onErrorErrCallback?N(error) {}连接 wifi 失败回调

物联网设备通信协议文档