mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2024-11-27 09:22:53 +00:00
281 lines
10 KiB
TypeScript
281 lines
10 KiB
TypeScript
/*
|
|
* Copyright (c) 2022 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @kit BasicServicesKit
|
|
*/
|
|
|
|
import { AsyncCallback } from './@ohos.base';
|
|
import { Callback } from './@ohos.base';
|
|
|
|
/**
|
|
* systemScreenLock
|
|
*
|
|
* @namespace screenLock
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
*/
|
|
declare namespace screenLock {
|
|
/**
|
|
* Checks whether the screen is currently locked.
|
|
*
|
|
* @param { AsyncCallback<boolean> } callback - the callback of isScreenLocked.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function isScreenLocked(callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Checks whether the screen is currently locked.
|
|
*
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function isScreenLocked(): Promise<boolean>;
|
|
|
|
/**
|
|
* Checks whether the screen is currently locked.
|
|
*
|
|
* @returns { boolean } returns true if the screen is currently locked, returns false otherwise.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function isLocked(): boolean;
|
|
|
|
/**
|
|
* Checks whether the screen lock of the current device is secure.
|
|
*
|
|
* @param { AsyncCallback<boolean> } callback - the callback of isSecureMode.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function isSecureMode(callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Checks whether the screen lock of the current device is secure.
|
|
*
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function isSecureMode(): Promise<boolean>;
|
|
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @param { AsyncCallback<void> } callback - the callback of unlockScreen.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function unlockScreen(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @since 7
|
|
* @deprecated since 9
|
|
*/
|
|
function unlockScreen(): Promise<void>;
|
|
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @param { AsyncCallback<boolean> } callback - the callback of unlock.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @param { AsyncCallback<boolean> } callback - the callback of unlock.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @throws { BusinessError } 13200003 - illegal use.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 11
|
|
*/
|
|
function unlock(callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
/**
|
|
* Unlock the screen.
|
|
*
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @throws { BusinessError } 13200003 - illegal use.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 11
|
|
*/
|
|
function unlock(): Promise<boolean>;
|
|
|
|
/**
|
|
* Lock the screen.
|
|
*
|
|
* @permission ohos.permission.ACCESS_SCREEN_LOCK_INNER
|
|
* @param { AsyncCallback<boolean> } callback - the callback of lock.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 201 - permission denied.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function lock(callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Lock the screen.
|
|
*
|
|
* @permission ohos.permission.ACCESS_SCREEN_LOCK_INNER
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 201 - permission denied.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function lock(): Promise<boolean>;
|
|
|
|
/**
|
|
* Indicates the system event type related to the screenlock management service.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
type EventType =
|
|
'beginWakeUp'
|
|
| 'endWakeUp'
|
|
| 'beginScreenOn'
|
|
| 'endScreenOn'
|
|
| 'beginScreenOff'
|
|
| 'endScreenOff'
|
|
| 'unlockScreen'
|
|
| 'lockScreen'
|
|
| 'beginExitAnimation'
|
|
| 'beginSleep'
|
|
| 'endSleep'
|
|
| 'changeUser'
|
|
| 'screenlockEnabled'
|
|
| 'serviceRestart';
|
|
|
|
/**
|
|
* Indicates the system event type and parameter related to the screenlock management service.
|
|
*
|
|
* @typedef SystemEvent
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
interface SystemEvent {
|
|
/**
|
|
* Indicates the system event type related to the screenlock management service.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
eventType: EventType;
|
|
/**
|
|
* Identifies the customized extended parameter of an event.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
params: string;
|
|
}
|
|
|
|
/**
|
|
* Register system event related to screen lock service.
|
|
*
|
|
* @permission ohos.permission.ACCESS_SCREEN_LOCK_INNER
|
|
* @param { Callback<SystemEvent> } callback - the callback of onSystemEvent.
|
|
* @returns { boolean } returns true if register system event is success, returns false otherwise.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 201 - permission denied.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function onSystemEvent(callback: Callback<SystemEvent>): boolean;
|
|
|
|
/**
|
|
* The screen lock app sends the event to the screen lock service.
|
|
*
|
|
* @permission ohos.permission.ACCESS_SCREEN_LOCK_INNER
|
|
* @param { String } event - event type.
|
|
* @param { number } parameter - operation result of the event.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of sendScreenLockEvent.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 201 - permission denied.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* The screen lock app sends the event to the screen lock service.
|
|
*
|
|
* @permission ohos.permission.ACCESS_SCREEN_LOCK_INNER
|
|
* @param { String } event - event type.
|
|
* @param { number } parameter - operation result of the event.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error.
|
|
* @throws { BusinessError } 201 - permission denied.
|
|
* @throws { BusinessError } 202 - permission verification failed, application which is not a system application uses system API.
|
|
* @throws { BusinessError } 13200002 - the screenlock management service is abnormal.
|
|
* @syscap SystemCapability.MiscServices.ScreenLock
|
|
* @systemapi Hide this for inner system use.
|
|
* @since 9
|
|
*/
|
|
function sendScreenLockEvent(event: String, parameter: number): Promise<boolean>;
|
|
}
|
|
|
|
export default screenLock; |