鸿蒙开发系统基础能力:【@ohos.screenLock (锁屏管理)】

锁屏管理

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

说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

复制代码
import screenlock from '@ohos.screenLock';

screenlock.isScreenLocked

isScreenLocked(callback: AsyncCallback): void

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

系统能力: SystemCapability.MiscServices.ScreenLock

参数:

参数名 类型 必填 说明
callback AsyncCallback 是 回调函数,返回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

参数:

参数名 类型 必填 说明
callback AsyncCallback 是 回调函数。返回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

参数:

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

示例:

复制代码
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:此接口为系统接口,三方应用不支持调用。

参数:

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

示例:

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

screenlock.on9+

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

注册锁屏状态变化回调。

系统能力: SystemCapability.MiscServices.ScreenLock

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

参数:

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

示例:

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

screenlock.on9+

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

注册锁屏状态变化回调。

系统能力: SystemCapability.MiscServices.ScreenLock

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

参数:

参数名 类型 必填 说明
type string 是 设置事件类型。 - type为"screenlockEnabled",表示锁屏是否启用。
callback Callback 是 注册成功的回调。 回调结果用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:此接口为系统接口,三方应用不支持调用。

参数:

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

示例:

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

screenlock.sendScreenLockEvent9+

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

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

系统能力: SystemCapability.MiscServices.ScreenLock

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

参数:

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

示例:

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

screenlock.sendScreenLockEvent9+

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

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

系统能力: SystemCapability.MiscServices.ScreenLock

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

参数:

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

返回值:

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

示例:

复制代码
screenlock.sendScreenLockEvent('unlockScreenResult', 0).then((result) => {
    console.log('sending result:' + result);
});
相关推荐
码间留白8 小时前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农8 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程12 小时前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程12 小时前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去14 小时前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts
传奇开心果编程15 小时前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
二流小码农1 天前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
Sirius_Ji2 天前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos