【Orientation】详解Android中的屏幕方向

屏幕方向是对Activity而言的，所以你可以在AndroidManifest.xml文件中，通过<activity>标记的screenOrientation属性进行设定，例如：

<activity
    android:name=".SketchpadActivity"
    android:screenOrientation="landscape"/><!--让该Activity总是显示为横屏-->

 

screenOrientations属性共有7中可选值(常量定义在 android.content.pm.ActivityInfo类中 )：
landscape：横屏(风景照)，显示时宽度大于高度；
portrait：竖屏 (肖像照)，显示时高度大于宽度；
user：用户当前的首选方向；
behind：继承Activity堆栈中当前Activity下面的那个Activity的方向；
sensor：由物理感应器决定显示方向，它取决于用户如何持有设备，当设备被旋转时方向会随之变化——在横屏与竖屏之间；
nosensor：忽略物理感应器——即显示方向与物理感应器无关，不管用户如何旋转设备显示方向都不会随着改变("unspecified"设置除外)；
unspecified：未指定，此为默认值，由Android系统自己选择适当的方向，选择策略视具体设备的配置情况而定，因此不同的设备会有不同的方向选择；
以上配置值会反映在Activity.getRequestedOrientation()方法的返回值中，与之对应的setRequestedOrientation()方法可以通过API的方式动态改变该属性的值，如以下示例将在横屏/竖屏两个方向上进行切换：

/*
 * 通过API动态改变当前屏幕的显示方向
 */
public void apiChangeOrientation() {
    // 取得当前屏幕方向
    intorient = getRequestedOrientation();
    Logger.get().i("orientation:"+ MyUtils.getOrientationName(orient));
 
    // 若非明确的landscape或portrait时 再透过宽高比例的方法来确认实际显示方向
    // 这会保证orient最终值会是明确的横屏landscape或竖屏portrait
    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对象 确认当前显示方向
Configuration conf = getResources().getConfiguration();
String orientName ="undefined";
switch (orient) {
    caseConfiguration.ORIENTATION_LANDSCAPE:
        orientName ="landscape";
    caseConfiguration.ORIENTATION_PORTRAIT:
        orientName ="portrait";
    caseConfiguration.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) {
    //super.onConfigurationChanged(conf);
    //TODO:YOU Process...
}

这样当屏幕方向改变时以上方法会被回调。需要再次强调的是，只有在configChanges中指定的配置项发生变化时才会回调onConfigurationChanged，因此上面的方法仅在屏幕方向(orientation)发生变化时被回调。