鸿蒙开发系统基础能力：ohos.screenLock 锁屏管理

jf_46214456 2024-06-27 466

电子说

1.3w人已加入

描述

锁屏管理

锁屏管理服务是OpenHarmony中系统服务，为锁屏应用提供注册亮屏、灭屏、开启屏幕、结束休眠、退出动画、请求解锁结果监听，并提供回调结果给锁屏应用。锁屏管理服务向三方应用提供请求解锁、查询锁屏状态、查询是否设置锁屏密码的能力。

鸿蒙说明： 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

import screenlock from '@ohos.screenLock';

screenlock.isScreenLocked

isScreenLocked(callback: AsyncCallback): void

判断屏幕是否锁屏，使用callback作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

参数 ：

参数名类型必填说明
callbackAsyncCallback是回调函数，返回true表示屏幕已锁屏，返回false表示屏幕未锁屏。

示例 ：

screenlock.isScreenLocked((err, data)= >{      
   if (err) {
        console.error('isScreenLocked callback error - > ${JSON.stringify(err)}');
        return;    
   }
   console.info('isScreenLocked callback success data - > ${JSON.stringify(data)}');
});

screenlock.isScreenLocked

isScreenLocked(): Promise

判断屏幕是否锁屏，使用Promise作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

类型说明
Promise以Promise形式返回结果。

示例 ：

screenlock.isScreenLocked().then((data) = > {
    console.log('isScreenLocked success: data - > ${JSON.stringify(data)}');
}).catch((err) = > {
    console.error('isScreenLocked fail, promise: err - > ${JSON.stringify(err)}');
});

screenlock.isSecureMode

isSecureMode(callback: AsyncCallback): void

判断设备是否处于安全模式下，使用callback作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

参数 ：

参数名类型必填说明
callbackAsyncCallback是回调函数。返回true表示屏幕处于安全模式下，返回false表示屏幕当前不在安全模式下。

示例 ：

screenlock.isSecureMode((err, data)= >{      
   if (err) {
        console.error('isSecureMode callback error - > ${JSON.stringify(err)}');
        return;    
   }
   console.info('isSecureMode callback success data - > ${JSON.stringify(err)}');
});

screenlock.isSecureMode

isSecureMode(): Promise

判断设备是否处于安全模式下，使用Promise作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

类型说明
Promise以Promise形式返回结果。

示例 ：

screenlock.isSecureMode().then((data) = > {
    console.log('isSecureMode success: data- >${JSON.stringify(data)}');
}).catch((err) = > {
    console.error('isSecureMode fail, promise: err- >${JSON.stringify(err)}');
});

screenlock.unlockScreen

unlockScreen(callback: AsyncCallback): void

解锁屏幕，使用callback作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

参数 ：

参数名类型必填说明
callbackAsyncCallback是回调函数，失败时返回错误信息。

示例 ：

screenlock.unlockScreen((err) = > {      
   if (err) {
        console.error('unlockScreen callback error - > ${JSON.stringify(err)}');
        return;    
   }
   console.info('unlockScreen callback success');
});

screenlock.unlockScreen

unlockScreen(): Promise

解锁屏幕，使用Promise作为异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

类型说明
Promise以Promise形式返回结果。

示例 ：

screenlock.unlockScreen().then(() = > {
    console.log('unlockScreen success');
}).catch((err) = > {
    console.error('unlockScreen fail, promise: err- >${JSON.stringify(err)}');
});

screenlock.on9+

on(type: 'beginWakeUp' | 'endWakeUp' | 'beginScreenOn' | 'endScreenOn' | 'beginScreenOff' | 'endScreenOff' | 'unlockScreen' | 'beginExitAnimation', callback: Callback): void

注册锁屏状态变化回调。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
typestring是设置事件类型。 - type为"beginWakeUp"，表示事件开始时开始唤醒。 - type为"endWakeUp"，表示事件结束时结束唤醒。 - type为"beginScreenOn"，表示事件开始时开始亮屏。 - type为"endScreenOn"，表示事件结束时结束亮屏。 - type为"beginScreenOff"，表示事件开始时开始灭屏。 - type为"endScreenOff"，表示事件结束时结束灭屏。 - type为"unlockScreen"，表示请求解锁。 - type为"beginExitAnimation"，表示动画开始退场。
callbackCallback是事件回调方法。

