## Android 中禁用横屏模式的终极指南

### 介绍

在 Android 应用程序中，横屏模式通常被认为可以提供更身临其境的体验，尤其是在观看视频或玩游戏时。然而，在某些情况下，您可能需要禁用横屏模式，以确保应用程序始终以竖屏模式显示。这篇文章将详细介绍如何在 Android 中禁用横屏模式，并提供代码示例。

### 理解屏幕方向

Android 提供了多种屏幕方向选项，包括：

传感器（SENSOR）: 根据设备的物理方向自动调整屏幕方向。

竖屏（PORTRAIT）: 强制屏幕始终保持竖屏模式。

横屏（LANDSCAPE）: 强制屏幕始终保持横屏模式。

用户（USER）: 允许用户在设备设置中选择首选的方向。

### 禁用横屏模式

要禁用横屏模式，您需要在清单文件中声明应用程序的屏幕方向。在 AndroidManifest.xml 文件中，添加 android:screenOrientation 属性并将其设置为 portrait，如下所示：

...

android:screenOrientation="portrait"

...

这将强制应用程序始终以竖屏模式显示，无论设备的物理方向如何。

### 针对特定视图禁用横屏模式

有时，您可能只想禁用应用程序中某些视图的横屏模式。例如，您可能有一个文本输入视图，希望始终保持竖屏模式。要针对特定视图禁用横屏模式，可以使用 android:orientation 属性。

在布局文件中，为要禁用横屏模式的视图添加 android:orientation 属性并将其设置为 vertical，如下所示：

...

android:orientation="vertical"

...

>

### 代码示例

以下代码示例演示了如何通过代码禁用横屏模式：

val displayMetrics = windowManager.defaultDisplay.getMetrics(null)

val configuration = resources.configuration

configuration.orientation = Configuration.ORIENTATION_PORTRAIT

windowManager.defaultDisplay.setOrientation(Surface.ROTATION_0)

这将强制应用程序始终以竖屏模式显示，无论设备的物理方向如何。

### 常见问题解答

Q1：如何检查应用程序的当前屏幕方向？

A1：可以使用 getResources().getConfiguration().orientation 方法获取当前屏幕方向。

Q2：我可以根据用户的首选项禁用横屏模式吗？

A2：是的，您可以使用 android:configChanges="orientation|screenSize" 属性允许用户在设备设置中更改屏幕方向。

Q3：禁用横屏模式会影响所有设备吗？

A3：是的，在清单文件中设置的屏幕方向将适用于所有设备。

Q4：可以在运行时禁用横屏模式吗？

A4：是的，可以使用 setRequestedOrientation() 方法在运行时禁用横屏模式。

Q5：为什么我的应用程序在禁用横屏模式后仍然可以旋转？

A5：请确保在清单文件和布局文件中都正确设置了屏幕方向，并且没有其他因素（例如第三方库）正在影响屏幕方向。

### 结论

禁用横屏模式可以确保您的 Android 应用程序始终以所需的屏幕方向显示。通过使用清单文件或布局文件中的 android:screenOrientation 和 android:orientation 属性，您可以轻松控制应用程序的屏幕方向。本指南提供了清晰的分步说明和代码示例，帮助您根据需要禁用横屏模式。