SensorManager开发参考

参考网址：https://developer.android.com/reference/android/hardware/SensorManager

对SensorManager内容进行摘抄

java 复制代码

public abstract class SensorManager
extends Object

|---|--------------------------------|
| java.lang.Object ||
| ↳ | android.hardware.SensorManager |

SensorManager lets you access the device's sensors.

Always make sure to disable sensors you don't need, especially when your activity is paused. Failing to do so can drain the battery in just a few hours. Note that the system will not disable sensors automatically when the screen turns off.

Note: Don't use this mechanism with a Trigger Sensor, have a look at TriggerEventListener. Sensor.TYPE_SIGNIFICANT_MOTION is an example of a trigger sensor.

In order to access sensor data at high sampling rates (i.e. greater than 200 Hz for SensorEventListener and greater than SensorDirectChannel.RATE_NORMAL for SensorDirectChannel), apps must declare the Manifest.permission.HIGH_SAMPLING_RATE_SENSORS permission in their AndroidManifest.xml file.

java 复制代码

public class SensorActivity extends Activity implements SensorEventListener {
     private final SensorManager mSensorManager;
     private final Sensor mAccelerometer;

     public SensorActivity() {
         mSensorManager = (SensorManager)getSystemService(SENSOR_SERVICE);
         mAccelerometer = mSensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
     }

     protected void onResume() {
         super.onResume();
         mSensorManager.registerListener(this, mAccelerometer, SensorManager.SENSOR_DELAY_NORMAL);
     }

     protected void onPause() {
         super.onPause();
         mSensorManager.unregisterListener(this);
     }

     public void onAccuracyChanged(Sensor sensor, int accuracy) {
     }

     public void onSensorChanged(SensorEvent event) {
     }
 }

复制代码

See also:

Summary

#### Nested classes
`class`	SensorManager.DynamicSensorCallback Used for receiving notifications from the SensorManager when dynamic sensors are connected or disconnected.

