目录

SensorAgent

Class Info

public class SensorAgent extends VirtualManager

该类为设备Sensor代理类,提供Sensor相关的接口。

sensor的能力的使用需要申请分布式sensor权限com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE以及对应的Android权限(例如:心率是android.permission.BODY_SENSORS权限)。

本能力需要DV Engine版本在1.0.1.300以上才支持。

Public Method Summary

Qualifier and Type

Method Name and Description

List

getSensorList(String deviceId, int sensorType)

获取设备类型为sensorType的所有sensor。

int

subscribeSensorDataListener(IVirtualSensorDataListener listener, VirtualSensor sensor)

注册Sensor监听。

int

subscribeSensorDataListener(IVirtualSensorDataListener listener, VirtualSensor sensor, int rate)

指定上报频率注册Sensor监听。

void

unSubscribeSensorDataListener(IVirtualSensorDataListener listener)

去注册Sensor监听。

Public Methods

[h2]getSensorList

Method

public List getSensorList(String deviceId, int sensorType)

获取设备类型为sensorType的所有sensor,如果该设备没有该类型的sensor,则返回的list的列表个数为0。

Parameters

Name

Description

deviceId

虚拟设备id,发现虚拟设备的id。

sensorType

Sensor的类型,参见VirtualSensor。

Return

Type

Description

List

虚拟sensor列表。

[h2]subscribeSensorDataListener

Method

public int subscribeSensorDataListener(IVirtualSensorDataListener listener, VirtualSensor sensor)

注册Sensor监听,使用本接口发起的订阅,上报周期固定为5秒。

  1. 此接口只支持订阅心率计数且上报周期固定为5秒。

  2. 推荐使用1.0.3.300上新增的可指定上报周期的订阅接口。

Parameters

Name

Description

listener

Sensor数据订阅的回调接口,获取发现到的虚拟设备Sensor的数据:

public interface IVirtualSensorDataListener {

void onSensorChanged(VirtualSensorData data);

}

onSensorChanged用于获取Sensor上报的数据。

sensor

获取的sensor对象。

Return

Type

Description

int

0表示调用成功,非0表示调用失败,详见ReturnCode说明。参见ReturnCode。

[h2]subscribeSensorDataListener

Method

public int subscribeSensorDataListener(IVirtualSensorDataListener listener, VirtualSensor sensor, int rate)

指定上报频率注册Sensor监听。

  1. 不同器件的数据采集能力不同,如果指定的上报频率超过虚拟设备的采集能力,则返回ReturnCode.ERROR_CODE_DEVICE_NOT_SUPPORT错误码。

  2. 本能力需要DV Engine版本在1.0.3.300及以上才支持。

Parameters

Name

Description

listener

Sensor数据订阅的回调接口,获取发现到的虚拟设备Sensor的数据:

public interface IVirtualSensorDataListener {

void onSensorChanged(VirtualSensorData data);

}

onSensorChanged用于获取Sensor上报的数据。

sensor

获取的sensor对象。

rate

Sensor数据的上报频率。

  1. SENSOR_DELAY_FAST:上报频率约为60毫秒
  2. SENSOR_DELAY_NORMAL:上报频率约为200毫秒
  3. SENSOR_DELAY_SLOW:上报频率约为5000毫秒

由于不同器件的数据采集精度存在差异,系统将采用合适的频率从设备采集数据,并按照指定的频率上报给应用。

Return

Type

Description

int

0表示调用成功,非0表示调用失败,详见ReturnCode说明。参见ReturnCode。

[h2]unSubscribeSensorDataListener

Method

public void unSubscribeSensorDataListener(IVirtualSensorDataListener listener)

去注册Sensor监听。

Parameters

Name

Description

listener

Sensor数据订阅的回调接口,获取发现到的虚拟设备Sensor的数据:

public interface IVirtualSensorDataListener {

void onSensorChanged(VirtualSensorData data);

}

onSensorChanged 订阅Sensor上报数据。