穿戴设备传感器获取

获取穿戴设备的传感器列表

该接口的调用需要在开发者联盟申请运动传感器权限或人体传感器（受限开放，请参考申请接入Wear Engine服务）权限并获得用户授权。

手机侧应用可以获取穿戴设备上传感器列表，并获得这些传感器的名称、ID、上报周期等参数。

1. 参见已连接穿戴设备查询章节，获取已连接设备列表。
2. 参见目标设备选择章节，从已连接设备列表中选定需要通信的设备。
3. 调用wearEngine中的getSensorClient方法，获取SensorClient对象。
4. 调用getSensorList方法，获取指定连接设备的传感器列表。

   // 步骤3 获取SensorClient客户端
   let sensorClient: wearEngine.SensorClient = wearEngine.getSensorClient(getContext(this));
   
   // 步骤4 获取指定连接设备的传感器列表
   sensorClient.getSensorList(targetDevice.randomId).then((sensorList) => {
     console.info(`Succeeded in getting sensor list, result is ${sensorList}`);
   }).catch((error: BusinessError) => {
     console.error(`Failed to get sensor list. Code is ${error.code}, message is ${error.message}`);
   })

订阅指定传感器数据上报

该接口的调用需要在开发者联盟申请运动传感器权限或人体传感器权限（受限开放，请参考申请接入Wear Engine服务）并获得用户授权。

手机侧通过getSensorList方法获取传感器列表后可以通过subscribeSensor方法订阅指定传感器数据上报。通过unsubscribeSensor方法可取消订阅指定传感器的数据上报。

1. 参见查询可用穿戴设备章节，获取已连接设备列表。
2. 参见目标设备选择章节，从已连接设备列表中选定需要通信的设备。
3. 参见上一小节获取穿戴设备的传感器列表，获取设备的传感器列表信息。
4. 核对传感器列表中是否存在目标传感器。
5. 订阅或取消订阅传感器数据上报。

   let sensorClient: wearEngine.SensorClient = wearEngine.getSensorClient(getContext(this));
   let sensorList: wearEngine.Sensor[] = await sensorClient.getSensorList(targetDevice.randomId);
   sensorList.forEach((sensor, idx, arr) => {
     if (sensor.type === wearEngine.SensorType.ACCELEROMETER) {
       let callback = (sensorResult: wearEngine.SensorResult) => {
         console.info(`Succeeded in getting sensor result, result is ${sensorResult}`);
       }
       // 订阅传感器数据上报
       sensorClient.subscribeSensor(targetDevice.randomId, wearEngine.SensorType.ACCELEROMETER, callback).then(() => {
         console.info(`Succeeded in subscribing sensor data.`);
       }).catch((error: BusinessError) => {
         console.error(`Failed to subscribe sensor data. Code is ${error.code}, message is ${error.message}`);
       })
   
       // 取消传感器数据上报
       sensorClient.unsubscribeSensor(targetDevice.randomId, wearEngine.SensorType.ACCELEROMETER, callback).then(() => {
         console.info(`Succeeded in unsubscribing sensor data.`);
       }).catch((error: BusinessError) => {
         console.error(`Failed to unsubscribe sensor data. Code is ${error.code}, message is ${error.message}`);
       })
     }
   })

   

   • 传感器成功打开后，会根据每个传感器的上报周期，连续不断的通过subscribeSensor方法入参的回调函数上报数据，数据上报时长可由开发者通过取消订阅传感器接口自行控制。每组数据都有时间戳属性，建议开发者根据时间戳进行数据对齐。不同的传感器上报的数据格式是不同的，具体可参见：穿戴设备传感器数据格式及样例。
   • 传感器分为多通道传感器，如PPG、ECG，和非多通道传感器，如ACC。对于多通道传感器上报的数据，可以通过SensorData中的channel字段来区分通道。
   • 设备连接状态断开，设备会停止传感器数据的上报，需要开发者主动订阅设备的连接状态，设备重新连接上后主动调用subscribeSensor方法订阅指定传感器数据上报。

穿戴设备传感器数据格式及样例

数据上报数量非固定，示例中给出的是通常上报结果，实际有可能根据设备原因增加或者减少数据。