屏幕方向 是对Activity而言的,所以你可以在AndroidManifest.xml 文件中,通过<activity> 标记的screenOrientation 属性进行设定,例如:
- <activity
- android:name=".SketchpadActivity"
- android:screenOrientation="landscape"/>
screenOrientations属性共有7中可选值(常量定义在 android.content.pm.ActivityInfo类中 ) :
- landscape:横屏(风景照) ,显示时宽度大于高度;
- portrait:竖屏 (肖像照) , 显示时 高 度大于 宽 度 ;
- user:用户当前的首选方向;
- behind:继承Activity堆栈中当前Activity下面的那个Activity的方向;
- sensor:由物理感应器决定显示方向,它取决于用户如何持有设备,当 设备 被旋转时方向会随之变化——在横屏与竖屏之间;
- nosensor:忽略物理感应器——即显示方向与物理感应器无关,不管用户如何旋转设备显示方向都不会随着改变("unspecified"设置除外);
- unspecified :未指定,此为默认值,由Android系统自己选择适当的方向,选择策略视具体设备的配置情况而定,因此不同的设备会有不同的方向选择;
以上配置值会反映在Activity.getRequestedOrientation()方法的返回值中,与之对应的setRequestedOrientation()方法可以通过API的方式动态改变该属性的值,如以下示例将在横屏/竖屏两个方向上进行切换:
- public void apiChangeOrientation() {
-
- int orient = getRequestedOrientation();
- Logger.get().i("orientation:" + MyUtils.getOrientationName(orient));
-
-
-
- if (orient != ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
- && orient != ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) {
-
- int[] size = MyUtils.getDisplaySize(this);
- orient = size[0] < size[1] ? ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
- : ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE;
- Logger.get().i("w/h:" + MyUtils.getOrientationName(orient));
- }
-
- if (orient == ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) {
- setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
- }else{
- setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
- }
- }
通过setRequestedOrientation(xxx)方法设置与在 AndroidManifest.xml文件中配置是等效的,因此通过以上例程明确指定方向后,Activity将不再自动根据物理传感器进行横竖屏切 换,若要恢复,再调用setRequestedOrientation(UNSPECIFIED)即可。
另外, 还可以通过Configuration对象来取得Activity当前的显示方向:
- Configuration conf = getResources().getConfiguration();
- String orientName = "undefined";
- switch (orient) {
- case Configuration.ORIENTATION_LANDSCAPE:
- orientName = "landscape";
- case Configuration.ORIENTATION_PORTRAIT:
- orientName = "portrait";
- case Configuration.ORIENTATION_SQUARE:
- orientName = "square";
- default:
- orientName = "undefined";
- }
- Logger.get().i("conf.orient:" + orientName);
需要注意的是两者(ActivityInfo和Configuration)有关方向的常量定义是不一致的,ActivityInfo中有关常量是用于决策显示方向的策略,而Configuration对象中的常量则是明确的 实际 显示方向,共有4中可能:未定义(UNDEFINED) 、横屏 (LANDSCAPE) 、竖屏 (PORTRAIT) 、以及正方形 (SQUARE) 。
最后来看看,如何在程序中捕获显示方向改变的事件,这得从Activity.onConfigurationChanged方法说起。
Android系统会根据设备的配置变化(如屏幕方向的变化)来重新加载不同的资源文件(如 布局 layout资源),它会通过终止并重启Activity来实现 资源 的 重新加载。如果我们向其申明要自己处理(某些) 配置变化,则必须自己负责相关资源的重新加载——也就是说目标Activity不会在 (某些) 配置变化时,再经历 终止并重启的过程了。
我们关注显示方向的变化,需要在Activity申明时指定configChanges属性等于orientation,示例如下:
- <activity
- android:name=".MyActivity"
- android:configChanges="orientation"
- android:label="@string/app_name"/>
事实上configChanges属性还有:fontScale(用户首先字体大小改变)、locale(用户的语言环境设定改变)、keyboard(键盘类型改变)等多种可选值 。
然后再覆写 Activity. onConfigurationChanged 方法, 例如:
- public void onConfigurationChanged(Configuration conf) {
-
-
- }
这样当屏幕方向改变时以上方法会被回调。需要再次强调的是,只有在configChanges中指定的配置项发生变化时才会回调onConfigurationChanged,因此上面的方法仅在屏幕方向(orientation)发生变化时被回调。