平台兼容性

原生插件通用使用流程：

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

HKing-SmartConfig插件说明

Smart Config（智能配置）技术采用的是ESP-TOUCH 协议来帮助用户将嵌入了 ESP8266EX 的设备连接至 Wi-Fi 网络。 用户只需在手机上进行简单操作即可实现智能配置。

插件基于乐鑫的 ESP-TOUCH 原生SDK 插件封装方式打包。

本插件目前持续开发中，暂只开发到Android版本阶段，IOS版近期发布。

最近更新时间 2019.05.15

功能列表

已完成部分

• 获取当前连接wifi的ssid
• 获取当前连接wifi的bssid
• 开始智能配网
• 停止配网

待完善部分

• 以tcp或udp方式执行配网

引用方式

const hkSC = uni.requireNativePlugin('HKing-SmartConfig'); 

API 列表

获取手机当前所连接wifi的ssid

hkSC.getWifiSsid(callback)

参数

无

返回

当前手机所连接的ssid，如未连接则返回""

示例

var apSsid = "";
hkSC.getWifiSsid(result=>{
    if(result.apSsid==""){
        console.log("当前手机未连接wifi");
        return;
    }
    apSsid = result.apSsid;
    console.log("apSsid："+apSsid);
});

获取手机当前所连接wifi的bssid

hkSC.getWifiBssid(callback)

参数

无

返回

当前手机所连接wifi的Bssid

示例

var apBssid = "";
hkSC.getWifiBssid(result=>{
    if(result.apBssid==""){
        console.log("Bssid获取失败");
        return;
    }
    apBssid = result.apBssid;
    console.log("apBssid："+apBssid);
});

开始执行智能配网

hkSC.startSmaerConfig(apSsid,apPwd,callback)

方法需手机连接wifi，否则执行失败，可使用getWifiSsid方法判断

参数

返回

方法无返回 回调函数则传入json对象参数,格式如下：

{
    "code":0,//状态码
    "message"://注意，这里是一个string
    "{
        "macAddress":"840d8eb12173",//智能wifi设备的mac地址
        "IPAddress":"192.168.3.52"//智能wifi设备所在局域网的IP地址
    }"
}

示例

const hkSC = uni.requireNativePlugin('HKing-SmartConfig'); 
apSsid = "abcdefg";
apPwd = "12345678";//如果密码为空则传入空字符串
uni.showLoading({
    title: '配网中请稍后..'
});
hkSC.startSmaerConfig(apSsid,apPwd,result=>{
    uni.hideLoading();
    uni.showModal({
        title: '提示',
        content: '配网成功!'+msg,
        showCancel: false 
    });
});

停止配网

hkSC.stopSmartConfig()

参数

无

返回

无

示例

hkSC.stopSmartConfig();