更新记录

0.0.8（2022-12-28）

紧急修复iOS由于版本问题引入的bug

0.0.7（2022-12-16）

1、修复乐鑫芯片配网问题。

0.0.5（2022-09-18）

1、新增获取WiFi列表接口（只支持安卓）

平台兼容性

原生插件通用使用流程：

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

付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择

airkiss-wifi插件说明

本配网插件集成 AirKiss 配网协议和连接指定WiFi方法，AirKiss协议支持设备较多，对于非乐鑫的芯片也能支持。本插件会根据反馈持续更新，欢迎下载使用！目前核心接口都支持Android & IOS！另外如果有定制需求也可以找我。

插件使用方式：

const airkiss = uni.requireNativePlugin('airkiss-wifi');

接口列表：

接口使用例子：

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

airkiss.getWifiInfo(result => {
    console.log(result);
});

传入参数说明：

无

返回参数说明：

code：1为获取成功；其他为失败，详细看返回字段描述

ssid：当前连接wifi名称

result：返回结果描述

返回报文样例：

{
    "ssid": "TP-LINK_932D",
    "code": 1,
    "result": "success"
}

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

注：苹果需要申请开通并勾选：Multicast Networking，申请请参考：https://www.jianshu.com/p/a818ffa11cab 苹果需要打开本地网络权限：设置-》隐私-》本地网络-》打开测试APP的这个权限

2、开始配网：

airkiss.startConfig({
    ssid: this.ssid,//wifi账号
    pwd: this.password,//wifi密码
    timeOut: this.timeOut//配网超时时间，默认为60秒，单位是秒
},
    result => {
    console.log(result);
});

传入参数说明：

ssid： wifi账号==必录，支持中文名称

pwd：wifi密码，可为空

timeOut：配网超时时间，默认为60秒，单位是秒

返回参数说明：

code：1为配网成功；其他为失败，详细看返回字段描述

ip: 返回设备内网IP地址

bssid：返回设备bssid（mac地址）

result：返回结果描述

返回报文样例：

{
    "ip": "192.168.0.116",
    "code": 1,
    "bssid": "fcf5c48a99a3",
    "result": "success"
}

3、取消配网

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

传入参数说明：

无

返回参数说明：

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

result：返回结果描述

返回报文样例：

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

4、连接指定WiFi

airkiss.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列表

airkiss.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、运行测试请使用自定义基座方式

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

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