ISensorListener.OnSensorChanged(SensorType, Single[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
deprecated
Called when sensor values have changed.
[Android.Runtime.Register("onSensorChanged", "(I[F)V", "GetOnSensorChanged_IarrayFHandler:Android.Hardware.ISensorListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
[System.Obsolete("deprecated")]
public void OnSensorChanged (Android.Hardware.SensorType sensor, float[]? values);[<Android.Runtime.Register("onSensorChanged", "(I[F)V", "GetOnSensorChanged_IarrayFHandler:Android.Hardware.ISensorListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
[<System.Obsolete("deprecated")>]
abstract member OnSensorChanged : Android.Hardware.SensorType * single[] -> unitParameters
- sensor
- SensorType
The ID of the sensor being monitored
- values
- Single[]
The new values for the sensor.
- Attributes
Remarks
Called when sensor values have changed. The length and contents of the values array vary depending on which sensor is being monitored. See android.hardware.SensorManager SensorManager for details on possible sensor types.
<u>Definition of the coordinate system used below.</u>
The X axis refers to the screen's horizontal axis (the small edge in portrait mode, the long edge in landscape mode) and points to the right.
The Y axis refers to the screen's vertical axis and points towards the top of the screen (the origin is in the lower-left corner).
The Z axis points toward the sky when the device is lying on its back on a table.
<b>IMPORTANT NOTE:</b> The axis <b><u>are swapped</u></b> when the device's screen orientation changes. To access the unswapped values, use indices 3, 4 and 5 in values[].
android.hardware.SensorManager#SENSOR_ORIENTATION SENSOR_ORIENTATION, android.hardware.SensorManager#SENSOR_ORIENTATION_RAW SENSOR_ORIENTATION_RAW:
All values are angles in degrees.
values[0]: Azimuth, rotation around the Z axis (0<=azimuth<360). 0 = North, 90 = East, 180 = South, 270 = West
values[1]: Pitch, rotation around X axis (-180<=pitch<=180), with positive values when the z-axis moves toward the y-axis.
values[2]: Roll, rotation around Y axis (-90<=roll<=90), with positive values when the z-axis moves toward the x-axis.
Note that this definition of yaw, pitch and roll is different from the traditional definition used in aviation where the X axis is along the long side of the plane (tail to nose).
android.hardware.SensorManager#SENSOR_ACCELEROMETER SENSOR_ACCELEROMETER:
All values are in SI units (m/s^2) and measure contact forces.
values[0]: force applied by the device on the x-axis
values[1]: force applied by the device on the y-axis
values[2]: force applied by the device on the z-axis
<u>Examples</u>: <li>When the device is pushed on its left side toward the right, the x acceleration value is negative (the device applies a reaction force to the push toward the left)</li>
<li>When the device lies flat on a table, the acceleration value is android.hardware.SensorManager#STANDARD_GRAVITY -STANDARD_GRAVITY, which correspond to the force the device applies on the table in reaction to gravity.</li>
android.hardware.SensorManager#SENSOR_MAGNETIC_FIELD SENSOR_MAGNETIC_FIELD:
All values are in micro-Tesla (uT) and measure the ambient magnetic field in the X, Y and -Z axis.
<b><u>Note:</u></b> the magnetic field's Z axis is inverted.
Java documentation for android.hardware.SensorListener.onSensorChanged(int, float[]).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.