萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 動態切換螢幕方向:Manifest 設定與程式碼控制全解析

核心概念:兩種控制層級

Android 螢幕方向可在 聲明式(Manifest) 與 程式碼(Runtime) 兩個層面控制,適用場景不同:

  • Manifest 靜態鎖定:App 整體或特定 Activity 強制豎向/橫向,適合遊戲、閱讀器等單一模式場景。
  • 程式碼動態切換:根據用戶操作、感測器、業務邏輯即時切換,如拍照預覽、視頻全屏播放。

一、AndroidManifest.xml 靜態配置

<activity
    android:name=".MainActivity"
    android:screenOrientation="portrait" > <!-- 強制豎向 -->
    <!-- 可選值:landscape(橫向) | sensor(跟隨感測器) | user(用戶偏好) | fullSensor | locked -->
</activity>

常用屬性值對照表:

值行為適用場景
portrait強制豎向資訊流、表單、大多數業務頁
landscape強制橫向遊戲、視頻播放器、地圖導航
sensor跟隨重力感測器自動旋轉相機預覽、圖庫瀏覽
user遵循用戶系統設置(自動旋轉開關)通用頁面,尊重用戶習慣
fullSensor包含倒置的四向旋轉桌面級應用、特殊硬件
locked鎖定當前方向(API 18+)臨時鎖定,如彈窗顯示期間

二、Java/Kotlin 程式碼動態切換

1. 基礎 API(Activity 方法)

// 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

2. 進階:配合感測器與生命週期

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 持久化業務數據。
  • 禁止重建:在 Manifest 添加 android:configChanges="orientation|screenSize|screenLayout",改由 onConfigurationChanged() 手動處理佈局切換(謹慎使用,易導致資源洩漏)。

🎯 體驗優化細節

  • 過渡動畫:overridePendingTransition(R.anim.slide_in, R.anim.slide_out) 平滑切換。
  • 狀態恢復:RecyclerView 位置、WebView 進度、輸入框光標需手動恢復。
  • 系統欄適配:橫向時隱藏狀態欄/導航欄 WindowInsetsController(API 30+)或 SYSTEM_UI_FLAG_FULLSCREEN。

📱 折疊屏/多窗口時代的新挑戰

Android 12L+ 引入 WindowMetricsCalculator 與 Jetpack WindowManager,方向概念擴展為「窗口佈局變化」。建議遷移至 ActivityCompat.recreate() 配合 WindowSizeClass 響應式佈局,而非單純鎖定方向。

四、快速決策流程圖

  1. 頁面是否永遠只需單一方向? → Manifest screenOrientation 靜態鎖定 ✅
  2. 需根據業務狀態(全屏/退出、拍照/預覽)切換? → 程式碼 setRequestedOrientation() ✅
  3. 需跟隨用戶系統設置(自動旋轉開關)? → Manifest user 或程式碼 UNSPECIFIED ✅
  4. 涉及複雜狀態保存(表單、地圖、WebView)? → 優先 ViewModel + onSaveInstanceState,避免 configChanges 硬抗 ✅
「方向切換本質是 Configuration Change,核心難點不在『怎麼轉』,而在『怎麼保住狀態不丟、不閃、不崩』。」
copyright © 萬盛學電腦網 all rights reserved