根據裝置狀態自動旋轉的設定

對於摺疊式裝置，您可以根據裝置的實體狀態調整螢幕旋轉行為，進而提升使用者體驗。舉例來說，你可以設定裝置在展開成平板電腦時自動旋轉螢幕，但在摺疊時鎖定為直向。

從 Android 13 開始，Android 可根據裝置狀態 (例如折疊、展開或半折疊 (桌面模式)) 自訂自動旋轉設定。

圖 1：使用者看到的裝置狀態自動旋轉設定。

啟用根據裝置狀態自動旋轉的設定

如要啟用及設定根據裝置狀態自動旋轉螢幕，請為架構的 config.xml 檔案建立裝置疊加層，如下所示：

1. 如要為不同裝置姿勢設定預設自動旋轉行為，請在裝置的疊加層 config.xml 中填入 [config_perDeviceStateRotationLockDefaults][7] 整數陣列：

   <!-- In your device overlay, for example,
       device/generic/goldfish/phone/overlay/frameworks/base/core/res/res/values/config.xml -->
   <resources>
       <!-- Map of device posture to rotation lock setting. Each entry must be
           in the format "key:value", or "key:value:fallback_key" for example:
           "0:1" or "2:0:1". The keys are one of
           Settings.Secure.DeviceStateRotationLockKey, and the values are one of
           Settings.Secure.DeviceStateRotationLockSetting. -->
       <integer-array name="config_perDeviceStateRotationLockDefaults">
           <item>0:1</item> <!-- CLOSED -> LOCKED -->
           <item>1:0:2</item> <!-- HALF_OPENED -> IGNORED and fallback to
               device posture OPENED -->
           <item>2:2</item> <!-- OPENED -> UNLOCKED -->
           <item>3:0:0</item> <!-- REAR_DISPLAY -> IGNORED and fallback to
               device posture CLOSED -->
       </integer-array>
   </resources>
   

   fallback-key 是指其他裝置型態，您必須指定型態值為 Settings.Secure.DEVICE_STATE_ROTATION_LOCK_IGNORED 的時間。以這種方式設定姿勢時，任何取得或設定自動旋轉偏好的要求都會重新導向至備用姿勢。

   舉例來說，如果 HALF_OPENED 姿勢改回 OPENED 姿勢：

   • 讀取 HALF_OPENED 的自動旋轉設定會傳回 OPENED 的目前設定。
   • 在裝置HALF_OPENED更新時寫入新的自動旋轉偏好設定，會更新 OPENED 姿勢的偏好設定。

2. 為每個使用者可設定的裝置姿勢設定說明。在裝置的「設定」應用程式疊加層中填入 config_settableAutoRotationDeviceStatesDescriptions 字串陣列：

   <!-- In your device's Settings app overlay -->
   <resources>
       <!-- The settings/preference description for each settable device
           posture defined in the array
           "config_perDeviceStateRotationLockDefaults".
           The item in position "i" describes the auto-rotation setting for the
           device posture also in position "i" in the array
           "config_perDeviceStateRotationLockDefaults". -->
       <string-array name="config_settableAutoRotationDeviceStatesDescriptions">
           <item>Auto-rotate when folded</item>
           <item>@null</item> <!-- No description for state in position 1 (it
           is not settable by the user) -->
           <item>Auto-rotate when unfolded</item>
       </string-array>
   </resources>
   

