传感器

说明: 从API Version 7 开始支持。

导入模块

import sensor from '@ohos.sensor';

权限列表

计步器:ohos.permission.ACTIVITY_MOTION

心率:ohos.permission.READ_HEALTH_DATA

加速度:ohos.permission.ACCELEROMETER

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: AsyncCallback<AccelerometerResponse>,options?: Options): void

监听加速度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。

callback

AsyncCallback<AccelerometerResponse>

注册加速度传感器的回调函数,上报的数据类型为AccelerometerResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);    
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  },
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:AsyncCallback<LinearAccelerometerResponse>, options?: Options): void

监听线性加速度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。

callback

AsyncCallback<LinearAccelerometerResponse>

注册线性加速度传感器的回调函数,上报的数据类型为LinearAccelerometerResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback:AsyncCallback<AccelerometerUncalibratedResponse>, options?: Options): void

监听未校准加速度计传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数

参数名

类型

必填

说明

type

SensorType

要订阅的未校准加速度计传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。

callback

AsyncCallback<AccelerometerUncalibratedResponse>

注册未校准加速度计传感器的回调函数,上报的数据类型为AccelerometerUncalibratedResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    //打印data在x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: AsyncCallback<GravityResponse>,options?: Options): void

监听重力传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的重力传感器类型为SENSOR_TYPE_ID_GRAVITY。

callback

AsyncCallback<GravityResponse>

注册重力传感器的回调函数,上报的数据类型为GravityResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x); 
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: AsyncCallback<GyroscopeResponse>, options?: Options): void

监听陀螺仪传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。

callback

AsyncCallback<GyroscopeResponse>

注册陀螺仪传感器的回调函数,上报的数据类型为GyroscopeResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x); 
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:AsyncCallback<GyroscopeUncalibratedResponse>, options?: Options): void

监听未校准陀螺仪传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。

callback

AsyncCallback<GyroscopeUncalibratedResponse>

注册未校准陀螺仪传感器的回调函数,上报的数据类型为GyroscopeUncalibratedResponse。

Options

options

可选参数列表,设置上报频率。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);  
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    //打印data的x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX); 
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: AsyncCallback<SignificantMotionResponse>, options?: Options): void

监听有效运动传感器数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的有效运动传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。

callback

AsyncCallback<SignificantMotionResponse>

注册有效运动传感器的回调函数,上报的数据类型为SignificantMotionResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    console.info('Scalar data: ' + data.scalar);
  }
  {interval: 10000000}      
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback: AsyncCallback<PedometerDetectResponse>, options?: Options): void

监听计步检测传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。

callback

AsyncCallback<PedometerDetectResponse>

注册计步检测传感器的回调函数,上报的数据类型为PedometerDetectResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, function(error, data) {
    if (error) {
        console.error(""Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    console.info('Scalar data: ' + data.scalar);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: AsyncCallback<PedometerResponse>, options?: Options): void

监听计步传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。

callback

AsyncCallback<PedometerResponse>

注册计步传感器的回调函数,上报的数据类型为PedometerResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的步数
    console.info('Steps: ' + data.steps);
  }
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:AsyncCallback<AmbientTemperatureResponse>, options?: Options): void

监听环境温度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。

callback

AsyncCallback<AmbientTemperatureResponse>

注册环境温度传感器的回调函数,上报的数据类型为AmbientTemperatureResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的温度值
    console.info('Temperature: ' + data.temperature);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: AsyncCallback<MagneticFieldResponse>,options?: Options): void

监听磁场传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。

callback

AsyncCallback<MagneticFieldResponse>

注册磁场传感器的回调函数,上报的数据类型为MagneticFieldResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback:AsyncCallback<MagneticFieldUncalibratedResponse>, options: Options): void

监听未校准磁场传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。

callback

AsyncCallback<MagneticFieldUncalibratedResponse>

注册未校准磁场传感器的回调函数,上报的数据类型为MagneticFieldUncalibratedResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);    
    console.info('Y-coordinate component: ' + data.y);    
    console.info('Z-coordinate component: ' + data.z);    
    //打印data的x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX);    
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
  {interval: 10000000}   //设置数据的上报频率。
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: AsyncCallback<ProximityResponse>,options?: Options): void

监听接近光传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。

callback

AsyncCallback<ProximityResponse>

注册接近光传感器的回调函数,上报的数据类型为ProximityResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的距离值
    console.info('Distance: ' + data.distance);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: AsyncCallback<HumidityResponse>,options?: Options): void

监听湿度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。

callback

AsyncCallback<HumidityResponse>

