| 傳感器類型 | 常量 | 用途 | 數據單位 |
|---|---|---|---|
| 加速度計 | TYPE_ACCELEROMETER | 檢測設備加速度 (含重力) | m/s² |
| 重力傳感器 | TYPE_GRAVITY | 僅重力分量 (軟件融合) | m/s² |
| 線性加速度 | TYPE_LINEAR_ACCELERATION | 除重力外的運動加速度 | m/s² |
| 旋轉向量 | TYPE_ROTATION_VECTOR | 設備姿態 (四元數) | 無 |
| 方向傳感器 (已棄用) | TYPE_ORIENTATION | 方位角/俯仰/滾轉 | 度 |
推薦使用: TYPE_GRAVITY 獲取重力方向,TYPE_LINEAR_ACCELERATION 獲取運動加速度,TYPE_ROTATION_VECTOR 計算姿態角。避免直接使用原始加速度計做姿態計算。
public class SensorActivity extends AppCompatActivity
implements SensorEventListener {
private SensorManager sensorManager;
private Sensor gravitySensor;
private Sensor linearAccelSensor;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_sensor);
sensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
gravitySensor = sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY);
linearAccelSensor = sensorManager.getDefaultSensor(Sensor.TYPE_LINEAR_ACCELERATION);
}
@Override
protected void onResume() {
super.onResume();
// 註冊監聽,延遲模式:NORMAL (200ms), UI (60ms), GAME (20ms), FASTEST (0ms)
sensorManager.registerListener(this, gravitySensor, SensorManager.SENSOR_DELAY_UI);
sensorManager.registerListener(this, linearAccelSensor, SensorManager.SENSOR_DELAY_GAME);
}
@Override
protected void onPause() {
super.onPause();
sensorManager.unregisterListener(this); // 必須註銷,否則洩漏電量
}
@Override
public void onSensorChanged(SensorEvent event) {
float[] values = event.values.clone(); // 必須 clone,數組會被系統複用
switch (event.sensor.getType()) {
case Sensor.TYPE_GRAVITY:
// values[0]=x, [1]=y, [2]=z 重力分量
// 模長應約等於 9.81 m/s²
float g = (float) Math.sqrt(values[0]*values[0] + values[1]*values[1] + values[2]*values[2]);
updateGravityUI(values, g);
break;
case Sensor.TYPE_LINEAR_ACCELERATION:
// 運動加速度,可用於步數檢測、搖一搖、手勢識別
detectShake(values);
break;
}
}
@Override
public void onAccuracyChanged(Sensor sensor, int accuracy) {
// SENSOR_STATUS_UNRELIABLE, ACCURACY_LOW, MEDIUM, HIGH
}
private void detectShake(float[] linearAccel) {
double magnitude = Math.sqrt(
linearAccel[0]*linearAccel[0] +
linearAccel[1]*linearAccel[1] +
linearAccel[2]*linearAccel[2]);
if (magnitude > 15.0) { // 閾值經驗值
onShakeDetected();
}
}
}
// 使用旋轉向量傳感器 (融合加速度計+磁力計+陀螺儀,最穩定)
private Sensor rotationVectorSensor;
private float[] rotationMatrix = new float[16];
private float[] orientation = new float[3]; // azimuth, pitch, roll
@Override
public void onSensorChanged(SensorEvent event) {
if (event.sensor.getType() == Sensor.TYPE_ROTATION_VECTOR) {
// 旋轉向量轉旋轉矩陣
SensorManager.getRotationMatrixFromVector(rotationMatrix, event.values);
// 可選:重新映射坐標系 (如螢幕旋轉)
// SensorManager.remapCoordinateSystem(rotationMatrix,
// SensorManager.AXIS_X, SensorManager.AXIS_Z, rotationMatrix);
// 獲取姿態角 (弧度)
SensorManager.getOrientation(rotationMatrix, orientation);
float azimuth = (float) Math.toDegrees(orientation[0]); // 方位角 0-360
float pitch = (float) Math.toDegrees(orientation[1]); // 俯仰角 -180-180
float roll = (float) Math.toDegrees(orientation[2]); // 滾轉角 -90-90
updateOrientationUI(azimuth, pitch, roll);
}
}
原始傳感器數據抖動大,需低通濾波:
private static final float ALPHA = 0.8f; // 平滑因子 0-1,越大越平滑但延遲越高
private float[] gravityFiltered = new float[3];
private void lowPassFilter(float[] input, float[] output) {
for (int i = 0; i < 3; i++) {
output[i] = output[i] * ALPHA + input[i] * (1 - ALPHA);
}
}
// 在 onSensorChanged 中
lowPassFilter(event.values, gravityFiltered);
SENSOR_DELAY_UI (約 60ms),遊戲用 SENSOR_DELAY_GAME (約 20ms),後台監測用 SENSOR_DELAY_NORMAL (約 200ms)。sensorManager.registerListener(listener, sensor, samplingPeriodUs, maxReportLatencyUs),允許傳感器硬件 FIFO 緩存數據批量上報,大幅降低 CPU 喚醒次數。onPause() / onStop() 必須 unregisterListener。getDefaultSensor() 返回 null,需優雅降級 (隱藏功能、提示用戶)。