萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 重力感應器 (加速度傳感器) 開發實戰指南

傳感器基礎

傳感器類型常量用途數據單位
加速度計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 計算姿態角。避免直接使用原始加速度計做姿態計算。

核心 API 使用流程

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);

性能與電量優化

  • 選擇合適延遲: UI 交互用 SENSOR_DELAY_UI (約 60ms),遊戲用 SENSOR_DELAY_GAME (約 20ms),後台監測用 SENSOR_DELAY_NORMAL (約 200ms)。
  • 批次上報 (Batch Mode, API 19+): sensorManager.registerListener(listener, sensor, samplingPeriodUs, maxReportLatencyUs),允許傳感器硬件 FIFO 緩存數據批量上報,大幅降低 CPU 喚醒次數。
  • 取消註冊: onPause() / onStop() 必須 unregisterListener。
  • 避免在 onSensorChanged 做耗時操作: 運行在 Sensor 線程 (非主線程),但仍應快速返回,複雜計算拋給工作線程。

兼容性與測試

  • 模擬器模擬傳感器:Extended Controls → Virtual sensors → 旋轉/移動設備模型。
  • 無傳感器設備:getDefaultSensor() 返回 null,需優雅降級 (隱藏功能、提示用戶)。
  • 不同廠商校準差異:同樣代碼在不同手機上閾值可能需調整,建議提供校準界面或自適應閾值算法。
copyright © 萬盛學電腦網 all rights reserved