Android 横竖屏处理的知识小结

Android 手机一般都支持横竖屏旋转,系统也会提供一个设置,控制允不允许旋转。这里对如何在 App 中控制界面的旋转方向做一个小结。

界面旋转方向的决定因素

决定一个界面显示为横屏/竖屏的因素有几个:

  • 系统的设置项,一般可以设置为只允许竖屏或可旋转切换。
  • 设备的物理传感器感应到的设备方向。
  • 不同 App 里的代码对横竖屏的设置。

需要注意的一点是,这三个因素没有固定的优先级。所以即使系统的设置项中设置了固定为竖屏,App 里的代码也可以将界面设置为横屏,当然影响的范围仅限于 App 内部界面。

代码中设置横竖屏的方法

我们有2种方法设置横竖屏:

  1. AndroidManifest.xml 文件中,对 <activity> 标签设置android:screenOrientation 属性,具体的值和作用见下文。
  2. 在 Java 中调用 Activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE),具体的值和作用见下文。

如果在 xml 中设置,则在初始化界面时就已经确定好其方向。而在如果 Java 中设置,则可以做到根据不同情况动态设置。

设置横竖屏时传入的值和作用

以下列出在 AndroidManifest.xml<activity> 标签的 android:screenOrientation 属性的可能的值。如果采用 Java 方式设置,参数与之一一对应。(参考 官方文档)

  • unspecified:默认值,不做任何指定,由系统来决定显示方向。这将由上一个 activity 来决定,或者当 activity 处于栈底时由用户设置的方向来决定。
  • landscape: 保持横屏。
  • portrait: 保持竖屏。
  • user: 用户当前设置的 orientation 值。
  • behide: 保持和上一个 Activity 的方向一致。
  • sensor: 完全根据物理传感器的方向来决定。注意用这个值时会忽略用户在系统设置中的旋转开关状态。(注意一般机器即使用这个值也不会支持竖屏旋转180度)
  • nosensor: 忽略物理传感器的方向。这将导致用户旋转手机时不会切换横竖屏。
  • sensorLandscape: 保持横屏,但可以根据物理传感器来决定横屏的方向。
  • sensorPortrait: 保持竖屏,但可以根据物理传感器来决定竖屏的方向。
  • reverseLandscape: 保持横屏,但方向与使用 landscape 时相反。
  • reversePortrait: 保持竖屏,但方向与使用 portrait 时相反。
  • fullSensor: 与 sensor 大致相同,区别在于这个属性会允许4个方向都可以旋转。
  • userLandscape: 保持横屏,但可以在用户允许旋转的情况下,根据物理传感器来决定横屏的方向。(注意与 sensorLandscape 对比)
  • userPortrait: 保持竖屏,但可以在用户允许旋转的情况下,根据物理传感器来决定竖屏的方向。(注意与 sensorPortrait 对比)
  • fullUser: 与 user 大致相同,区别在于如果用户允许旋转,这个属性允许4个方向都可以旋转。
  • locked: 屏幕方向会锁定在当前方向,不能再旋转。

该属性的值有很多,但一般比较常用的几个值也就几个:unspecified(允许旋转)、landscape(固定为横屏)、portrait(固定为竖屏)。而且一般我们只需要在 AndroidManifest.xml 中指定好固定的值就可以了。除非你对横竖屏切换有自己的一套逻辑,才需要在不同的逻辑下进行不同的设置。

横竖屏切换时引起的 Activity 重新创建

默认情况下,横竖屏切换会引起当前 Activity 销毁然后重新创建。所以我们可以在 Activity 重新创建时根据当前横竖屏状态做一些差异化。最常见的就是根据横竖屏采用不同的 layout xml。

  • res 目录下建立 layout-landlayout-port 目录,在不同目录下分别放一个同名的 layout xml 文件,然后在代码里正常使用这个 layout 文件,系统就会在横竖屏切换并重新创建 Activity 时自动使用对应的 layout 文件。如:

    1
    2
    3
    4
    5
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_layout);
    }
  • 如果不想通过创建多个 layout 文件来区分横竖屏布局,也可以用 Java 代码来做一些差异化,只要使用以下判断即可获取当前横竖屏的信息。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_layout);
    // 获取横竖屏信息
    int orientation = getResources().getConfiguration().orientation;
    if (orientation == Configuration.ORIENTATION_LANDSCAPE) {
    // 针对横屏做一些处理
    } else if (orientation == Configuration.ORIENTATION_PORTRAIT) {
    // 针对竖屏做一些处理
    }
    }

