萬盛學電腦網

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

Android 監聽螢幕旋轉 (橫豎屏切換) 完整實作指南

核心原理

預設情況下,螢幕旋轉會銷毀並重建 Activity (onDestroy → onCreate)。若需**自行處理旋轉不重建**,必須在 Manifest 宣告 configChanges 並覆寫 onConfigurationChanged()。

步驟 1:AndroidManifest.xml 宣告

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|screenSize|keyboardHidden">
</activity>

關鍵值:

  • orientation:螢幕方向變化
  • screenSize:API 13+ 必加,否則旋轉仍會重建
  • keyboardHidden:鍵盤彈出/收起 (可選)

步驟 2:Activity 覆寫 onConfigurationChanged

@Override
public void onConfigurationChanged(@NonNull Configuration newConfig) {
    super.onConfigurationChanged(newConfig);

    // 取得當前方向
    int orientation = newConfig.orientation;
    if (orientation == Configuration.ORIENTATION_LANDSCAPE) {
        // 📱 橫屏邏輯
        Log.d("Rotation", "切換至橫屏");
        // 例:切換佈局、調整 View 可見性、暫停/恢復視頻
    } else if (orientation == Configuration.ORIENTATION_PORTRAIT) {
        // 📱 直屏邏輯
        Log.d("Rotation", "切換至直屏");
    }
    // 注意:ORIENTATION_UNDEFINED 罕見,可忽略
}

進階:獲取螢幕尺寸變化

int newWidth = newConfig.screenWidthDp;
int newHeight = newConfig.screenHeightDp;
int smallestWidth = newConfig.smallestScreenWidthDp; // 較短邊 dp,適配平板/手機

常見誤區與避坑

  1. 忘記 screenSize:API 13+ 僅加 orientation 仍會重建。
  2. 在 onConfigurationChanged 做耗時操作:此方法在主執行緒,耗時會導致旋轉卡頓,僅做 UI 微調。
  3. 假設一定會觸發:若用戶鎖定螢幕旋轉 (系統設定/應用 android:screenOrientation),則不會觸發。
  4. ViewBinding/DataBinding 失效:旋轉不重建時,Binding 實例不會自動刷新,需手動 binding = ...inflate() 或改用 ViewStub 延遲載入。

替代方案:ViewModel + LiveData (現代架構)

若採用 ViewModel,旋轉重建**不會銷毀 ViewModel**,資料自動保留。只需在 XML 使用 tools:orientation 預覽,無需 configChanges,減少 Bug 面。建議新專案優先採用此架構。

測試技巧

  • 模擬器:Ctrl+F11 (Windows/Linux) / Cmd+F11 (Mac) 切換方向。
  • 真機:開發者選項 → 「自動旋轉」開啟,物理旋轉裝置。
  • ADB 指令:adb shell settings put system accelerometer_rotation 1 開啟自動旋轉。
copyright © 萬盛學電腦網 all rights reserved