示例 ：

screenlock.on('beginWakeUp', () = > {
    console.log('beginWakeUp triggered');
});

screenlock.on9+

on(type: 'beginSleep' | 'endSleep' | 'changeUser', callback: Callback): void

注册锁屏状态变化回调。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
typestring是设置事件类型。 - type为"beginSleep"，表示开始休眠。 - type为"endSleep"，表示结束休眠。 - type为"changeUser"，表示切换用户。
callbackCallback是事件回调方法。 返回事件相应的状态。

示例 ：

screenlock.on('beginSleep', (why) = > {
    console.log('beginSleep triggered:' + why);
});

screenlock.on9+

on(type: 'screenlockEnabled', callback: Callback): void

注册锁屏状态变化回调。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
typestring是设置事件类型。 - type为"screenlockEnabled"，表示锁屏是否启用。
callbackCallback是注册成功的回调。 回调结果用true/false表示。

示例 ：

screenlock.on('screenlockEnabled', (isEnabled) = > {
    console.log('screenlockEnabled triggered, result:' + isEnabled);
});

screenlock.off9+

off(type: 'beginWakeUp' | 'endWakeUp' | 'beginScreenOn' | 'endScreenOn' | 'beginScreenOff' | 'endScreenOff' | 'unlockScreen' | 'beginExitAnimation' | 'screenlockEnabled' | 'beginSleep' | 'endSleep' | 'changeUser', callback: Callback): void

取消注册锁屏状态变化回调。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
typestring是设置事件类型。 - type为"beginWakeUp"，表示事件开始时开始唤醒。 - type为"endWakeUp"，表示事件结束时结束唤醒。 - type为"beginScreenOn"，表示事件开始时开始亮屏。 - type为"endScreenOn"，表示事件结束时结束亮屏。 - type为"beginScreenOff"，表示事件开始时开始灭屏。 - type为"endScreenOff"，表示事件结束时结束灭屏。 - type为"unlockScreen"，表示请求解锁。 - type为"beginExitAnimation"，表示动画开始退场。 - type为"screenlockEnabled"，表示锁屏是否启用。 - type为"beginSleep"，表示开始休眠。 - type为"endSleep"，表示结束休眠。 - type为"changeUser"，表示切换用户。
callbackCallback是注册成功的回调。

示例 ：

screenlock.off('beginWakeUp', () = > {
    console.log("callback");
});

screenlock.sendScreenLockEvent9+

sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback): void

应用发送事件到锁屏服务，异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
eventString是事件类型，支持如下取值: - "unlockScreenResult"，表示解锁结果。 - "screenDrawDone"，表示屏幕绘制完成。
parameternumber是解锁状态。 - parameter为0，表示解锁成功。 - parameter为1，表示解锁失败。 - parameter为2，表示解锁取消。
callbackAsyncCallback是表示执行结果。

示例 ：

screenlock.sendScreenLockEvent('unlockScreenResult', 0, (err, result) = > {
    console.log('sending result:' + result);
});

screenlock.sendScreenLockEvent9+

sendScreenLockEvent(event: String, parameter: number): Promise

应用发送事件到锁屏服务，异步方法。

系统能力 : SystemCapability.MiscServices.ScreenLock

系统API ：此接口为系统接口，三方应用不支持调用。

参数 ：

参数名类型必填说明
eventString是事件类型，支持如下取值: - "unlockScreenResult"，表示解锁结果。 - "screenDrawDone"，表示屏幕绘制完成。
parameternumber是解锁状态。 - parameter为0，表示解锁成功。 - parameter为1，表示解锁失败。 - parameter为2，表示解锁取消。

返回值 ：

类型说明
Promise以Promise形式返回执行结果。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

鸿蒙

示例 ：

screenlock.sendScreenLockEvent('unlockScreenResult', 0).then((result) = > {
    console.log('sending result:' + result);
});

审核编辑 黄宇

打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分