更新记录
1.0.0(2023-01-10)
- 实时监听锁屏、解锁、屏幕高亮、屏幕灰暗状态
- 获取当前屏幕状态
- 设置屏幕永远高亮,永不息屏
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 12.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
功能
- 实时监听锁屏、解锁、屏幕高亮、屏幕灰暗状态
- 获取当前屏幕状态
- 设置屏幕永远高亮,永不息屏
API方法
var lockscreen = uni.requireNativePlugin("wrs-lockscreen");
- 实时监听锁屏、解锁、屏幕高亮、屏幕灰暗状态
lockscreen.addListener((resp) => {
this.showMsg(JSON.stringify(resp));
var opt = resp.opt;
switch (uni.getSystemInfoSync().platform) {
case 'android':
switch (opt) {
case "ACTION_SCREEN_ON":
this.showMsg("亮屏")
break;
case "ACTION_SCREEN_OFF":
this.showMsg("熄屏")
break;
case "ACTION_USER_PRESENT":
this.showMsg("解锁")
break;
}
break;
case "ios":
switch (opt) {
case "BecomeUnavailable":
this.showMsg("熄屏")
break;
case "BecomeAvailable":
this.showMsg("解锁")
break;
}
break;
default:
break;
}
});
- 取消监听
lockscreen.removeListener();
- 获取当前屏幕状态
lockscreen.getScreenState((resp) => {
switch (uni.getSystemInfoSync().platform) {
case 'android':
var isScreenOn = resp.isScreenOn;
var inKeyguardRestrictedInputMode = resp.inKeyguardRestrictedInputMode;
if (isScreenOn) {
this.showMsg("屏幕高亮状态");
} else {
this.showMsg("屏幕熄灭状态");
}
if (inKeyguardRestrictedInputMode) { // 为true,表示有两种状态:a、屏幕是黑的 b、目前正处于解锁状态 。
this.showMsg("屏幕是黑的或处于解锁状态");
} else { // false,表示目前未锁屏
this.showMsg("未锁屏状态");
}
break;
case 'ios':
/// 0:表示锁屏界面高亮 1:表示锁屏界面变暗关闭
var screenLight = resp.screenLight;
// 1:锁屏状态 其它:解锁状态
var locked = resp.locked;
var str = ""
if (screenLight == 0) {
this.showMsg("屏幕高亮");
} else {
this.showMsg("屏幕变暗");
}
if (locked == 1) {
this.showMsg("锁屏状态");
} else {
this.showMsg("未锁屏状态");
}
this.showMsg(str);
break;
default:
break;
}
});
- 设置屏幕永远高亮,永不息屏
lockscreen.screenOnForever({
enable: true // true为永不息屏 false为恢复默认状态
});
支持定制,联系方式 QQ:252797991