harmony 鸿蒙@ohos.stationary (Device Status Awareness Framework)

  • 2022-12-22
  • 浏览 (666)

@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&lt;ActivityResponse&gt;): 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&lt;ActivityResponse&gt;): 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 鸿蒙APIs

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)

0  赞