注册湿度传感器的回调函数,上报的数据类型为HumidityResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的湿度值
    console.info('Humidity: ' + data.humidity);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: AsyncCallback<BarometerResponse>,options?: Options): void

监听气压计传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。

callback

AsyncCallback<BarometerResponse>

注册气压计传感器的回调函数,上报的数据类型为BarometerResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的压强值
    console.info('Atmospheric pressure: ' + data.pressure);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_HALL, callback: AsyncCallback<HallResponse>, options?: Options): void

监听霍尔传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的霍尔传感器类型为SENSOR_TYPE_ID_HALL。

callback

AsyncCallback<HallResponse>

注册霍尔传感器的回调函数,上报的数据类型为 HallResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HALL, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的状态值
    console.info('Status: ' + data.status);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: AsyncCallback<LightResponse>, options?: Options): void

监听环境光传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。

callback

AsyncCallback<LightResponse>

注册环境光传感器的回调函数,上报的数据类型为LightResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的光强值
    console.info(''Illumination: ' + data.intensity);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: AsyncCallback<OrientationResponse>, options?: Options): void

监听方向传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的方向传感器类型为SENSOR_TYPE_ID_ORIENTATION

callback

AsyncCallback<OrientationResponse>

注册方向传感器的回调函数,上报的数据类型为OrientationResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type:SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR,callback:AsyncCallback<RotationVectorResponse>,options?: Options): void

监听旋转矢量传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。

callback

AsyncCallback<RotationVectorResponse>

注册旋转矢量传感器的回调函数,上报的数据类型为RotationVectorResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
  {interval: 10000000}
);

sensor.on

on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: AsyncCallback<WearDetectionResponse>,options?: Options): void

监听佩戴检测传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。

参数:

参数名

类型

必填

说明

type

SensorType

要订阅的佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。

callback

AsyncCallback<WearDetectionResponse>

注册佩戴检测传感器的回调函数,上报的数据类型为WearDetectionResponse。

Options

options

可选参数列表,设置上报频率,默认值为200000000ns。

示例:

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的佩戴状态
    console.info('Wear status: ' + data.value);
  }
  {interval: 10000000}
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: AsyncCallback<AccelerometerResponse>): void

监听加速度传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。

callback

AsyncCallback<AccelerometerResponse>

注册一次加速度传感器的回调函数,上报的数据类型为AccelerometerResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:AsyncCallback<LinearAccelerometerResponse>): void

监听线性加速度传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。

callback

AsyncCallback<LinearAccelerometerResponse>

注册一次线性加速度传感器的回调函数,上报的数据类型为LinearAccelerometerResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback:AsyncCallback<AccelerometerUncalibratedResponse>): void

监听未校准加速度传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

未校准加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。

callback

AsyncCallback<AccelerometerUncalibratedResponse>

注册一次未校准加速度传感器的回调函数,上报的数据类型为AccelerometerUncalibratedResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    //打印data的x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: AsyncCallback<GravityResponse>): void

监听重力传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

重力传感器类型为SENSOR_TYPE_ID_GRAVITY。

callback

AsyncCallback<GravityResponse>

注册一次重力传感器的回调函数,上报的数据类型为GravityResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: AsyncCallback<GyroscopeResponse>): void

监听陀螺仪传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。

callback

AsyncCallback<GyroscopeResponse>

注册一次陀螺仪传感器的回调函数,上报的数据类型为GyroscopeResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:AsyncCallback<GyroscopeUncalibratedResponse>): void

监听未校准陀螺仪传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。

callback

AsyncCallback<GyroscopeUncalibratedResponse>

注册一次未校准陀螺仪传感器的回调函数,上报的数据类型为GyroscopeUncalibratedResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    //打印data的x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION,callback:AsyncCallback<SignificantMotionResponse>): void

监听有效运动传感器的数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

有效运动传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。

callback

AsyncCallback<SignificantMotionResponse>

注册一次有效运动传感器的回调函数,上报的数据类型为SignificantMotionResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    console.info('Scalar data: ' + data.scalar);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION,callback:AsyncCallback<PedometerDetectResponse>): void

监听计步检测传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。

callback

AsyncCallback<PedometerDetectResponse>

注册一次计步检测传感器的回调函数,上报的数据类型为PedometerDetectResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    console.info('Scalar data: ' + data.scalar);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: AsyncCallback<PedometerResponse>): void

监听计步器传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。

callback

AsyncCallback<PedometerResponse>

注册一次计步传感器的回调函数,上报的数据类型为PedometerResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的步数
    console.info('Steps: ' + data.steps);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:AsyncCallback<AmbientTemperatureResponse>): void

监听环境温度传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。

callback

