屏幕方向

Capacitor 应用中的屏幕方向

许多应用在纵向和横向设备方向下都能很好地工作。然而，许多应用并不是这样，有充分的理由要求应用仅以一种模式或偶尔以一种模式运行。

全局方向设置

要在 Capacitor 应用中设置全局方向设置，您需要为您的目标平台设置必要的配置值。

iOS 配置

iOS 允许在 iPhone 和 iPad 上支持不同的屏幕方向。要限制 iOS 允许的方向，请打开 Xcode 并打开 Info.plist 文件。查找以下键：Supported interface orientation 和 Supported interface orientation (iPad)。使用这些值，指定您希望为 iPhone 和 iPad 支持的不同方向。

如果直接编辑 Info.plist 文件，请查找以下键：UISupportedInterfaceOrientations 和 UISupportedInterfaceOrientations~ipad。例如，以下设置将 iPhone 上的方向限制为正向 Portrait，将 iPad 上的方向限制为任一 Landscape 方向：

  <key>UISupportedInterfaceOrientations</key>
  <array>
    <string>UIInterfaceOrientationPortrait</string>
  </array>
  <key>UISupportedInterfaceOrientations~ipad</key>
  <array>
    <string>UIInterfaceOrientationLandscapeRight</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
  </array>

Android 配置

在 Android 上，可以通过修改 AndroidManifest.xml 并在主应用活动的 <activity> 条目上设置 android:screenOrientation 来设置方向。有关可能条目的详细信息，请参阅 Android Manifest 文档。

动态方向设置

许多应用需要支持多个方向，并且能够根据内容偶尔锁定方向。

Capacitor 通过 @capacitor/screen-orientation 插件支持这一点：

npm install @capacitor/screen-orientation
npx cap sync

然后，使用 lock 和 unlock 方法：

import { ScreenOrientation } from '@capacitor/screen-orientation';
...
await ScreenOrientation.lock({ orientation: 'portrait' });
await ScreenOrientation.lock({ orientation: 'landscape' });

// 要解锁方向，将默认返回到全局设置：
await ScreenOrientation.unlock();

有关所有可能的方向值和配置选项的完整范围，请参阅 方向插件文档。

iPad 方向锁定

默认情况下，iPad 允许多任务处理，其方向无法被锁定。如果需要在 iPad 上锁定方向，请通过将以下内容添加到 Info.plist 来将选项 Requires Full Screen 设置为 YES：

	<key>UIRequiresFullScreen</key>
	<true/>