@ohos.stationary (Device Status Awareness Framework)
The stationary module provides APIs to report the device status, including absolute still and relative still.
NOTE
The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
This module does not support x86 emulators.
Modules to Import
import stationary from '@ohos.stationary'
ActivityResponse
Defines the response interface to receive the device status.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
Attributes
| Name | Type | Readable | Writable | Description |
|---|---|---|---|---|
| state | ActivityState | Yes | No | New device status. |
ActivityType
Enumerates the device status types.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
| Name | Description |
|---|---|
| still | Absolutely still. |
| relativeStill | Relatively still. |
ActivityEvent
Enumerates the device status events.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
| Name | Value | Description |
|---|---|---|
| ENTER | 1 | Event indicating entering device status. |
| EXIT | 2 | Event indicating exiting device status. |
| ENTER_EXIT | 3 | Event indicating entering and exiting device status. |
ActivityState
Enumerates the device statuses.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
| Name | Value | Description |
|---|---|---|
| ENTER | 1 | Entering device status. |
| EXIT | 2 | Exiting device status. |
stationary.on('still'|'relativeStill')
on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void
Subscribes to the device status.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| activity | ActivityType | Yes | Device status type. |
| event | ActivityEvent | Yes | Event type. |
| reportLatencyNs | number | Yes | Event reporting period. |
| callback | Callback<ActivityResponse> | Yes | Callback used to receive reported data. |
Example
let reportLatencyNs = 100;
stationary.on('still', stationary.ActivityEvent.ENTER, reportLatencyNs, (data) => {
console.log('data='+ JSON.stringify(data));
})
stationary.once('still'|'relativeStill')
once(activity: ActivityType, callback: Callback<ActivityResponse>): void
Obtains the device status.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| activity | ActivityType | Yes | Device status type. |
| callback | Callback<ActivityResponse> | Yes | Callback used to receive reported data. |
Example
stationary.once('still', (data) => {
console.log("data="+ JSON.stringify(data));
})
stationary.off('still'|'relativeStill')
off(activity: ActivityType, event: ActivityEvent, callback?: Callback<ActivityResponse>): void
Unsubscribes from the device status.
System capability: SystemCapability.Msdp.DeviceStatus.Stationary
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| activity | ActivityType | Yes | Device status type. |
| event | ActivityEvent | Yes | Event type. |
| callback | Callback: <ActivityResponse> | No | Callback used to receive reported data. If no value or undefined is passed, all callbacks associated with the specified event in the process will be unregistered. |
Example
stationary.off('still', stationary.ActivityEvent.ENTER);
你可能感兴趣的鸿蒙文章
harmony 鸿蒙System Common Events (To Be Deprecated Soon)
harmony 鸿蒙System Common Events
harmony 鸿蒙API Reference Document Description
harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)
harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)
harmony 鸿蒙@ohos.bundle (Bundle)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)