如何通过编程判断Android/iOS设备是否放置于水平表面？

嘿，这个场景我之前帮好几个开发者梳理过，加速度计的微小波动确实容易干扰判断，不过结合传感器选择、滤波处理和辅助判断逻辑，完全能精准搞定。下面分Android和iOS平台给你具体的实现思路，都是经过实际验证的方案：

通用核心思路（跨平台） #

不管是Android还是iOS，核心都是先稳定传感器数据，再结合多维度条件判断：

• 优先使用系统预处理后的重力数据，而非原始加速度计，系统已经帮你做了滤波，波动小很多
• 加入滑动平均滤波进一步平滑数据，减少瞬时波动
• 结合「静止状态」+「水平姿态」双重判断，排除手持静止的情况
• 辅助触摸事件判断：应用使用时如果有用户触摸，大概率是手持状态，可直接跳过判定

Android 平台实现方案 #

1. 优先使用重力传感器（Sensor.TYPE_GRAVITY） #

重力传感器返回的是经过系统滤波的重力向量，比原始加速度计稳定太多。我们可以通过计算重力向量与Z轴的夹角来判断是否水平：

• 计算重力向量的模长：float magnitude = sqrt(gx*gx + gy*gy + gz*gz)
• 计算Z轴分量与模长的比值：float zRatio = gz / magnitude
• 当zRatio接近1时（比如大于0.98，对应夹角约11度，可根据测试调整），说明设备接近水平
• 同时判断静止：计算加速度的变化率，如果连续N个样本的变化都小于阈值（比如0.1m/s²），说明设备静止

代码示例片段：

private SensorManager sensorManager;
private Sensor gravitySensor;
private float[] lastGravity = new float[3];
private int sampleCount = 0;
private static final int SAMPLE_SIZE = 5;
private static final float Z_RATIO_THRESHOLD = 0.98f;
private static final float ACCEL_CHANGE_THRESHOLD = 0.1f;
private boolean isUserTouching = false;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
    gravitySensor = sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY);
}

@Override
protected void onResume() {
    super.onResume();
    sensorManager.registerListener(this, gravitySensor, SensorManager.SENSOR_DELAY_UI);
}

@Override
protected void onPause() {
    super.onPause();
    sensorManager.unregisterListener(this);
}

@Override
public void onSensorChanged(SensorEvent event) {
    if (event.sensor.getType() == Sensor.TYPE_GRAVITY && !isUserTouching) {
        // 滑动平均滤波
        lastGravity[0] = (lastGravity[0] * sampleCount + event.values[0]) / (sampleCount + 1);
        lastGravity[1] = (lastGravity[1] * sampleCount + event.values[1]) / (sampleCount + 1);
        lastGravity[2] = (lastGravity[2] * sampleCount + event.values[2]) / (sampleCount + 1);
        sampleCount = Math.min(sampleCount + 1, SAMPLE_SIZE);

        // 计算模长和Z轴比值
        float magnitude = (float) Math.sqrt(
            lastGravity[0] * lastGravity[0] +
            lastGravity[1] * lastGravity[1] +
            lastGravity[2] * lastGravity[2]
        );
        float zRatio = lastGravity[2] / magnitude;

        // 判断是否静止
        boolean isStatic = Math.abs(event.values[0] - lastGravity[0]) < ACCEL_CHANGE_THRESHOLD
                && Math.abs(event.values[1] - lastGravity[1]) < ACCEL_CHANGE_THRESHOLD
                && Math.abs(event.values[2] - lastGravity[2]) < ACCEL_CHANGE_THRESHOLD;

        // 双重条件：水平 + 静止
        if (zRatio > Z_RATIO_THRESHOLD && isStatic) {
            // 设备水平放置在表面
            handleDeviceOnSurface();
        }
    }
}

@Override
public boolean onTouchEvent(MotionEvent event) {
    switch (event.getAction()) {
        case MotionEvent.ACTION_DOWN:
            isUserTouching = true;
            break;
        case MotionEvent.ACTION_UP:
        case MotionEvent.ACTION_CANCEL:
            isUserTouching = false;
            break;
    }
    return super.onTouchEvent(event);
}

private void handleDeviceOnSurface() {
    // 处理放置状态的业务逻辑
}

iOS 平台实现方案 #

1. 使用CMMotionManager的DeviceMotion #

iOS的CMMotionManager提供的deviceMotion包含经过滤波的gravity和attitude数据，非常适合这个场景：

• 通过attitude.pitch和attitude.roll判断水平：当两者的绝对值都小于某个角度（比如0.087弧度，约5度），说明设备水平
• 通过userAcceleration判断静止：当三个轴的加速度绝对值都小于0.1m/s²时，说明设备没有受到用户的移动力

代码示例片段：

import CoreMotion

class ViewController: UIViewController {
    let motionManager = CMMotionManager()
    var isUserTouching = false
    static let angleThreshold: Double = 0.087 // 约5度
    static let accelerationThreshold: Double = 0.1

    override func viewDidLoad() {
        super.viewDidLoad()
        startMotionUpdates()
        setupTouchListener()
    }

    private func startMotionUpdates() {
        guard motionManager.isDeviceMotionAvailable else {
            print("Device motion not available")
            return
        }
        motionManager.deviceMotionUpdateInterval = 0.1 // 100ms间隔
        motionManager.startDeviceMotionUpdates(to: .main) { [weak self] motion, error in
            guard let self = self, let motion = motion, !self.isUserTouching else { return }

            // 判断水平姿态
            let isHorizontal = abs(motion.attitude.pitch) < Self.angleThreshold
                && abs(motion.attitude.roll) < Self.angleThreshold

            // 判断静止状态
            let isStatic = abs(motion.userAcceleration.x) < Self.accelerationThreshold
                && abs(motion.userAcceleration.y) < Self.accelerationThreshold
                && abs(motion.userAcceleration.z) < Self.accelerationThreshold

            if isHorizontal && isStatic {
                // 设备水平放置在表面
                self.handleDeviceOnSurface()
            }
        }
    }

    private func setupTouchListener() {
        let touchGesture = UIGestureRecognizer(target: self, action: #selector(handleTouch))
        view.addGestureRecognizer(touchGesture)
    }

    @objc private func handleTouch(_ gesture: UIGestureRecognizer) {
        isUserTouching = gesture.state == .began || gesture.state == .changed
    }

    private func handleDeviceOnSurface() {
        // 处理放置状态的业务逻辑
    }
}

额外优化建议 #

• 调整阈值：不同设备的传感器精度不同，建议在多款设备上测试，调整角度、加速度阈值，找到最适合的数值
• 延迟确认：不要单次检测到就判定，连续3-5次检测到符合条件再触发逻辑，避免瞬时波动导致误判
• 考虑设备方向：如果应用支持横竖屏，要注意Z轴的方向变化，可结合系统方向API调整判断逻辑

内容的提问来源于stack exchange，提问作者RossFe