更新记录

1.0.0(2023-01-10)

  • 实时监听锁屏、解锁、屏幕高亮、屏幕灰暗状态
  • 获取当前屏幕状态
  • 设置屏幕永远高亮,永不息屏

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:11 - 15

原生插件通用使用流程:

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


功能

  • 实时监听锁屏、解锁、屏幕高亮、屏幕灰暗状态
  • 获取当前屏幕状态
  • 设置屏幕永远高亮,永不息屏

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

如果觉得可以就点个👍吧,欢迎粉丝收藏,土豪打赏,您的关注就是我们创作的动力!

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android: <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" /> ios: 无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问