/* * Copyright (c) 2021-2023 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, BusinessError } from './@ohos.base'; /** * Provides interfaces to manage power. * * @namespace power * @syscap SystemCapability.PowerManager.PowerManager.Core * @since 7 */ declare namespace power { /** * Shuts down the system. *
This method requires the ohos.permission.REBOOT permission. * * @permission ohos.permission.REBOOT * @param { string } reason Indicates the shutdown reason. * @throws { BusinessError } 201 - If the permission is denied. * @throws { BusinessError } 202 - If the system permission is denied. * @throws { BusinessError } 401 - If the reason is not valid. * @throws { BusinessError } 4900101 - If connecting to the service failed. * @syscap SystemCapability.PowerManager.PowerManager.Core * @systemapi * @since 7 */ function shutdown(reason: string): void; /** * Restarts the system. *
This method requires the ohos.permission.REBOOT permission. * * @permission ohos.permission.REBOOT * @param { string } reason Indicates the restart reason. For example, "updater" indicates entering the updater mode * after the restart. If the parameter is not specified, the system enters the normal mode after the restart. * @syscap SystemCapability.PowerManager.PowerManager.Core * @since 7 * @deprecated since 9 * @useinstead power#reboot */ function rebootDevice(reason: string): void; /** * Restarts the system. *
This method requires the ohos.permission.REBOOT permission.
*
* @permission ohos.permission.REBOOT
* @param { string } reason Indicates the restart reason. For example, "updater" indicates entering the updater mode
* after the restart. If the parameter is not specified, the system enters the normal mode after the restart.
* @throws { BusinessError } 201 - If the permission is denied.
* @throws { BusinessError } 202 - If the system permission is denied.
* @throws { BusinessError } 401 - If the reason is not valid.
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @systemapi
* @since 9
*/
function reboot(reason: string): void;
/**
* Checks whether the screen of a device is on or off.
*
* @param { AsyncCallback
* The screen will be on if device is active, screen will be off otherwise.
*
* @returns { boolean } Returns true if the device is active; returns false otherwise.
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @since 9
*/
function isActive(): boolean;
/**
* Wakes up the device to turn on the screen.
*
* @param { string } detail Indicates the detail information who request wakeup.
* @throws { BusinessError } 202 - If the system permission is denied.
* @throws { BusinessError } 401 - If the detail is not valid.
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @systemapi
* @since 9
*/
function wakeup(detail: string): void;
/**
* Suspends the device to turn off the screen.
*
* @throws { BusinessError } 202 - If the system permission is denied.
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @systemapi
* @since 9
*/
/**
* Suspends the device to turn off the screen.
*
* @param { boolean } isImmediate Indicates whether suspend the device immediately.
* @throws { BusinessError } 202 - If the system permission is denied.
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @systemapi
* @since 10
*/
function suspend(isImmediate?: boolean): void;
/**
* Obtains the power mode of the current device. For details, see {@link DevicePowerMode}.
*
* @returns { DevicePowerMode } The power mode {@link DevicePowerMode} of current device .
* @throws { BusinessError } 4900101 - If connecting to the service failed.
* @syscap SystemCapability.PowerManager.PowerManager.Core
* @since 9
*/
function getPowerMode(): DevicePowerMode;
/**
* Obtains the power mode of the current device. For details, see {@link DevicePowerMode}.
*
* @permission ohos.permission.POWER_OPTIMIZATION
* @param { DevicePowerMode } mode Indicates power mode {@link DevicePowerMode} to set.
* @param { AsyncCallback