3. 您必須使用正確的 API 以程式輔助方式修改這些設定，而不是直接寫入設定供應器，以免發生不一致的行為：

   • 如要變更目前的螢幕旋轉鎖定狀態 (修改 ACCELEROMETER_ROTATION)：

     • 從 SystemUI 或啟動器使用 [RotationPolicy#setRotationLock(...)][5]。
     • 在視窗管理員中，使用 DisplayRotation#freezeRotation() 或 thawRotation()。

   • 如要變更特定裝置狀態的螢幕旋轉鎖定偏好設定 (修改 DEVICE_STATE_ROTATION_LOCK)：

     • 使用 requestDeviceStateAutoRotateSettingChange(...)，來源可以是 RotationPolicy 或 [DeviceStateAutoRotateSettingManager][6]。

實作詳細資料

以下各節將說明控制可摺疊裝置自動旋轉行為的設定和核心鍵類別。

設定

系統會使用下列兩項設定管理自動旋轉功能：

• Settings.System.ACCELEROMETER_ROTATION：這是主要的自動旋轉設定。如果是摺疊式裝置，這個值會反映裝置目前的姿勢是否已啟用自動旋轉功能。

• Settings.Secure.DEVICE_STATE_ROTATION_LOCK：這項設定會儲存每個裝置型態 (例如摺疊或展開) 的自動旋轉偏好設定。這樣一來，系統就能在裝置姿勢改變時套用正確的偏好設定。

  這項設定會以半形冒號分隔字串的形式儲存。每對值代表裝置姿勢和對應的旋轉設定。格式為：

  <device_posture_0>:<rotation_value_0>:<device_posture_1>:<rotation_value_1>...

  輪替值如下：

  • 0：已忽略 (使用備用姿勢的設定)
  • 1：已鎖定 (自動旋轉已關閉)
  • 2：已解鎖 (自動旋轉已開啟)

  舉例來說，字串 "0:2:2:1" 的意義如下：

  • 在摺疊狀態 (姿勢 0) 下，自動旋轉功能會解鎖 (2)。
  • 在展開狀態 (姿勢 2) 下，自動旋轉功能會鎖定 (1)。

主要類別

下列類別會處理管理裝置狀態的自動旋轉設定的邏輯：

• [DeviceStateAutoRotateSettingManagerImpl][1]：管理 DEVICE_STATE_ROTATION_LOCK設定。這個類別提供更新設定、擷取設定值，以及註冊變更監聽器的相關方法。

• [DeviceStateAutoRotateSettingController (視窗管理員)][2]： 同步處理 ACCELEROMETER_ROTATION 和 DEVICE_STATE_ROTATION_LOCK。裝置姿勢改變時，系統會根據使用者對新狀態的偏好設定更新 ACCELEROMETER_ROTATION。這可確保 ACCELEROMETER_ROTATION 的任何變更都會儲存回 DEVICE_STATE_ROTATION_LOCK，以供目前的裝置姿勢使用；同樣地，目前姿勢的 DEVICE_STATE_ROTATION_LOCK 變更也會反映在 ACCELEROMETER_ROTATION 中。

• [DeviceStateAutoRotateSettingController (設定應用程式)][3]：在裝置狀態的自動旋轉設定頁面中控制 UI。

• PostureDeviceStateConverter：在一般裝置狀態 ID 和這項功能使用的裝置型態 ID 之間轉換。

驗證

由於這項功能的行為高度取決於原始設備製造商 (OEM) 的設定，因此沒有專屬的 CTS 測試。您必須執行手動測試，確認裝置在您設定的不同實體狀態之間轉換時，自動旋轉設定會如預期變更。

[1]：https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/packages/SettingsLib/DeviceStateRotationLock/src/com/android/settingslib/devicestate/DeviceStateAutoRotateSettingManagerImpl.java [2]：https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/services/core/java/com/android/server/wm/DeviceStateAutoRotateSettingController.java [3]：https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/apps/Settings/src/com/android/settings/display/DeviceStateAutoRotateSettingController.java [4]：https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/core/java/android/provider/Settings.java [5]：https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/core/java/com/android/internal/view/RotationPolicy.java;bpv=0 [6]：https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/packages/SettingsLib/DeviceStateRotationLock/src/com/android/settingslib/devicestate/DeviceStateAutoRotateSettingManager.java [7]：https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/apps/Settings/res/values/config.xml;l=674;drc=485b59a37c1cd0af72ca706e0ba1094f4e7fef0e;l=674