Android 螢幕方向可在 聲明式(Manifest) 與 程式碼(Runtime) 兩個層面控制,適用場景不同:
<activity
android:name=".MainActivity"
android:screenOrientation="portrait" > <!-- 強制豎向 -->
<!-- 可選值:landscape(橫向) | sensor(跟隨感測器) | user(用戶偏好) | fullSensor | locked -->
</activity>
常用屬性值對照表:
| 值 | 行為 | 適用場景 |
|---|---|---|
portrait | 強制豎向 | 資訊流、表單、大多數業務頁 |
landscape | 強制橫向 | 遊戲、視頻播放器、地圖導航 |
sensor | 跟隨重力感測器自動旋轉 | 相機預覽、圖庫瀏覽 |
user | 遵循用戶系統設置(自動旋轉開關) | 通用頁面,尊重用戶習慣 |
fullSensor | 包含倒置的四向旋轉 | 桌面級應用、特殊硬件 |
locked | 鎖定當前方向(API 18+) | 臨時鎖定,如彈窗顯示期間 |
// Java
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE); // 強制橫向
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT); // 強制豎向
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR); // 恢復感測器控制
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED); // 交給系統預設
// Kotlin 擴展函數封裝
fun Activity.lockPortrait() = requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
fun Activity.lockLandscape() = requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
fun Activity.unlockOrientation() = requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED
class VideoPlayerActivity : AppCompatActivity() {
private val orientationListener = OrientationEventListener(this) { orientation ->
if (orientation == ORIENTATION_UNKNOWN) return@OrientationEventListener
val isLandscape = orientation in 170..190 || orientation in 350..360 || orientation in 0..10
// 業務邏輯:全屏播放時鎖定橫向,退出全屏恢復感測器
if (isFullScreen && !isLandscape) lockLandscape()
else if (!isFullScreen) unlockOrientation()
}
override fun onResume() {
super.onResume()
orientationListener.enable()
}
override fun onPause() {
orientationListener.disable()
super.onPause()
}
}
方向切換預設會 銷毀並重建 Activity(觸發 onDestroy → onCreate)。
onSaveInstanceState(Bundle) 保存臨時狀態,ViewModel 持久化業務數據。android:configChanges="orientation|screenSize|screenLayout",改由 onConfigurationChanged() 手動處理佈局切換(謹慎使用,易導致資源洩漏)。overridePendingTransition(R.anim.slide_in, R.anim.slide_out) 平滑切換。WindowInsetsController(API 30+)或 SYSTEM_UI_FLAG_FULLSCREEN。Android 12L+ 引入 WindowMetricsCalculator 與 Jetpack WindowManager,方向概念擴展為「窗口佈局變化」。建議遷移至 ActivityCompat.recreate() 配合 WindowSizeClass 響應式佈局,而非單純鎖定方向。
screenOrientation 靜態鎖定 ✅setRequestedOrientation() ✅user 或程式碼 UNSPECIFIED ✅ViewModel + onSaveInstanceState,避免 configChanges 硬抗 ✅「方向切換本質是 Configuration Change,核心難點不在『怎麼轉』,而在『怎麼保住狀態不丟、不閃、不崩』。」