AsyncCallback<AmbientTemperatureResponse>

注册一次环境温度传感器的回调函数,上报的数据类型为AmbientTemperatureResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的温度值
    console.info('Temperature: ' + data.temperature);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: AsyncCallback<MagneticFieldResponse>): void

监听磁场传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。

callback

AsyncCallback<MagneticFieldResponse>

注册一次磁场传感器的回调函数,上报的数据类型为MagneticFieldResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type:SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback:AsyncCallback<MagneticFieldUncalibratedResponse>): void

监听未校准磁场传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。

callback

AsyncCallback<MagneticFieldUncalibratedResponse>

注册一次未校准磁场传感器的回调函数,上报的数据类型为MagneticFieldUncalibratedResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    //打印data的x,y,z轴坐标的偏移量
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: AsyncCallback<ProximityResponse>): void

监听接近光传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。

callback

AsyncCallback<ProximityResponse>

注册一次接近光传感器的回调函数,上报的数据类型为ProximityResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的距离值
    console.info('Distance: ' + data.distance);
  }
);

senor.once

once(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: AsyncCallback<HumidityResponse>): void

监听湿度传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。

callback

AsyncCallback<HumidityResponse>

注册一次湿度传感器的回调函数,上报的数据类型为HumidityResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的湿度值
    console.info('Humidity: ' + data.humidity);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: AsyncCallback<BarometerResponse>): void

监听气压计传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。

callback

AsyncCallback<BarometerResponse>

注册一次气压计传感器的回调函数,上报的数据类型为BarometerResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的压强值
    console.info('Atmospheric pressure: ' + data.pressure);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_HALL, callback: AsyncCallback<HallResponse>): void

监听霍尔传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

霍尔传感器类型为SENSOR_TYPE_ID_HALL。

callback

AsyncCallback<HallResponse>

注册一次霍尔传感器的回调函数,上报的数据类型为HallResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HALL, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的状态值
    console.info('Status: ' + data.status);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: AsyncCallback<LightResponse>): void

监听环境光传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。

callback

AsyncCallback<LightResponse>

注册一次环境光传感器的回调函数,上报的数据类型为LightResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的光强值
    console.info(''Illumination: ' + data.intensity);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: AsyncCallback<OrientationResponse>): void

监听方向传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

方向传感器类型为SENSOR_TYPE_ID_ORIENTATION。

callback

AsyncCallback<OrientationResponse>

注册一次方向传感器的回调函数,上报的数据类型为OrientationResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: AsyncCallback<RotationVectorResponse>): void

监听旋转矢量传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。

callback

AsyncCallback<RotationVectorResponse>

注册一次旋转矢量传感器的回调函数,上报的数据类型为RotationVectorResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的x,y,z轴坐标的分量
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: AsyncCallback<HeartRateResponse>): void

监听心率传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。

callback

AsyncCallback<HeartRateResponse>

注册一次心率传感器的回调函数,上报的数据类型为HeartRateResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HEART_RATE, function(error, data) {
    if (error) {
        console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    //打印data的心率值
    console.info("Heart rate: " + data.heartRate);
  }
);

sensor.once

once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: AsyncCallback<WearDetectionResponse>): void

监听佩戴检测传感器数据变化一次。

参数:

参数名

类型

必填

说明

type

SensorType

佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。

callback

AsyncCallback<WearDetectionResponse>

注册一次穿戴检测传感器的回调函数,上报的数据类型为WearDetectionResponse。

示例:

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, function(error, data) {
    if (error) {
        console.error("Failed to register data, error code is" + error.code + ", message: " + error.message);
        return;
    }
    //打印data的佩戴状态
    console.info("Wear status: "+ data.value);
  }
);

sensor.off

off(type: SensorType, callback?: AsyncCallback<void>): void

取消订阅传感器数据。

参数:

参数名

类型

必填

说明

type

SensorType

要取消订阅的传感器类型。

callback

AsyncCallback<void>

取消订阅的传感器的回调函数,表示接口调用是否成功。

示例:

sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER, function(error) {
    if (error) {
        console.error("Failed to unsubscribe from acceleration sensor data. Error code: " + error.code + "; message: " + error.message);
        return;
    }
    console.info("Succeeded in unsubscribing from acceleration sensor data.");
  }
);

SensorType

表示要订阅或取消订阅的传感器类型。

名称

默认值

说明

SENSOR_TYPE_ID_ACCELEROMETER

1

加速度传感器。

SENSOR_TYPE_ID_GYROSCOPE

2

陀螺仪传感器。

SENSOR_TYPE_ID_AMBIENT_LIGHT

5

环境光传感器。