#### Constants
`int`	AXIS_MINUS_X see remapCoordinateSystem(float, int, int, float)
`int`	AXIS_MINUS_Y see remapCoordinateSystem(float, int, int, float)
`int`	AXIS_MINUS_Z see remapCoordinateSystem(float, int, int, float)
`int`	AXIS_X see remapCoordinateSystem(float, int, int, float)
`int`	AXIS_Y see remapCoordinateSystem(float, int, int, float)
`int`	AXIS_Z see remapCoordinateSystem(float, int, int, float)
`int`	DATA_X This constant was deprecated in API level 15. use Sensor instead.
`int`	DATA_Y This constant was deprecated in API level 15. use Sensor instead.
`int`	DATA_Z This constant was deprecated in API level 15. use Sensor instead.
`float`	GRAVITY_DEATH_STAR_I Gravity (estimate) on the first Death Star in Empire units (m/s^2)
`float`	GRAVITY_EARTH Earth's gravity in SI units (m/s^2)
`float`	GRAVITY_JUPITER Jupiter's gravity in SI units (m/s^2)
`float`	GRAVITY_MARS Mars' gravity in SI units (m/s^2)
`float`	GRAVITY_MERCURY Mercury's gravity in SI units (m/s^2)
`float`	GRAVITY_MOON The Moon's gravity in SI units (m/s^2)
`float`	GRAVITY_NEPTUNE Neptune's gravity in SI units (m/s^2)
`float`	GRAVITY_PLUTO Pluto's gravity in SI units (m/s^2)
`float`	GRAVITY_SATURN Saturn's gravity in SI units (m/s^2)
`float`	GRAVITY_SUN Sun's gravity in SI units (m/s^2)
`float`	GRAVITY_THE_ISLAND Gravity on the island
`float`	GRAVITY_URANUS Uranus' gravity in SI units (m/s^2)
`float`	GRAVITY_VENUS Venus' gravity in SI units (m/s^2)
`float`	LIGHT_CLOUDY luminance under a cloudy sky in lux
`float`	LIGHT_FULLMOON luminance at night with full moon in lux
`float`	LIGHT_NO_MOON luminance at night with no moon in lux
`float`	LIGHT_OVERCAST luminance under an overcast sky in lux
`float`	LIGHT_SHADE luminance in shade in lux
`float`	LIGHT_SUNLIGHT luminance of sunlight in lux
`float`	LIGHT_SUNLIGHT_MAX Maximum luminance of sunlight in lux
`float`	LIGHT_SUNRISE luminance at sunrise in lux
`float`	MAGNETIC_FIELD_EARTH_MAX Maximum magnetic field on Earth's surface
`float`	MAGNETIC_FIELD_EARTH_MIN Minimum magnetic field on Earth's surface
`float`	PRESSURE_STANDARD_ATMOSPHERE Standard atmosphere, or average sea-level pressure in hPa (millibar)
`int`	RAW_DATA_INDEX This constant was deprecated in API level 15. use Sensor instead.
`int`	RAW_DATA_X This constant was deprecated in API level 15. use Sensor instead.
`int`	RAW_DATA_Y This constant was deprecated in API level 15. use Sensor instead.
`int`	RAW_DATA_Z This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_ACCELEROMETER This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_ALL This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_DELAY_FASTEST get sensor data as fast as possible
`int`	SENSOR_DELAY_GAME rate suitable for games
`int`	SENSOR_DELAY_NORMAL rate (default) suitable for screen orientation changes
`int`	SENSOR_DELAY_UI rate suitable for the user interface
`int`	SENSOR_LIGHT This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_MAGNETIC_FIELD This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_MAX This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_MIN This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_ORIENTATION This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_ORIENTATION_RAW This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_PROXIMITY This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_STATUS_ACCURACY_HIGH This sensor is reporting data with maximum accuracy
`int`	SENSOR_STATUS_ACCURACY_LOW This sensor is reporting data with low accuracy, calibration with the environment is needed
`int`	SENSOR_STATUS_ACCURACY_MEDIUM This sensor is reporting data with an average level of accuracy, calibration with the environment may improve the readings
`int`	SENSOR_STATUS_NO_CONTACT The values returned by this sensor cannot be trusted because the sensor had no contact with what it was measuring (for example, the heart rate monitor is not in contact with the user).
`int`	SENSOR_STATUS_UNRELIABLE The values returned by this sensor cannot be trusted, calibration is needed or the environment doesn't allow readings
`int`	SENSOR_TEMPERATURE This constant was deprecated in API level 15. use Sensor instead.
`int`	SENSOR_TRICORDER This constant was deprecated in API level 15. use Sensor instead.
`float`	STANDARD_GRAVITY Standard gravity (g) on Earth.

