OrientationEventListener
instead.
This class internally uses the OrientationEventListener.@Deprecated public abstract class OrientationListener extends Object implements SensorListener
Modifier and Type | Field and Description |
---|---|
static int |
ORIENTATION_UNKNOWN
Deprecated.
Returned from onOrientationChanged when the device orientation cannot be determined
(typically when the device is in a close to flat position).
|
Constructor and Description |
---|
OrientationListener(Context context)
Deprecated.
Creates a new OrientationListener.
|
OrientationListener(Context context,
int rate)
Deprecated.
Creates a new OrientationListener.
|
Modifier and Type | Method and Description |
---|---|
void |
disable()
Deprecated.
Disables the OrientationListener.
|
void |
enable()
Deprecated.
Enables the OrientationListener so it will monitor the sensor and call
onOrientationChanged(int) when the device orientation changes. |
void |
onAccuracyChanged(int sensor,
int accuracy)
Deprecated.
Called when the accuracy of a sensor has changed.
|
abstract void |
onOrientationChanged(int orientation)
Deprecated.
Look at
OrientationEventListener.onOrientationChanged(int)
for method description and usage |
void |
onSensorChanged(int sensor,
float[] values)
Deprecated.
Called when sensor values have changed.
|
public static final int ORIENTATION_UNKNOWN
onOrientationChanged(int)
,
Constant Field Valuespublic OrientationListener(Context context)
context
- for the OrientationListener.public OrientationListener(Context context, int rate)
context
- for the OrientationListener.rate
- at which sensor events are processed (see also
SensorManager
). Use the default
value of SENSOR_DELAY_NORMAL
for simple screen orientation change detection.public void enable()
onOrientationChanged(int)
when the device orientation changes.public void disable()
public void onAccuracyChanged(int sensor, int accuracy)
SensorListener
SensorManager
for details.onAccuracyChanged
in interface SensorListener
sensor
- The ID of the sensor being monitoredaccuracy
- The new accuracy of this sensor.public void onSensorChanged(int sensor, float[] values)
SensorListener
Called when sensor values have changed.
The length and contents of the values array vary
depending on which sensor is being monitored.
See SensorManager
for details on possible sensor types.
Definition of the coordinate system used below.
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.
IMPORTANT NOTE: The axis are swapped when the device's screen orientation changes. To access the unswapped values, use indices 3, 4 and 5 in values[].
SENSOR_ORIENTATION
,
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).
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
Examples:
-STANDARD_GRAVITY
,
which correspond to the force the device applies on the table in reaction
to gravity.All values are in micro-Tesla (uT) and measure the ambient magnetic field in the X, Y and -Z axis.
Note: the magnetic field's Z axis is inverted.
onSensorChanged
in interface SensorListener
sensor
- The ID of the sensor being monitoredvalues
- The new values for the sensor.public abstract void onOrientationChanged(int orientation)
OrientationEventListener.onOrientationChanged(int)
for method description and usageorientation
- The new orientation of the device.ORIENTATION_UNKNOWN