更新记录

1.0.1（2026-09-02）

1. EspTouch、EspTouch V2配网

1.0.0（2026-08-31）

1. smart只能配网

平台兼容性

uni-app(3.8.3)

uni-app x(3.8.4)

其他

智能配网smartconfig, wifi udp配网, 支持EspTouch、EspTouch V2

集成步骤

1. 拷贝demo里的Info.plist、AndroidManifest.xml、nativeResources文件夹到项目根目录下
2. iOS打包的provisioining profile文件需要开通组播/广播权限，参考https://www.cnblogs.com/wenrisheng/p/22801964，单播可以不用
3. 插件咨询或定制请点击上面"进入交流群"私聊作者
4. 通用UTS插件集成步骤可以参考https://www.cnblogs.com/wenrisheng/p/18323027

接口

    import {
    UTSEsptouch
} from "@/uni_modules/wrs-uts-esptouch"

• 获取当前连接Wi-Fi名称

let wifiName = UTSEsptouch.getSSID()

• 获取BSSID

let bssid = UTSEsptouch.getBSSID()

• 设置回调

UTSEsptouch.onSetCallback((resp) => {
    let opt = resp.opt
    switch (opt) {
        // esp touch 回调
        case "onEsptouchResultAdded":
            {
                let model = resp.model
                this.showMsg("onEsptouchResultAdded: " + JSON.stringify(model))
            }
            break;

        //下面是 esp touch V2 回调
        case "onSyncStart": {

        }
        break;
        case "onSyncStop": {

        }
        break;
        case "onSyncError": {

        }
        break;
        case "onProvisioningStart": {

        }
        break;
        case "onProvisioningStop": {
            UTSEsptouch.stopProvisioning()
        }
        break;
        case "onProvisoningScanResult": {
            let result = resp.result
            this.showMsg("onProvisoningScanResult:" + JSON.stringify(result))
            this.deviceArray.push(result)
            if (this.deviceArray.length >= parseInt(this.deviceCount)) {
                UTSEsptouch.stopProvisioning()
            }
        }
        break;
        case "onProvisioningError": {
            UTSEsptouch.stopProvisioning()
        }
        break;
        default:
            break;
    }
})

• EspTouch配网 配网结果在UTSEsptouch.onSetCallback的onProvisoningScanResult回调里

let params = {}
params.apSsid = this.apSsid // Wi-Fi名称，请确保当前链接的Wi-Fi是2.4G
params.apBssid = this.apBssid  // bssid
params.apPwd = this.apPwd // wifi密码
params.deviceCount = parseInt(this.deviceCount) // 设备数量
// params.timeoutMillisecond = 5000
UTSEsptouch.startRequest(params, (resp) => {
    this.showMsg("UTSEsptouch.startRequest resp:" + JSON.stringify(resp))
    let data = resp.data
    if (data) {
        for (let i = 0; i < data.length; i++) {

        }
    }
})

• EspTouch停止配网

UTSEsptouch.interrupt()

• EspTouch V2开始配网

配网结果在UTSEsptouch.onSetCallback的onEsptouchResultAdded回调里

let params = {}
params.apSsid = this.apSsid // Wi-Fi名称
params.apBssid = this.apBssid // bssid
params.apPwd = this.apPwd // wifi密码
params.deviceCount = parseInt(this.deviceCount) // 设备数量
params.aesKey = this.aesKey // aesKey，可选参数
params.reservedData = this.reservedData // 自定义参数，可选参数
UTSEsptouch.startProvisioning(params)

• EspTouch V2停止配网

UTSEsptouch.stopProvisioning()

• EspTouch V2是否在同步中

let isSynching = UTSEsptouch.isSyncing()

• EspTouch V2停止同步

let isSynching = UTSEsptouch.stopSync()