設(shè)備狀態(tài)感知框架

2024-01-23 17:47 更新

設(shè)備狀態(tài)感知框架提供設(shè)備狀態(tài)感知能力,包括絕對靜止和相對靜止。

說明

本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

本模塊不支持x86模擬器。

導(dǎo)入模塊

  1. import stationary from '@ohos.stationary'

ActivityResponse

服務(wù)響應(yīng)抽象接口。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

屬性

名稱

類型

可讀

可寫

說明

state

ActivityState

設(shè)備狀態(tài)變化返回值。

ActivityType

設(shè)備狀態(tài)類型。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

名稱

說明

still

絕對靜止。

relativeStill

相對靜止。

ActivityEvent

設(shè)備狀態(tài)事件。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

名稱

說明

ENTER

1

進(jìn)入。

EXIT

2

退出。

ENTER_EXIT

3

進(jìn)入和退出。

ActivityState

設(shè)備狀態(tài)返回值。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

名稱

說明

ENTER

1

進(jìn)入。

EXIT

2

退出。

stationary.on('still' | 'relativeStill')

on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void

設(shè)備狀態(tài)管理,訂閱設(shè)備狀態(tài)服務(wù)。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

參數(shù):

參數(shù)名

類型

必填

說明

activity

ActivityType

設(shè)備狀態(tài)能力類型。

event

ActivityEvent

事件類型。

reportLatencyNs

number

報(bào)告延時。

callback

Callback<ActivityResponse>

回調(diào)函數(shù),接收上報(bào)狀態(tài)變化事件。

示例:

  1. var reportLatencyNs = 100;
  2. stationary.on('still', stationary.ActivityEvent.ENTER, reportLatencyNs, (data) => {
  3. console.log('data='+ JSON.stringify(data));
  4. })

stationary.once('still' | 'relativeStill')

once(activity: ActivityType, callback: Callback<ActivityResponse>): void

設(shè)備狀態(tài)管理,查詢設(shè)備狀態(tài)。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

參數(shù):

參數(shù)名

類型

必填

說明

activity

ActivityType

設(shè)備狀態(tài)能力類型。

callback

Callback<ActivityResponse>

回調(diào)函數(shù),接收上報(bào)狀態(tài)變化事件。

示例:

  1. stationary.once('still', (data) => {
  2. console.log("data="+ JSON.stringify(data));
  3. })

stationary.off('still' | 'relativeStill')

off(activity: ActivityType, event: ActivityEvent, callback?: Callback<ActivityResponse>): void

設(shè)備狀態(tài)管理,取消訂閱設(shè)備狀態(tài)服務(wù)。

系統(tǒng)能力:SystemCapability.Msdp.DeviceStatus.Stationary

參數(shù):

參數(shù)名

類型

必填

說明

activity

ActivityType

設(shè)備狀態(tài)能力類型。

event

ActivityEvent

事件類型。

callback

Callback<ActivityResponse>

回調(diào)函數(shù),接收上報(bào)狀態(tài)變化事件,如果沒有傳遞callback參數(shù),會移除該進(jìn)程下訂閱該類型得所有callback。

示例:

  1. stationary.off('still', stationary.ActivityEvent.ENTER);
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號