Expo ScreenOrientation

屏幕方向是指图形在设备上显示的方向。例如，下图显示的设备在垂直和水平的物理方向上，但屏幕方向为纵向。有关设备物理方向，请参阅 设备运动 的方向部分。

🌐 Screen Orientation is defined as the orientation in which graphics are painted on the device. For example, the figure below has a device in a vertical and horizontal physical orientation, but a portrait screen orientation. For physical device orientation, see the orientation section of Device Motion.

在 Android 和 iOS 平台上，屏幕方向的更改将覆盖任何系统设置或用户偏好。在 Android 上，可以在考虑用户首选方向的情况下更改屏幕方向。在 iOS 上，应用无法访问用户和系统设置，任何屏幕方向的更改都会覆盖现有设置。

🌐 On both Android and iOS platforms, changes to the screen orientation will override any system settings or user preferences. On Android, it is possible to change the screen orientation while taking the user's preferred orientation into account. On iOS, user and system settings are not accessible by the application and any changes to the screen orientation will override existing settings.

网络有有限支持。

安装

🌐 Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

警告

🌐 Warning

苹果在 iOS 9 中为 iPad 添加了对拆分视图模式的支持。这改变了系统处理屏幕方向的方式。简而言之，对于 iOS，除非你并排打开两个应用，否则你的 iPad 始终处于横向模式。要使用此模块锁定屏幕方向，你需要禁用对该功能的支持。有关拆分视图模式的更多信息，请查阅苹果官方文档。

🌐 Apple added support for split view mode to iPads in iOS 9. This changed how the screen orientation is handled by the system. To put the matter shortly, for iOS, your iPad is always in landscape mode unless you open two applications side by side. To be able to lock screen orientation using this module you will need to disable support for this feature. For more information about the split view mode, check out the official Apple documentation.

应用配置中的配置

🌐 Configuration in app config

如果你在项目中使用配置插件（连续原生生成 (CNG)），你可以使用其内置的 配置插件 来配置 expo-screen-orientation。该插件允许你配置一些无法在运行时设置的属性，这些属性需要构建新的应用二进制文件才能生效。如果你的应用不使用 CNG，那么你需要手动配置该库。

🌐 You can configure expo-screen-orientation using its built-in config plugin if you use config plugins in your project (Continuous Native Generation (CNG)). The plugin allows you to configure various properties that cannot be set at runtime and require building a new app binary to take effect. If your app does not use CNG, then you'll need to manually configure the library.

Example app.json with config plugin

{
  "expo": {
    "ios": {
      "requireFullScreen": true
    },
    "plugins": [
      [
        "expo-screen-orientation",
        {
          "initialOrientation": "DEFAULT"
        }
      ]
    ]
  }
}

Configurable properties

应用接口

🌐 API

import * as ScreenOrientation from 'expo-screen-orientation';

Methods

async function changeScreenOrientation() {
  await ScreenOrientation.lockAsync(ScreenOrientation.OrientationLock.LANDSCAPE_LEFT);
}

Event Subscriptions

Interfaces

Types

Enums