鎖屏管理

鎖屏管理服務(wù)是OpenHarmony中系統(tǒng)服務(wù)，為鎖屏應(yīng)用提供注冊(cè)亮屏、滅屏、開啟屏幕、結(jié)束休眠、退出動(dòng)畫、請(qǐng)求解鎖結(jié)果監(jiān)聽，并提供回調(diào)結(jié)果給鎖屏應(yīng)用。鎖屏管理服務(wù)向三方應(yīng)用提供請(qǐng)求解鎖、查詢鎖屏狀態(tài)、查詢是否設(shè)置鎖屏密碼的能力。

說(shuō)明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import screenlock from '@ohos.screenLock';

screenlock.isScreenLocked

isScreenLocked(callback: AsyncCallback): void

判斷屏幕是否鎖屏，使用callback作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

參數(shù) ：

示例 ：

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作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

示例 ：

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

判斷設(shè)備是否處于安全模式下，使用callback作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

參數(shù) ：

示例 ：

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

判斷設(shè)備是否處于安全模式下，使用Promise作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

示例 ：

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作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

參數(shù) ：

示例 ：

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

screenlock.unlockScreen

unlockScreen(): Promise

解鎖屏幕，使用Promise作為異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

返回值 ：

示例 ：

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

注冊(cè)鎖屏狀態(tài)變化回調(diào)。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

示例 ：

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

screenlock.on9+

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

注冊(cè)鎖屏狀態(tài)變化回調(diào)。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

示例 ：

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

screenlock.on9+

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

注冊(cè)鎖屏狀態(tài)變化回調(diào)。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

示例 ：

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

取消注冊(cè)鎖屏狀態(tài)變化回調(diào)。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

示例 ：

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

screenlock.sendScreenLockEvent9+

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

應(yīng)用發(fā)送事件到鎖屏服務(wù)，異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

示例 ：

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

screenlock.sendScreenLockEvent9+

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

應(yīng)用發(fā)送事件到鎖屏服務(wù)，異步方法。

系統(tǒng)能力 : SystemCapability.MiscServices.ScreenLock

系統(tǒng)API ：此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

參數(shù) ：

返回值 ：

示例 ：

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

審核編輯 黃宇