如何锁定水平方向 Android

在 Android 应用程序中，有时需要锁定设备屏幕的水平方向，以提供更好的用户体验。例如，在播放视频或游戏时，我们通常希望屏幕始终保持横屏模式。

如何在 Android 应用程序中实现屏幕水平方向的锁定呢？下面我们将为您介绍两种实现方式。

方式一：使用 Android 系统提供的 API

Android 系统提供了 setRequestedOrientation() 方法，通过该方法可以锁定设备屏幕的方向。以下是示例代码：

// 锁定为横屏模式
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
// 锁定为竖屏模式
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);

需要注意的是，调用该方法后，屏幕方向将一直保持锁定状态，直到调用 setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED) 方法解除锁定。

方式二：监听设备方向变化

另一种解决方案是监听设备方向变化，并手动调整屏幕方向。这种方式可以更加灵活，但需要编写较多的代码。

首先，需要在清单文件中申明对加速度传感器和磁力传感器的使用权限：

<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-feature android:name="android.hardware.sensor.accelerometer" />
<uses-feature android:name="android.hardware.sensor.compass" />

然后，在代码中注册一个 SensorManager 实例，以监听加速度传感器和磁力传感器的数值变化：

private SensorManager sensorManager;
private Sensor accelerometerSensor;
private Sensor magneticSensor;
private boolean isHorizontalLocked = false;

// 在 onCreate() 方法中初始化传感器
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
accelerometerSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
magneticSensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);

在 onResume() 方法中注册传感器监听器：

sensorManager.registerListener(sensorEventListener, accelerometerSensor, SensorManager.SENSOR_DELAY_NORMAL);
sensorManager.registerListener(sensorEventListener, magneticSensor, SensorManager.SENSOR_DELAY_NORMAL);

在 onPause() 方法中取消注册：

sensorManager.unregisterListener(sensorEventListener, accelerometerSensor);
sensorManager.unregisterListener(sensorEventListener, magneticSensor);

最后，在监听回调函数 onSensorChanged() 中判断设备的方向，并手动调整屏幕方向：

private final float[] accelerometerValues = new float[3];
private final float[] magneticValues = new float[3];

private final SensorEventListener sensorEventListener = new SensorEventListener() {
    @Override
    public void onSensorChanged(SensorEvent event) {
        if (event.sensor.getType() == Sensor.TYPE_ACCELEROMETER) {
            System.arraycopy(event.values, 0, accelerometerValues, 0, 3);
        }
        if (event.sensor.getType() == Sensor.TYPE_MAGNETIC_FIELD) {
            System.arraycopy(event.values, 0, magneticValues, 0, 3);
        }
        float[] R = new float[9];
        float[] orientationValues = new float[3];
        SensorManager.getRotationMatrix(R, null, accelerometerValues, magneticValues);
        SensorManager.getOrientation(R, orientationValues);
        float x = orientationValues[0];
        float y = orientationValues[1];
        float z = orientationValues[2];
        // 判断设备方向是否为横屏模式，并调整屏幕方向
        if (Math.abs(Math.toDegrees(y)) > 45 && !isHorizontalLocked) {
            setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
            isHorizontalLocked = true;
        } else if (Math.abs(Math.toDegrees(y)) <= 45 && isHorizontalLocked) {
            setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR);
            isHorizontalLocked = false;
        }
    }
    @Override
    public void onAccuracyChanged(Sensor sensor, int accuracy) {}
};

需要注意的是，使用第二种方式需要在清单文件中声明 WAKE_LOCK 权限，以保证设备在屏幕方向变化时不会休眠：

<uses-permission android:name="android.permission.WAKE_LOCK" />

以上两种实现方式均可以实现 Android 应用程序中屏幕水平方向的锁定。您可以根据自己的需求和喜好选择适合自己的方式。