更新记录

0.0.7（2022-12-16）

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

0.0.5（2021-11-03）

1、修复iOS14.5之后广播需要权限问题；请参考申请权限：https://www.jianshu.com/p/a818ffa11cab，申请有结果之后勾选：Multicast Networking，然后重新生成provisioning profile打包。提示：如果还未申请权限，请勿更新！

0.0.4（2021-05-25）

1、调整获取WiFi名称逻辑，自动弹出获取位置权限； 2、细化接口返回结果，可根据不同参数做自定义提示； 3、新增打开APP设置页面接口； 4、安卓新增打开“位置信息”页面接口。

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

Gl_Airkiss插件说明

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

插件使用方式：

const airkiss = uni.requireNativePlugin('Gl-Airkiss');

接口列表：

接口使用例子：

1、获取当前连接wifi名称：

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

传入参数说明：

无

返回参数说明：

code：1为获取成功；其他为失败，详细查看编码列表

ssid：当前连接wifi名称

result：返回结果描述

返回报文样例：

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

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

2、开始配网：

airkiss.startConfig({
    ssid: this.ssid,//wifi账号
    pwd: this.password//wifi密码
},
    result => {
    console.log(result);
});

传入参数说明：

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

pwd：wifi密码==必录

返回参数说明：

code：1为配网成功；其他为失败，详细查看编码列表

ip: 返回设备内网IP地址

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

result：返回结果描述

返回报文样例：

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

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

3、取消配网

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

传入参数说明：

无

返回参数说明：

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

result：返回结果描述

返回报文样例：

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

4、打开APP权限设置页面

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

传入参数说明：

无

返回参数说明：

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

result：返回结果描述

返回报文样例：

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

5、打开位置信息设置页面

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

传入参数说明：

无

返回参数说明：

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

result：返回结果描述

返回报文样例：

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

附录：编码列表

常见问题：

1、安卓获取不到wifi名称

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

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

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

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