diff --git a/interfaces/kits/c/oh_sensor.h b/interfaces/kits/c/oh_sensor.h
index 3c9b54ddf85220bdfe35af49a08ff63b2b3fa8a3..5b2718a99f972c65e7a5b6a363a887acd2fd5124 100644
--- a/interfaces/kits/c/oh_sensor.h
+++ b/interfaces/kits/c/oh_sensor.h
@@ -45,8 +45,10 @@ extern "C" {
* @param infos - Double pointer to the information about all sensors on the device.
* For details, see {@link Sensor_Info}.
* @param count - Pointer to the number of sensors on the device.
- * @return Returns SENSOR_SUCCESS if the operation is successful;
- * returns an error code defined in {@link Sensor_Result} otherwise.
+ * @return Returns SENSOR_SUCCESS if the operation is successful; returns the following error code otherwise.
+ * {@link SENSOR_PARAMETER_ERROR} Parameter check failed. For example, the parameter is invalid,
+ * or the parameter type passed in is incorrect.\n
+ * {@link SENSOR_SERVICE_EXCEPTION} The sensor service is abnormal.\n
*
* @since 11
*/
@@ -65,8 +67,11 @@ Sensor_Result OH_Sensor_GetInfos(Sensor_Info **infos, uint32_t *count);
* For details, see {@link Sensor_SubscriptionAttribute}.
* @param subscriber - Pointer to the subscriber information, which is used to specify the callback function for
* reporting the sensor data. For details, see {@link Sensor_Subscriber}.
- * @return Returns SENSOR_SUCCESS if the operation is successful;
- * returns an error code defined in {@link Sensor_Result} otherwise.
+ * @return Returns SENSOR_SUCCESS if the operation is successful; returns the following error code otherwise.
+ * {@link SENSOR_PERMISSION_DENIED} Permission verification failed.\n
+ * {@link SENSOR_PARAMETER_ERROR} Parameter check failed. For example, the parameter is invalid,
+ * or the parameter type passed in is incorrect.\n
+ * {@link SENSOR_SERVICE_EXCEPTION} The sensor service is abnormal.\n
* @permission ohos.permission.ACCELEROMETER or ohos.permission.GYROSCOPE or
* ohos.permission.ACTIVITY_MOTION or ohos.permission.READ_HEALTH_DATA
* @since 11
@@ -85,8 +90,11 @@ Sensor_Result OH_Sensor_Subscribe(const Sensor_SubscriptionId *id,
* @param id - Pointer to the sensor subscription ID. For details, see {@link Sensor_SubscriptionId}.
* @param subscriber - Pointer to the subscriber information, which is used to specify the callback function for
* reporting the sensor data. For details, see {@link Sensor_Subscriber}.
- * @return Returns SENSOR_SUCCESS if the operation is successful;
- * returns an error code defined in {@link Sensor_Result} otherwise.
+ * @return Returns SENSOR_SUCCESS if the operation is successful; returns the following error code otherwise.
+ * {@link SENSOR_PERMISSION_DENIED} Permission verification failed.\n
+ * {@link SENSOR_PARAMETER_ERROR} Parameter check failed. For example, the parameter is invalid,
+ * or the parameter type passed in is incorrect.\n
+ * {@link SENSOR_SERVICE_EXCEPTION} The sensor service is abnormal.\n
* @permission ohos.permission.ACCELEROMETER or ohos.permission.GYROSCOPE or
* ohos.permission.ACTIVITY_MOTION or ohos.permission.READ_HEALTH_DATA
*
diff --git a/interfaces/kits/c/oh_sensor_type.h b/interfaces/kits/c/oh_sensor_type.h
index e0ab040e90cae5eb0224b1267f3dbc1b33515cfe..0641a9c0cf414e456dcedd7e972d3df5bb2d8f50 100644
--- a/interfaces/kits/c/oh_sensor_type.h
+++ b/interfaces/kits/c/oh_sensor_type.h
@@ -91,11 +91,21 @@ typedef enum Sensor_Type {
* @since 11
*/
SENSOR_TYPE_GRAVITY = 257,
+ /**
+ * Linear acceleration sensor.
+ * @since 13
+ */
+ SENSOR_TYPE_LINEAR_ACCELERATION = 258,
/**
* Rotation vector sensor.
* @since 11
*/
SENSOR_TYPE_ROTATION_VECTOR = 259,
+ /**
+ * Game rotation vector sensor.
+ * @since 13
+ */
+ SENSOR_TYPE_GAME_ROTATION_VECTOR = 262,
/**
* Pedometer detection sensor.
* @since 11
@@ -120,23 +130,23 @@ typedef enum Sensor_Type {
*/
typedef enum Sensor_Result {
/**
- * The operation is successful.
+ * @error The operation is successful.
* @since 11
*/
SENSOR_SUCCESS = 0,
/**
- * Permission verification failed.
+ * @error Permission verification failed.
* @since 11
*/
SENSOR_PERMISSION_DENIED = 201,
/**
- * Parameter check failed. For example, a mandatory parameter is not passed in,
+ * @error Parameter check failed. For example, a mandatory parameter is not passed in,
* or the parameter type passed in is incorrect.
* @since 11
*/
SENSOR_PARAMETER_ERROR = 401,
/**
- * The sensor service is abnormal.
+ * @error The sensor service is abnormal.
* @since 11
*/
SENSOR_SERVICE_EXCEPTION = 14500101,
@@ -277,35 +287,35 @@ typedef struct Sensor_Event Sensor_Event;
/**
* @brief Obtains the sensor type.
*
- * @param Sensor_Event - Pointer to the sensor data information.
+ * @param sensorEvent - Pointer to the sensor data information.
* @param sensorType - Pointer to the sensor type.
* @return Returns SENSOR_SUCCESS if the operation is successful;
* returns an error code defined in {@link Sensor_Result} otherwise.
* @since 11
*/
-int32_t OH_SensorEvent_GetType(Sensor_Event* Sensor_Event, Sensor_Type *sensorType);
+int32_t OH_SensorEvent_GetType(Sensor_Event* sensorEvent, Sensor_Type *sensorType);
/**
* @brief Obtains the timestamp of sensor data.
*
- * @param Sensor_Event - Pointer to the sensor data information.
+ * @param sensorEvent - Pointer to the sensor data information.
* @param timestamp - Pointer to the timestamp.
* @return Returns SENSOR_SUCCESS if the operation is successful;
* returns an error code defined in {@link Sensor_Result} otherwise.
* @since 11
*/
-int32_t OH_SensorEvent_GetTimestamp(Sensor_Event* Sensor_Event, int64_t *timestamp);
+int32_t OH_SensorEvent_GetTimestamp(Sensor_Event* sensorEvent, int64_t *timestamp);
/**
* @brief Obtains the accuracy of sensor data.
*
- * @param Sensor_Event - Pointer to the sensor data information.
+ * @param sensorEvent - Pointer to the sensor data information.
* @param accuracy - Pointer to the accuracy.
* @return Returns SENSOR_SUCCESS if the operation is successful;
* returns an error code defined in {@link Sensor_Result} otherwise.
* @since 11
*/
-int32_t OH_SensorEvent_GetAccuracy(Sensor_Event* Sensor_Event, Sensor_Accuracy *accuracy);
+int32_t OH_SensorEvent_GetAccuracy(Sensor_Event* sensorEvent, Sensor_Accuracy *accuracy);
/**
* @brief Obtains sensor data. The data length and content depend on the sensor type.
@@ -314,7 +324,9 @@ int32_t OH_SensorEvent_GetAccuracy(Sensor_Event* Sensor_Event, Sensor_Accuracy *
* the x, y, and z axes of the device, respectively, in m/s2.
* SENSOR_TYPE_GYROSCOPE: data[0], data[1], and data[2], indicating the angular velocity of rotation around
* the x, y, and z axes of the device, respectively, in rad/s.
- * SENSOR_TYPE_AMBIENT_LIGHT: data[0], indicating the ambient light intensity, in lux.
+ * SENSOR_TYPE_AMBIENT_LIGHT: data[0], indicating the ambient light intensity, in lux. Since api version 12,
+ * two additional data will be returned, where data[1] indicating the color temperature, in kelvin; data[2]
+ * indicating the infrared luminance, in cd/m2.
* SENSOR_TYPE_MAGNETIC_FIELD: data[0], data[1], and data[2], indicating the magnetic field strength around
* the x, y, and z axes of the device, respectively, in μT.
* SENSOR_TYPE_BAROMETER: data[0], indicating the atmospheric pressure, in hPa.
@@ -332,15 +344,20 @@ int32_t OH_SensorEvent_GetAccuracy(Sensor_Event* Sensor_Event, Sensor_Accuracy *
* The value 1 means that the number of detected steps changes.
* SENSOR_TYPE_PEDOMETER: data[0], indicating the number of steps a user has walked.
* SENSOR_TYPE_HEART_RATE: data[0], indicating the heart rate value.
+ * SENSOR_TYPE_LINEAR_ACCELERATION: Supported from api version 13. data[0], data[1], and data[2], indicating the
+ * linear acceleration around the x, y, and z axes of the device, respectively, in m/s2.
+ * SENSOR_TYPE_GAME_ROTATION_VECTOR: Supported from api version 13. data[0], data[1] and data[2], indicating the
+ * rotation angles of a device around the x, y, and z axes, respectively, in degree. data[3] indicates the rotation
+ * vector.
*
- * @param Sensor_Event - Pointer to the sensor data information.
+ * @param sensorEvent - Pointer to the sensor data information.
* @param data - Double pointer to the sensor data.
* @param length - Pointer to the array length.
* @return Returns SENSOR_SUCCESS if the operation is successful;
* returns an error code defined in {@link Sensor_Result} otherwise.
* @since 11
*/
-int32_t OH_SensorEvent_GetData(Sensor_Event* Sensor_Event, float **data, uint32_t *length);
+int32_t OH_SensorEvent_GetData(Sensor_Event* sensorEvent, float **data, uint32_t *length);
/**
* @brief Defines the sensor subscription ID, which uniquely identifies a sensor.
@@ -371,7 +388,7 @@ int32_t OH_Sensor_DestroySubscriptionId(Sensor_SubscriptionId *id);
* @brief Obtains the sensor type.
*
* @param id - Pointer to the sensor subscription ID.
- * @param id - Pointer to the sensor type.
+ * @param sensorType - Pointer to the sensor type.
* @return Returns SENSOR_SUCCESS if the operation is successful;
* returns an error code defined in {@link Sensor_Result} otherwise.
* @since 11