程序包 ohos.sensor.data

类 CategoryOrientationData

java.lang.Object

ohos.sensor.data.SensorData<CategoryOrientation>

ohos.sensor.data.CategoryOrientationData

public class CategoryOrientationData
extends SensorData<CategoryOrientation>

Inherits from SensorData and describes data information of orientation sensors.

The data information includes the timestamps, accuracy, data values, and data dimensions of sensors. This class also provides the method for constructing a CategoryOrientationData instance.

从以下版本开始:

1

另请参阅:

SensorData, CategoryOrientation

SystemCapability

SystemCapability.Sensors#SENSOR

字段概要

从类继承的字段 ohos.sensor.data.SensorData

accuracy, DEFAULT_SENSOR_DATA_DIMS, sensor, sensorDataDim, timestamp, values

构造器概要

构造器

构造器	说明
CategoryOrientationData(CategoryOrientation sensor, int accuracy, long timestamp, int sensorDataDim, float[] values)	A constructor used to create a CategoryOrientationData instance.

方法概要

限定符和类型	方法	说明
static float[]	getDeviceOrientation(float[] rotationMatrix, float[] rotationAngle)	Obtains the device orientation based on the rotation matrix.
static void	getDeviceRotationMatrix(float[] rotationMatrix, float[] rotationVector)	Obtains the rotation matrix of the current device position based on the rotation vector.
static float[]	getQuaternionValues(float[] rotationVector)	Obtains a quaternion from data of a rotation vector sensor.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从类继承的方法 ohos.sensor.data.SensorData

getAccuracy, getSensor, getSensorDataDim, getTimestamp, getValues

构造器详细资料

CategoryOrientationData

public CategoryOrientationData(CategoryOrientation sensor,
                               int accuracy,
                               long timestamp,
                               int sensorDataDim,
                               float[] values)

A constructor used to create a CategoryOrientationData instance.

参数:

sensor - Indicates a sensor.

accuracy - Indicates the sensor accuracy.

timestamp - Indicates the sensor timestamp.

sensorDataDim - Indicates the data dimension of the sensor.

values - Indicates the data values of the sensor.

从以下版本开始:

1

方法详细资料

getQuaternionValues

public static float[] getQuaternionValues(float[] rotationVector)

Obtains a quaternion from data of a rotation vector sensor.

参数:

rotationVector - Indicates the rotation vector sensor data, in which the first four elements represent the x, y, z, and w components respectively.

返回:

Returns the quaternion, in which each element represents the w, x, y, and z components of the rotation vector sensor respectively.

从以下版本开始:

4

getDeviceRotationMatrix

public static void getDeviceRotationMatrix(float[] rotationMatrix,
                                           float[] rotationVector)

Obtains the rotation matrix of the current device position based on the rotation vector.

参数:

rotationMatrix - Indicates a floating-point array to store the rotation matrix. The array length can be 9 (to store a three-dimensional rotation matrix) or 16 (to store a four-dimensional rotation matrix).

rotationVector - Indicates the rotation vector.

从以下版本开始:

5

getDeviceOrientation

public static float[] getDeviceOrientation(float[] rotationMatrix,
                                           float[] rotationAngle)

Obtains the device orientation based on the rotation matrix.

参数:

rotationMatrix - Indicates the rotation matrix, which can be obtained via getDeviceRotationMatrix(float[], float[]).

rotationAngle - Indicates a floating-point array to store the three device orientation values. The value rotationAngle[0] indicates rotation around the Z axis. It represents the azimuth, that is, the angle between the Y axis of the device and the magnetic north pole. rotationAngle[1] indicates rotation around the X axis. It represents the pitch, that is, the angle between the plane parallel to the device screen and the plane parallel to the ground. rotationAngle[2] indicates rotation around the Y axis. It represents the roll, that is, the angle between the plane perpendicular to the device screen and the plane perpendicular to the ground.

返回:

Returns an array of rotationAngle values.

从以下版本开始:

5