screenOrientation/Configuration

屏幕方向 是对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() {
// 取得当前屏幕方向
int orient = 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) {
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) {
//super.onConfigurationChanged(conf);
//TODO:YOU Process...
}

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