#### Public methods
`boolean`	cancelTriggerSensor`(`TriggerEventListener`listener,`Sensor`sensor)` Cancels receiving trigger events for a trigger sensor.
SensorDirectChannel	createDirectChannel`(`MemoryFile`mem)` Create a sensor direct channel backed by shared memory wrapped in MemoryFile object.
SensorDirectChannel	createDirectChannel`(`HardwareBuffer`mem)` Create a sensor direct channel backed by shared memory wrapped in HardwareBuffer object.
`boolean`	flush`(`SensorEventListener`listener)` Flushes the FIFO of all the sensors registered for this listener.
`static float`	getAltitude`(float p0, float p)` Computes the Altitude in meters from the atmospheric pressure and the pressure at sea level.
`static void`	getAngleChange`(float[] angleChange, float[] R, float[] prevR)` Helper function to compute the angle change between two rotation matrices.
Sensor	getDefaultSensor`(int type)` Use this method to get the default sensor for a given type.
Sensor	getDefaultSensor`(int type, boolean wakeUp)` Return a Sensor with the given type and wakeUp properties.
List`<`Sensor`>`	getDynamicSensorList`(int type)` Use this method to get a list of available dynamic sensors of a certain type.
`static float`	getInclination`(float[] I)` Computes the geomagnetic inclination angle in radians from the inclination matrix I returned by getRotationMatrix(float, float, float, float).
`static float[]`	getOrientation`(float[] R, float[] values)` Computes the device's orientation based on the rotation matrix.
`static void`	getQuaternionFromVector`(float[] Q, float[] rv)` Helper function to convert a rotation vector to a normalized quaternion.
`static boolean`	getRotationMatrix`(float[] R, float[] I, float[] gravity, float[] geomagnetic)` Computes the inclination matrix I as well as the rotation matrix R transforming a vector from the device coordinate system to the world's coordinate system which is defined as a direct orthonormal basis, where: * X is defined as the vector product Y.Z (It is tangential to the ground at the device's current location and roughly points East).
`static void`	getRotationMatrixFromVector`(float[] R, float[] rotationVector)` Helper function to convert a rotation vector to a rotation matrix.
List`<`Sensor`>`	getSensorList`(int type)` Use this method to get the list of available sensors of a certain type.
`int`	getSensors`()` This method was deprecated in API level 15. This method is deprecated, use SensorManager.getSensorList(int) instead
`boolean`	isDynamicSensorDiscoverySupported`()` Tell if dynamic sensor discovery feature is supported by system.
`void`	registerDynamicSensorCallback`(`SensorManager.DynamicSensorCallback`callback)` Add a DynamicSensorCallback to receive dynamic sensor connection callbacks.
`void`	registerDynamicSensorCallback`(`SensorManager.DynamicSensorCallback`callback,`Handler`handler)` Add a DynamicSensorCallback to receive dynamic sensor connection callbacks.
`boolean`	registerListener`(`SensorEventListener`listener,`Sensor`sensor, int samplingPeriodUs)` Registers a SensorEventListener for the given sensor at the given sampling frequency.
`boolean`	registerListener`(`SensorEventListener`listener,`Sensor`sensor, int samplingPeriodUs, int maxReportLatencyUs)` Registers a SensorEventListener for the given sensor at the given sampling frequency and the given maximum reporting latency.
`boolean`	registerListener`(`SensorEventListener`listener,`Sensor`sensor, int samplingPeriodUs,`Handler`handler)` Registers a SensorEventListener for the given sensor.
`boolean`	registerListener`(`SensorListener`listener, int sensors)` This method was deprecated in API level 15. This method is deprecated, use SensorManager.registerListener(SensorEventListener, Sensor, int) instead.
`boolean`	registerListener`(`SensorListener`listener, int sensors, int rate)` This method was deprecated in API level 15. This method is deprecated, use SensorManager.registerListener(SensorEventListener, Sensor, int) instead.
`boolean`	registerListener`(`SensorEventListener`listener,`Sensor`sensor, int samplingPeriodUs, int maxReportLatencyUs,`Handler`handler)` Registers a SensorEventListener for the given sensor at the given sampling frequency and the given maximum reporting latency.
`static boolean`	remapCoordinateSystem`(float[] inR, int X, int Y, float[] outR)` Rotates the supplied rotation matrix so it is expressed in a different coordinate system.
`boolean`	requestTriggerSensor`(`TriggerEventListener`listener,`Sensor`sensor)` Requests receiving trigger events for a trigger sensor.
`void`	unregisterDynamicSensorCallback`(`SensorManager.DynamicSensorCallback`callback)` Remove a DynamicSensorCallback to stop sending dynamic sensor connection events to that callback.
`void`	unregisterListener`(`SensorEventListener`listener)` Unregisters a listener for all sensors.
`void`	unregisterListener`(`SensorEventListener`listener,`Sensor`sensor)` Unregisters a listener for the sensors with which it is registered.
`void`	unregisterListener`(`SensorListener`listener)` This method was deprecated in API level 15. This method is deprecated, use SensorManager.unregisterListener(SensorEventListener) instead.
`void`	unregisterListener`(`SensorListener`listener, int sensors)` This method was deprecated in API level 15. This method is deprecated, use SensorManager.unregisterListener(SensorEventListener, Sensor) instead.