有一个点需要注意,关于 Activity 的生命周期被重新调用,有的资料说:

当不设置 Activity 的 android:configChanges 属性时,切到横屏时会重新执行一次生命周期,而切到竖屏时会执行两次。
如果设置了 android:configChanges="orientation" 属性,则都只会执行一次。

但是个人实验没有验证出这个说法。保险起见,可以加上 android:configChanges="orientation" 属性,确保生命周期只调用一次。

阻止横竖屏切换时 Activity 重启

虽然我们可以用上面的方法对横竖屏做不同的布局,但是横竖屏切换导致的 Activity 重新创建还会引起用户当前状态、数据的丢失。例如 EditText 中输入到一半的文字在 Activity 重新创建后会丢失。所以如果有办法能在旋转屏幕时不重新创建 Activity,应该是更好的一种选择。
我们可以在 AndroidManifest.xml 中为相应的 <activity> 设置android:configChanges 属性,让它不在横竖屏切换时引起 Activity 的重新创建。
Android 3.2(API Level 13)以前的 SDK 可以使用如下配置
android:configChanges="orientation|keyboardHidden"
而 Android 3.2 以后的 SDK 则需要设置为
android:configChanges="keyboardHidden|orientation|screenSize"
这样一来,横竖屏切换时 Activity 将不会重新创建。

横竖屏切换时的回调

一旦我们按照上述方法设置了 android:configChanges 属性,那么横竖屏切换时 Activity 将不会重新创建,那么当屏幕旋转时,我们在代码上怎么感知呢?可以通过 Override ActivityViewonConfigurationChanged 方法。

1
2
3
4
5
6
7
8
9
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE) {
// 针对横屏做一些处理
} else if (newConfig.orientation == Configuration.ORIENTATION_PORTRAIT){
// 针对竖屏做一些处理
}
}

判断当前屏幕方向

有了上面的横竖屏切换的回调,我们就可以及时感知到屏幕的状态变化。但因为竖屏、横屏都有两个不同的方向,所以 Android 系统又提供了方法给我们获取当前屏幕精确的旋转方向。

1
2
3
4
5
6
7
Display display = activity.getWindowManager().getDefaultDisplay();
int rotation = display.getRotation();
//
// rotation 的值表示了当前屏幕的旋转角度,可能的值有:
// Surface.ROTATION_0、Surface.ROTATION_90、
// Surface.ROTATION_180、Surface.ROTATION_270。
//

这样我们就可以判断当前屏幕的方向了。

举个例子,以下方法获取当前屏幕的旋转方向,然后将旋转方向锁定,使用户不能再旋转。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
public static void lockScreenOrientation(Activity activity) {
Display display = activity.getWindowManager().getDefaultDisplay();
switch (display.getRotation()) {
case Surface.ROTATION_90:
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
break;
case Surface.ROTATION_180:
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT);
break;
case Surface.ROTATION_270:
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE);
break;
default:
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
}
}

总结

  1. android:screenOrientation 属性可以控制 Activity 的方向,常用的值有 unspecified(默认,可旋转)、landscape(保持横屏)、portrait(保持竖屏)。
  2. 触发横竖屏切换时,如果希望 Activity 销毁并重新创建,则可以设置 Activity 的 android:configChanges="orientation"
  3. 触发横竖屏切换时,如果不希望 Activity 销毁并重新创建,可以设置 Activity 的 android:configChanges="keyboardHidden|orientation|screenSize"。此后横竖屏切换时,可以在 Activity.onConfigurationChangedView.onConfigurationChanged 方法中处理切换后的事情。
  4. 在任何时候可以用 getResources().getConfiguration().orientation 获取屏幕的横竖屏状态。
  5. 在任何时候可以用 activity.getWindowManager().getDefaultDisplay().getRotation() 获取屏幕的旋转角度。