Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#constants) \| [Fields](https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#lfields) \| [Inherited Methods](https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#inhmethods)

# SensorAdditionalInfo

*** ** * ** ***

` public class SensorAdditionalInfo `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.hardware.SensorAdditionalInfo |

<br />

*** ** * ** ***

This class represents a `https://developer.android.com/reference/android/hardware/Sensor` additional information frame, which is reported through listener callback `https://developer.android.com/reference/android/hardware/SensorEventCallback#onSensorAdditionalInfo(android.hardware.SensorAdditionalInfo)`.
**See also:**

- `https://developer.android.com/reference/android/hardware/SensorManager`
- `https://developer.android.com/reference/android/hardware/SensorEventCallback`
- `https://developer.android.com/reference/android/hardware/Sensor`

## Summary

| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_FRAME_BEGIN` Mark the beginning of a set of additional info frames. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_FRAME_END` Mark the end of a set of additional info frames. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_INTERNAL_TEMPERATURE` Internal temperature. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_SAMPLING` Sampling parameter. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_SENSOR_PLACEMENT` Sensor placement. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_UNTRACKED_DELAY` Untracked delay. |
| `int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#TYPE_VEC3_CALIBRATION` Vector calibration parameter. |

| ### Fields ||
|---|---|
| ` public final float[]` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#floatValues` Additional info payload data represented in float values. |
| ` public final int[]` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#intValues` Additional info payload data represented in int values. |
| ` public final https://developer.android.com/reference/android/hardware/Sensor` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#sensor` The sensor that generated this event. |
| ` public final int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#serial` Sequence number of frame for a certain type. |
| ` public final int` | `https://developer.android.com/reference/android/hardware/SensorAdditionalInfo#type` Type of this additional info frame. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Constants

### TYPE_FRAME_BEGIN

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_FRAME_BEGIN
```

Mark the beginning of a set of additional info frames.

<br />

Constant Value: 0 (0x00000000)

### TYPE_FRAME_END

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_FRAME_END
```

Mark the end of a set of additional info frames.

<br />

Constant Value: 1 (0x00000001)

### TYPE_INTERNAL_TEMPERATURE

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_INTERNAL_TEMPERATURE
```

Internal temperature. Sensor hardware device internal temperature. Payload: floatValues\[0\]: internal temperature in Celsius.

<br />

Constant Value: 65537 (0x00010001)

### TYPE_SAMPLING

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_SAMPLING
```

Sampling parameter. Describes the raw sample period and estimated jitter of sample time in terms of standard deviation. Payload: floatValues\[0\]: raw sample period in seconds. floatValues\[1\]: standard deviation of sampling period.

<br />

Constant Value: 65540 (0x00010004)

### TYPE_SENSOR_PLACEMENT

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_SENSOR_PLACEMENT
```

Sensor placement. Provides the orientation and location of the sensor element in terms of the Android coordinate system. This data is given as a 3x4 matrix consisting of a 3x3 rotation matrix (R) concatenated with a 3x1 location vector (t). The rotation matrix provides the orientation of the Android device coordinate frame relative to the local coordinate frame of the sensor. Note that assuming the axes conventions of the sensor are the same as Android, this is the inverse of the matrix applied to raw samples read from the sensor to convert them into the Android representation. The location vector represents the translation from the origin of the Android sensor coordinate system to the geometric center of the sensor, specified in millimeters (mm).

**Payload** : `floatValues[0..11]`: 3x4 matrix in row major order \[R; t\]

**Example** : This raw buffer: `{0, 1, 0, 0, -1, 0, 0, 10, 0, 0, 1, -2.5}`  

Corresponds to this 3x4 matrix:

| Orientation ||| Location |
|---|---|---|---|
| 0 | 1 | 0 | 0 |
| -1 | 0 | 0 | 10 |
| 0 | 0 | 1 | -2.5 |

The sensor is oriented such that:

- The device X axis corresponds to the sensor's local -Y axis
- The device Y axis corresponds to the sensor's local X axis
- The device Z axis and sensor's local Z axis are equivalent

In other words, if viewing the origin of the Android coordinate system from the positive Z direction, the device coordinate frame is to be rotated 90° counter-clockwise about the Z axis to align with the sensor's local coordinate frame. Equivalently, a vector in the Android coordinate frame may be multiplied with R to rotate it 90° clockwise (270° counter-clockwise), yielding its representation in the sensor's coordinate frame. Relative to the origin of the Android coordinate system, the physical center of the sensor is located 10mm in the positive Y direction, and 2.5mm in the negative Z direction.

<br />

<br />

<br />

Constant Value: 65539 (0x00010003)

### TYPE_UNTRACKED_DELAY

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_UNTRACKED_DELAY
```

Untracked delay. Delays that are introduced by data processing, such as filtering, which is not taken into account by sensor timestamps. Payload: floatValues\[0\]: delay estimation in seconds floatValues\[1\]: delay estimation standard deviation

<br />

Constant Value: 65536 (0x00010000)

### TYPE_VEC3_CALIBRATION

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int TYPE_VEC3_CALIBRATION
```

Vector calibration parameter. Calibration applied to a sensor with 3 elements vector output, such as accelerometer, gyro, etc. Payload: floatValues\[0..11\]: First 3 rows of a homogeneous matrix in row major order that captures any linear transformation, including rotation, scaling, shear, shift.

<br />

Constant Value: 65538 (0x00010002)

## Fields

### floatValues

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public final float[] floatValues
```

Additional info payload data represented in float values. Depending on the type of information, this may be null.

<br />

### intValues

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public final int[] intValues
```

Additional info payload data represented in int values. Depending on the type of information, this may be null.

<br />

### sensor

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public final Sensor sensor
```

The sensor that generated this event. See `https://developer.android.com/reference/android/hardware/SensorManager` for details.

<br />

### serial

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public final int serial
```

Sequence number of frame for a certain type.

<br />

### type

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public final int type
```

Type of this additional info frame.

<br />