| #### Inherited methods |
|------------------------|---|
| ||

Constants

AXIS_MINUS_X

Added in API level 3

java 复制代码

public static final int AXIS_MINUS_X

see remapCoordinateSystem(float, int, int, float)

Constant Value: 129 (0x00000081)

AXIS_MINUS_Y

Added in API level 3

java 复制代码

public static final int AXIS_MINUS_Y

see remapCoordinateSystem(float, int, int, float)

Constant Value: 130 (0x00000082)

AXIS_MINUS_Z

Added in API level 3

java 复制代码

public static final int AXIS_MINUS_Z

see remapCoordinateSystem(float, int, int, float)

Constant Value: 131 (0x00000083)

AXIS_X

Added in API level 3

java 复制代码

public static final int AXIS_X

see remapCoordinateSystem(float, int, int, float)

Constant Value: 1 (0x00000001)

AXIS_Y

Added in API level 3

java 复制代码

public static final int AXIS_Y

see remapCoordinateSystem(float, int, int, float)

Constant Value: 2 (0x00000002)

AXIS_Z

Added in API level 3

java 复制代码

public static final int AXIS_Z

see remapCoordinateSystem(float, int, int, float)

Constant Value: 3 (0x00000003)

DATA_X

Added in API level 1

Deprecated in API level 15

java 复制代码

public static final int DATA_X

This constant was deprecated in API level 15.

use Sensor instead.

Index of the X value in the array returned by

java 复制代码

SensorListener.onSensorChanged(int, float)

Constant Value: 0 (0x00000000)

DATA_Y

Added in API level 1

Deprecated in API level 15

java 复制代码

public static final int DATA_Y

This constant was deprecated in API level 15.

use Sensor instead.

Index of the Y value in the array returned by

java 复制代码

SensorListener.onSensorChanged(int, float)

Constant Value: 1 (0x00000001)

DATA_Z

Added in API level 1

Deprecated in API level 15

java 复制代码

public static final int DATA_Z

This constant was deprecated in API level 15.

use Sensor instead.

Index of the Z value in the array returned by

java 复制代码

SensorListener.onSensorChanged(int, float)

Constant Value: 2 (0x00000002)

GRAVITY_DEATH_STAR_I

Added in API level 1

java 复制代码

public static final float GRAVITY_DEATH_STAR_I

Gravity (estimate) on the first Death Star in Empire units (m/s^2)

Constant Value: 3.5303614E-7

GRAVITY_EARTH

Added in API level 1

java 复制代码

public static final float GRAVITY_EARTH

Earth's gravity in SI units (m/s^2)

Constant Value: 9.80665

GRAVITY_JUPITER

Added in API level 1

java 复制代码

public static final float GRAVITY_JUPITER

Jupiter's gravity in SI units (m/s^2)

Constant Value: 23.12

GRAVITY_MARS

Added in API level 1

java 复制代码

public static final float GRAVITY_MARS

Mars' gravity in SI units (m/s^2)

Constant Value: 3.71

GRAVITY_MERCURY

Added in API level 1

java 复制代码

public static final float GRAVITY_MERCURY

Mercury's gravity in SI units (m/s^2)

Constant Value: 3.7

GRAVITY_MOON

Added in API level 1

java 复制代码

public static final float GRAVITY_MOON

The Moon's gravity in SI units (m/s^2)

Constant Value: 1.6

GRAVITY_NEPTUNE

Added in API level 1

java 复制代码

public static final float GRAVITY_NEPTUNE

Neptune's gravity in SI units (m/s^2)

Constant Value: 11.0

GRAVITY_PLUTO

Added in API level 1

java 复制代码

public static final float GRAVITY_PLUTO

Pluto's gravity in SI units (m/s^2)

Constant Value: 0.6

GRAVITY_SATURN

Added in API level 1

java 复制代码

public static final float GRAVITY_SATURN

Saturn's gravity in SI units (m/s^2)

Constant Value: 8.96