智能配网smartconfig，集成乐鑫EspTouch V2协议智能配网插件

更新记录

0.0.4（2022-09-18）

1、新增连接指定WiFi接口； 2、新增获取WiFi列表接口；以上接口暂时只支持安卓，iOS下个版本支持！

0.0.3（2022-05-10）

修复iOS版本兼容性问题

0.0.2（2022-04-15）

本插件支持功能： 1、获取当前连接WiFi信息； 2、开始配网； 3、取消配网；以上功能支持安卓和苹果两端，具体使用请查看说明文档！

平台兼容性

Android	Android CPU类型	iOS
适用版本区间：5.0 - 11.0	armeabi-v7a：未测试，arm64-v8a：未测试，x86：未测试	适用版本区间：9 - 15

原生插件通用使用流程：

购买插件，选择该插件绑定的项目。
在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

Gl-Esp2插件说明

本配网插件集成 ESPTouch V2配网协议，对于支持Esptouch V2配网协议的芯片可以尝试使用，比esptouch配网协议效果要好些，欢迎下载测试！本插件会根据反馈持续更新，目前核心接口都支持Android & IOS，如有问题请反馈，感谢！另外也接受各种插件定制，欢迎咨询！

插件使用方式：

const glEsp2 = uni.requireNativePlugin('Gl-Esp2');

接口列表：

接口名称	功能描述	安卓android支持	苹果iOS支持
getWiFiInfo	获取当前连接wifi信息	支持	支持
startConfig	开始配网	支持	支持
cancel	取消配网	支持	支持
connectWifi	连接指定WiFi	支持	暂不支持
getWiFiList	获取WiFi列表	支持	不支持

提示：苹果IOS需要勾选“Access WiFi Information”和申请广播权限“Multicast Networking” ！

接口使用例子：

1、获取当前连接wifi信息：

glEsp2.getWiFiInfo(result => {
    console.log(result);
});

传入参数说明：

无

返回参数说明：

code：1为配网成功；其他为失败

ssid：当前连接wifi名称

result：返回结果描述

bssid: BSSID,

is5G:是否5G WiFi，true 或 false

返回报文样例：

{
    "ssid": "TP-LINK_932D",
    "code": 1,
    "bssid": "48:0e:ec:85:93:2d",
    "result": "success",
    "is5G":false
}

注：苹果获取WiFi名称需要勾选：Access WiFi Information

2、开始配网：

glEsp2.startConfig({
    ssid: this.ssid,//wifi账号
    password: this.password,//wifi密码
    bssid: this.bssid,//bssid
    deviceCount: 1,//配网设备数量，默认为1
    aesKey: '',//AES密钥
    customData:'' //自定义数据
},
    result => {
    console.log(result);
});

传入参数说明：

ssid： wifi账号==必录

password：wifi密码，允许密码为空

bssid：BSSID==必录

deviceCount: 配网设备数量，默认为1

aesKey: AES密钥，限制16位长度

customData：自定义数据，不能超过64位长度

返回参数说明：

code：1为配网成功；其他为失败

result：返回结果，如果code=1（成功）result为数组，如果code不等于1则失败说明

PS：code=1（成功）时result为数组，包含以下字段：

address: 返回设备内网IP地址
bssid：返回设备bssid（mac地址）

返回报文样例：

{
    "code": 1,
    "result": [{"bssid":"fcf5c48a99a3","address":"192.168.0.116"}]
}

3、取消配网

glEsp2.cancel(result => {
    console.log(result);
});

传入参数说明：

无

返回参数说明：

code：1为取消成功；其他为失败

result：返回结果描述

返回报文样例：

{
    "code": 1,
    "result": "cancel success"
}

4、连接指定WiFi

glEsp2.connectWifi({ssid: this.ssid,pwd: this.password},result => {
    console.log(result);
});

传入参数说明：

ssid：需要连接的wifi账号==必录

pwd：需要连接的wifi密码，可为空

返回参数说明：

code：1为操作成功；其他为失败

result：返回结果描述

返回报文样例：

{
    "code": 1,
    "result": "连接成功"
}

注：苹果连接指定WiFi需要勾选：Hotspot

5、获取WiFi列表

glEsp2.getWiFiList(result => {
    console.log(result);
});

传入参数说明：

无

返回参数说明：

code：1为操作成功；其他为失败

result：返回结果描述

list：WiFi列表，字段说明：

ssid：WiFi账号； level：WiFi强度； bssid：BSSID； is5G：是否5G WiFi，true为是，false为否

返回报文样例：

{
    "code": 1,
    "result": "success"
    "lise":[
        {"ssid":xxx,"level":xxx,"bssid":xxx,"is5G":true},
        {"ssid":xxx,"level":xxx,"bssid":xxx,"is5G":false}
    ]
}

常见问题：

1、安卓获取不到wifi名称

这个多半是权限问题，请参照示例项目去调试；

2、运行测试请使用自定义基座方式

注：如果打自定义基座测试提示：当前运行的基座不包含原生插件[Gl-Esp2]... 请重新打包，尽可能使用最新版本HBuilderX重试打包！如果实在不行可以联系本人获取包含插件的自定义基座。

3、试用购买有什么问题都可以联系作者，会尽最大努力协助解决问题。