HarmonyOS API：设备管理

版本：v3.1 Beta

@ohos.geoLocationManager (位置服务)

更新时间: 2023-02-17 09:19

位置服务提供GNSS定位、网络定位、地理编码、逆地理编码、国家码和地理围栏等基本功能。

说明

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

申请权限

应用在使用系统能力前，需要检查是否已经获取用户授权访问设备位置信息。如未获得授权，可以向用户申请需要的位置权限，申请方式请参考下文。

系统提供的定位权限有：

• ohos.permission.LOCATION
• ohos.permission.APPROXIMATELY_LOCATION
• ohos.permission.LOCATION_IN_BACKGROUND

访问设备的位置信息，必须申请权限，并且获得用户授权。

API9之前的版本，申请ohos.permission.LOCATION即可。

API9及之后的版本，需要申请ohos.permission.APPROXIMATELY_LOCATION或者同时申请ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION；无法单独申请ohos.permission.LOCATION。

如果应用在后台运行时也需要访问设备位置，除需要将应用声明为允许后台运行外，还必须申请ohos.permission.LOCATION_IN_BACKGROUND权限，这样应用在切入后台之后，系统可以继续上报位置信息。

开发者可以在应用配置文件中声明所需要的权限，具体可参考​​授权申请指导​​。

导入模块

import geoLocationManager from '@ohos.geoLocationManager';

LocationRequestPriority

位置请求中位置信息优先级设置。

系统能力：SystemCapability.Location.Location.Core

LocationRequestScenario

位置请求中定位场景设置。

系统能力：SystemCapability.Location.Location.Core

LocationRequest

位置信息请求类型。

系统能力：SystemCapability.Location.Location.Core

CurrentLocationRequest

当前位置信息请求类型。

系统能力：SystemCapability.Location.Location.Core

SatelliteStatusInfo

卫星状态信息。

系统能力：SystemCapability.Location.Location.Gnss

Location

位置信息类型。

系统能力：SystemCapability.Location.Location.Core

@ohos.power (系统电源管理)

更新时间: 2023-02-17 09:19

该模块主要提供重启、关机、查询屏幕状态等接口。

说明

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

导入模块

import power from '@ohos.power';

power.isActive⁹⁺

isActive(): boolean

检测当前设备是否处于活动状态。

系统能力： SystemCapability.PowerManager.PowerManager.Core

错误码：

以下错误码的详细介绍请参见​​系统电源管理错误码​​。

示例：

try {
    var isActive = power.isActive();
    console.info('power is active: ' + isActive);
} catch(err) {
    console.error('check active status failed, err: ' + err);
}

power.getPowerMode⁹⁺

getPowerMode(): DevicePowerMode

获取当前设备的电源模式。

系统能力： SystemCapability.PowerManager.PowerManager.Core

返回值：

错误码：

以下错误码的详细介绍请参见​​系统电源管理错误码​​。

示例：

try {
    var mode = power.getPowerMode();
    console.info('power mode: ' + mode);
} catch(err) {
    console.error('get power mode failed, err: ' + err);
}

power.rebootDevice

rebootDevice(reason: string): void

重启设备。

需要权限： ohos.permission.REBOOT

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

power.rebootDevice('reboot_test');

power.isScreenOn^(deprecated)

isScreenOn(callback: AsyncCallback<boolean>): void

说明

从API version 9开始不再维护，建议使用​​power.isActive​​替代。

检测当前设备的亮灭屏状态。使用callback异步回调。

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

power.isScreenOn((err, data) => {
    if (typeof err === 'undefined') {
        console.info('screen on status is ' + data);
    } else {
        console.error('check screen status failed, err: ' + err);
    }
})

power.isScreenOn^(deprecated)

isScreenOn(): Promise<boolean>

说明

从API version 9开始不再维护，建议使用​​power.isActive​​替代。

检测当前设备的亮灭屏状态。使用Promise异步回调。

系统能力： SystemCapability.PowerManager.PowerManager.Core

返回值：

示例：

power.isScreenOn()
.then(data => {
    console.info('screen on status is ' + data);
})
.catch(err => {
    console.error('check screen status failed, err: ' + err);
})

DevicePowerMode⁹⁺

表示电源模式的枚举值。

系统能力： SystemCapability.PowerManager.PowerManager.Core

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-power-0000001477981465-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001477981465__导入模块​​