SENSOR_TYPE_ID_MAGNETIC_FIELD

6

磁场传感器。

SENSOR_TYPE_ID_BAROMETER

8

气压计传感器。

SENSOR_TYPE_ID_HALL

10

霍尔传感器。

SENSOR_TYPE_ID_PROXIMITY

12

接近光传感器。

SENSOR_TYPE_ID_HUMIDITY

13

湿度传感器。

SENSOR_TYPE_ID_ORIENTATION

256

方向传感器。

SENSOR_TYPE_ID_GRAVITY

257

重力传感器。

SENSOR_TYPE_ID_LINEAR_ACCELERATION

258

线性加速度传感器。

SENSOR_TYPE_ID_ROTATION_VECTOR

259

旋转矢量传感器。

SENSOR_TYPE_ID_AMBIENT_TEMPERATURE

260

环境温度传感器。

SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED

261

未校准磁场传感器。

SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED

263

未校准陀螺仪传感器。

SENSOR_TYPE_ID_SIGNIFICANT_MOTION

264

有效运动传感器。

SENSOR_TYPE_ID_PEDOMETER_DETECTION

265

计步检测传感器。

SENSOR_TYPE_ID_PEDOMETER

266

计步传感器。

SENSOR_TYPE_ID_HEART_RATE

278

心率传感器。

SENSOR_TYPE_ID_WEAR_DETECTION

280

佩戴检测传感器。

SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED

281

未校准加速度计传感器。

AccelerometerResponse

加速度传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

LinearAccelerometerResponse

线性加速度传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

AccelerometerUncalibratedResponse

未校准加速度计传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

biasX

number

x轴坐标偏移量。

biasY

number

y轴坐标偏移量。

biasZ

number

z轴坐标偏移量。

GravityResponse

重力传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

OrientationResponse

方向传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

RotationVectorResponse

旋转矢量传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

GyroscopeResponse

陀螺仪传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

GyroscopeUncalibratedResponse

未校准陀螺仪传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

biasX

number

x轴坐标偏移量。

biasY

number

y轴坐标偏移量。

biasZ

number

z轴坐标偏移量。

SignificantMotionResponse

有效运动传感器数据。

属性

名称

参数类型

可读

可写

说明

scalar

number

表示剧烈运动程度。测量三个物理轴(x、y 和 z)上,设备是否存在大幅度运动;如果取值为1则代表存在大幅度运动,取值为0则代表没有大幅度运动。

ProximityResponse

接近光传感器数据。

属性

名称

参数类型

可读

可写

说明

distance

number

可见物体与设备显示器的接近程度。0表示接近,1表示远离。

LightResponse

环境光传感器数据。

属性

名称

参数类型

可读

可写

说明

intensity

number

光强(单位:勒克斯)。

HallResponse

霍尔传感器数据。

属性

名称

参数类型

可读

可写

说明

status

number

显示霍尔状态。测量设备周围是否存在磁力吸引,0表示有,1表示没有。

MagneticFieldResponse

磁场传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

MagneticFieldUncalibratedResponse

未校准磁场传感器数据。

属性

名称

参数类型

可读

可写

说明

x

number

x轴坐标分量。

y

number

y轴坐标分量。

z

number

z轴坐标分量。

biasX

number

x轴坐标偏移量。

biasY

number

y轴坐标偏移量。

biasZ

number

z轴坐标偏移量。

PedometerResponse

计步传感器数据。

属性

名称

参数类型

可读

可写

说明

steps

number

计数的步骤数。每次设备重新启动时,该值将从0重新计算。

HumidityResponse

湿度传感器数据。

属性

名称

参数类型

可读

可写

说明

humidity

number

湿度值。测量环境的相对湿度,以百分比 (%) 表示。

PedometerDetectResponse

计步检测传感器数据。

属性

名称

参数类型

可读

可写

说明

scalar

number

计步器检测。检测用户的计步动作,如果取值为1则代表用户产生了计步行走的动作,取值为0则代表用户没有发生运动。

AmbientTemperatureResponse

温度传感器数据。

属性

名称

参数类型

可读

可写

说明

temperature

number

环境温度(单位:摄氏度)。

BarometerResponse

气压计传感器数据。

属性

名称

参数类型

可读

可写

说明

pressure

number

压力值(单位:帕斯卡)。

HeartRateResponse

心率传感器数据。

属性

名称

参数类型

可读

可写

说明

heartRate

number

心率值。测量用户的心率数值,单位是次/分。

WearDetectionResponse

佩戴检测传感器数据。

属性

名称

参数类型

可读

可写

说明

value

boolean

表示设备是否被穿戴(true 表示已穿戴,false表示未穿戴)。