更新记录

1.0（2024-12-09） 下载此版本

V1.0 初始版本

平台兼容性

插件集成说明

插件引入

将uts插件wif-service放入项目的uni_modules目录下，在界面中导入相应插件功能，如下：

// 导入要使用的插件  
    import {
        bindService,
        requestBrightnessAdj,
        requestVolumeAdj,
        //.....
    } from "../../uni_modules/wif-service";

初始化

在使用插件功能之前，需要先进行初始化，初始化成功后即可使用其他功能： 返回值 bind 为 true 即为初始化成功

onLoad() {
            bindService({
                result: (bind) => {
                    console.log("bindService response bind:" + bind)
                }
            });
}

功能说明

操作回调处理

插件操作的回调处理函数，用于根据返回的 resultCode 显示操作的成功或失败信息：

const SUCCESS = 1;
const FAIL = 0;
const ERROR = -1;

// 操作回调处理
handleResponse(res) {
    let resultCode = res.code;
    if (resultCode === SUCCESS) {
        this.showToast("操作成功");
    } else {
        this.showToast("操作失败：" + res.msg);
    }
}

插件功能接口

1. 重启设备

此接口实现网飞设备的重启。

btnResetDevice() {
    requestReboot({
        response: (json) => {
            //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
            this.handleResponse(JSON.parse(json))
        }
    })
},

返回结果：

{"code":1,"msg":"","type":"reboot"}

2. 显示和隐藏状态栏（霸屏）

此接口实现状态栏和导航栏的全局隐藏，适用于前台应用的霸屏显示。 isChecked 为 true 或 false

requestStatusBar({
    param: isChecked,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"status_bar"}

3. 打开和关闭热点

此接口实现设备热点的打开和关闭。 isChecked 为 true 或 false

requestHotspot({
    param: isChecked,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"hotspot"}

4. 打开和关闭WIFI

此接口实现设备WIFI的打开和关闭。 isChecked 为 true 或 false

requestWifi({
    param: isChecked,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"wifi"}

5. 设置音量

此接口实现设备音量的调节（范围：0-100）。

requestVolumeAdj({
    param: volumeLastValue,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"volume"}

6. 设置亮度

此接口实现设备亮度的调节，亮度请求参数值为百分比含义，例如参数为 6 时，指的是调节为最大亮度的 6%。

requestBrightnessAdj({
    param: lastValue,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"brightness"}

7. 恢复出厂设置

此接口实现设备的恢复出厂设置。

requestFactoryReset({
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"factory_reset"}

8. 设置热点

此接口实现热点名称和密码的配置。 参数 arg1 为热点的名称，arg2 为热点的密码

requestHotspotConfig({
    arg1: this.hot_ssid,
    arg2: this.hot_pwd,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"hotspot_config"}

9. 静默安装

此接口实现应用的静默安装。

requestInstall({
    param: "sdcard/weixin.apk",
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果（安装失败时会返回错误码 PackageManager）：

{"code":0,"msg":"errorCode: -3","type":"install"}

10. 静默卸载

此接口实现应用的静默卸载。

requestUninstall({
    param: "com.tencent.mm",
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"uninstall"}

11. 设备别名

此接口实现给设备设置别名，别名会在网飞管理平台显示。

注意：此接口调用存在网络请求。

requestDeviceAlias({
    param: "万达广场",
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"alias"}

12. 返回桌面

此接口实现网飞管理平台配置的默认应用返回桌面，持续 5 分钟。

requestBackToHome({
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"start_home"}

13. WIFI 设置

此接口实现 WIFI 连接和静态 IP 配置。

requestWifiConfig({
    arg1: this.wifi_ssid,
    arg2: this.wifi_pwd,
    arg3: this.wifi_ip,
    arg4: this.wifi_dns1,
    arg5: this.wifi_dns2,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":0,"msg":"Wifi connect fail: WWW","type":"wifi_config"}

14. 以太网设置

此接口实现以太网静态 IP 配置。

requestEthernetConfig({
    arg1: this.ethernet_ip,
    arg2: this.ethernet_netmask,
    arg3: this.ethernet_gateway,
    arg4: this.ethernet_dns1,
    arg5: this.ethernet_dns2,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"ethernet_config"}

15. 获取位置信息

此接口实现获取设备位置信息。位置信息数据源为百度位置接口，位置信息每次开机或断网重连时会从百度更新。

requestGetLocation({
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"data":{"address":"中国河南省郑州市中原区石佛镇王屋路","latitude":34.801424,"longitude":113.608487,"poi":"河南省大学科技园","time":"2021-12-15 15:21:00"},"msg":"","type":"location"}

16. 设置系统时间

此接口实现设置新的系统时间（时间不低于 2022-01-01）。

requestSysTime({
    param: this.sys_time,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"set_time"}

17. 自动获取时间

此接口实现控制自动获取时间开关。 isChecked 为 true 或 false

requestAutoTime({
    param: isChecked,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"auto_time"}

18. 风扇控制

此接口实现 R02 和 R10 主板的风扇打开和关闭控制。 isChecked 为 true 或 false

requestFan({
    param: isChecked,
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"fan_control"}

19. 重启 4G 模块

此接口实现 B 系列和 K 系列主板的 4G 模块重启功能。

注意：建议每天重启次数不超过 20 次，否则可能会影响 4G 模组的寿命。

requestReset4G({
    response: (json) => {
        //由于返回的json为json字符串 这里要使用 JSON.parse 转为JSON对象
        this.handleResponse(JSON.parse(json))
    }
})

返回结果：

{"code":1,"msg":"","type":"reboot_modem"}