Android 手机一般都支持横竖屏旋转,系统也会提供一个设置,控制允不允许旋转。这里对如何在 App 中控制界面的旋转方向做一个小结。
界面旋转方向的决定因素
决定一个界面显示为横屏/竖屏的因素有几个:
- 系统的设置项,一般可以设置为只允许竖屏或可旋转切换。
- 设备的物理传感器感应到的设备方向。
- 不同 App 里的代码对横竖屏的设置。
需要注意的一点是,这三个因素没有固定的优先级。所以即使系统的设置项中设置了固定为竖屏,App 里的代码也可以将界面设置为横屏,当然影响的范围仅限于 App 内部界面。
代码中设置横竖屏的方法
我们有2种方法设置横竖屏:
- 在
AndroidManifest.xml
文件中,对<activity>
标签设置android:screenOrientation
属性,具体的值和作用见下文。 - 在 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-land
和layout-port
目录,在不同目录下分别放一个同名的 layout xml 文件,然后在代码里正常使用这个 layout 文件,系统就会在横竖屏切换并重新创建 Activity 时自动使用对应的 layout 文件。如:@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_layout); }
-
如果不想通过创建多个 layout 文件来区分横竖屏布局,也可以用 Java 代码来做一些差异化,只要使用以下判断即可获取当前横竖屏的信息。
@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 Activity
和 View
的 onConfigurationChanged
方法。
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE) {
// 针对横屏做一些处理
} else if (newConfig.orientation == Configuration.ORIENTATION_PORTRAIT){
// 针对竖屏做一些处理
}
}
判断当前屏幕方向
有了上面的横竖屏切换的回调,我们就可以及时感知到屏幕的状态变化。但因为竖屏、横屏都有两个不同的方向,所以 Android 系统又提供了方法给我们获取当前屏幕精确的旋转方向。
Display display = activity.getWindowManager().getDefaultDisplay();
int rotation = display.getRotation();
//
// rotation 的值表示了当前屏幕的旋转角度,可能的值有:
// Surface.ROTATION_0、Surface.ROTATION_90、
// Surface.ROTATION_180、Surface.ROTATION_270。
//
这样我们就可以判断当前屏幕的方向了。
举个例子,以下方法获取当前屏幕的旋转方向,然后将旋转方向锁定,使用户不能再旋转。
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);
}
}
总结
-
android:screenOrientation
属性可以控制 Activity 的方向,常用的值有unspecified
(默认,可旋转)、landscape
(保持横屏)、portrait
(保持竖屏)。 - 触发横竖屏切换时,如果希望 Activity 销毁并重新创建,则可以设置 Activity 的
android:configChanges="orientation"
。 - 触发横竖屏切换时,如果不希望 Activity 销毁并重新创建,可以设置 Activity 的
android:configChanges="keyboardHidden|orientation|screenSize"
。此后横竖屏切换时,可以在Activity.onConfigurationChanged
或View.onConfigurationChanged
方法中处理切换后的事情。 - 在任何时候可以用
getResources().getConfiguration().orientation
获取屏幕的横竖屏状态。 - 在任何时候可以用
activity.getWindowManager().getDefaultDisplay().getRotation()
获取屏幕的旋转角度。