開發應用程序

以下材料適用於應用程序開發人員。

要使您的應用支持輪播，您必須：

1. 在相應的活動佈局中放置一個FocusParkingView 。
2. 確保視圖是（或不是）可聚焦的。
3. 使用FocusArea環繞所有可聚焦的視圖，除了FocusParkingView 。

在您設置好環境以開發支持旋轉的應用程序之後，這些任務中的每一項都將在下面詳細介紹。

設置旋轉控制器

在開始開發支持旋轉的應用程序之前，您需要一個旋轉控制器或一個替身。您有以下描述的選項。

模擬器

source build/envsetup.sh && lunch car_x86_64-userdebug
m -j
emulator -wipe-data -no-snapshot -writable-system

您也可以使用aosp_car_x86_64-userdebug 。

要訪問模擬旋轉控制器：

1. 點擊工具欄底部的三個點：
   
   

   

   圖 1. Access 仿真旋轉控制器

2. 在擴展控制窗口中選擇汽車旋轉：
   
   

   

   圖 2.選擇汽車旋轉

USB 鍵盤

• 將 USB 鍵盤插入運行 Android Automotive OS (AAOS) 的設備，在某些情況下，這可能會阻止屏幕鍵盤出現。
• 使用userdebug或eng build。
• 啟用關鍵事件過濾：

  adb shell settings put secure android.car.ROTARY_KEY_EVENT_FILTER 1
  

• 請參閱下表以找到每個操作的對應鍵：

  鑰匙	旋轉動作
  問	逆時針旋轉
  乙	順時針旋轉
  一個	向左輕推
  D	向右輕推
  W	向上輕推
  小號	向下輕推
  F 或逗號	中心按鈕
  R 或 Esc	返回鍵

亞行命令

您可以使用car_service命令注入旋轉輸入事件。這些命令可以在運行 Android Automotive OS (AAOS) 的設備或模擬器上運行。

car_service 命令	旋轉輸入
adb shell cmd car_service inject-rotary	逆時針旋轉
adb shell cmd car_service inject-rotary -c true	順時針旋轉
adb shell cmd car_service inject-rotary -dt 100 50	逆時針旋轉多次（100 毫秒前和 50 毫秒前）
adb shell cmd car_service inject-key 282	向左輕推
adb shell cmd car_service inject-key 283	向右輕推
adb shell cmd car_service inject-key 280	向上輕推
adb shell cmd car_service inject-key 281	向下輕推
adb shell cmd car_service inject-key 23	中心按鈕單擊
adb shell input keyevent inject-key 4	後退按鈕單擊

OEM旋轉控制器

當您的旋轉控制器硬件啟動並運行時，這是最現實的選擇。它對於測試快速旋轉特別有用。

焦點停車視圖

FocusParkingView是Car UI 庫 (car-ui-library)中的一個透明視圖。 RotaryService使用它來支持旋轉控制器導航。 FocusParkingView必須是佈局中的第一個可聚焦視圖。它必須放在所有FocusArea之外。每個窗口必須有一個FocusParkingView 。如果您已經在使用包含FocusParkingView的 car-ui-library 基本佈局，則無需添加另一個FocusParkingView 。下面顯示的是FocusParkingView中的RotaryPlayground 。

<FrameLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent">
   <com.android.car.ui.FocusParkingView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"/>
   <FrameLayout
       android:layout_width="match_parent"
       android:layout_height="match_parent"/>
</FrameLayout>

以下是您需要FocusParkingView的原因：

1. 在另一個窗口中設置焦點時，Android 不會自動清除焦點。如果您嘗試清除前一個窗口中的焦點，Android 會重新聚焦該窗口中的視圖，這會導致兩個窗口同時被聚焦。給每個窗口添加一個FocusParkingView可以解決這個問題。這個視圖是透明的，並且它的默認焦點突出顯示被禁用，因此無論是否聚焦，它對用戶都是不可見的。它可以獲取焦點，以便RotaryService可以將焦點停在其上以移除焦點突出顯示。
2. 如果當前窗口中只有一個FocusArea ，則旋轉RotaryService FocusArea焦點從右側視圖移動到左側視圖（反之亦然）。將此視圖添加到每個窗口可以解決此問題。當RotaryService確定焦點目標是FocusParkingView時，它可以確定即將發生環繞，此時它通過不移動焦點來避免環繞。
3. 當旋轉控件啟動應用程序時，Android 會聚焦第一個可聚焦視圖，它始終是FocusParkingView 。 FocusParkingView確定要關注的最佳視圖，然後應用焦點。

可聚焦的視圖

RotaryService建立在 Android 框架現有的視圖焦點概念之上，可以追溯到手機有物理鍵盤和方向鍵的時候。現有的android:nextFocusForward屬性重新用於旋轉（請參閱FocusArea 自定義），但android:nextFocusLeft 、 android:nextFocusRight 、 android:nextFocusUp和android:nextFocusDown不是。

RotaryService只關注可聚焦的視圖。某些視圖，例如Button ，通常是可聚焦的。其他的，例如TextView s 和ViewGroup s，通常不是。可點擊的視圖會自動獲得焦點，並且當視圖有點擊監聽器時會自動點擊。如果此自動邏輯導致所需的可聚焦性，則無需顯式設置視圖的可聚焦性。如果自動邏輯沒有產生所需的可聚焦性，請將android:focusable focusable 屬性設置為true或false ，或者使用View.setFocusable(boolean)以編程方式設置視圖的可聚焦性。要讓RotaryService專注於它，視圖必須滿足以下要求：

• 可聚焦
• 啟用
• 可見的
• 寬度和高度具有非零值

如果視圖不滿足所有這些要求，例如可聚焦但禁用的 Button，則用戶無法使用旋轉控件對其進行聚焦。如果您想關注禁用的視圖，請考慮使用自定義狀態而不是android:state_enabled來控制視圖的顯示方式，而不指示 Android 應該將其視為禁用。您的應用程序可以通知用戶為什麼在點擊時視圖被禁用。下一節將解釋如何執行此操作。

自定義狀態

添加自定義狀態：

1. 將自定義屬性添加到您的視圖。例如，要將state_rotary_enabled自定義狀態添加到CustomView視圖類，請使用：

   <declare-styleable name="CustomView">
       <attr name="state_rotary_enabled" format="boolean" />
   </declare-styleable>
   

2. 要跟踪此狀態，請在視圖中添加一個實例變量以及訪問器方法：

   private boolean mRotaryEnabled;
   public boolean getRotaryEnabled() { return mRotaryEnabled; }
   public void setRotaryEnabled(boolean rotaryEnabled) {
       mRotaryEnabled = rotaryEnabled;
   }
   

3. 在創建視圖時讀取屬性值：

   TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.CustomView);
   mRotaryEnabled = a.getBoolean(R.styleable.CustomView_state_rotary_enabled);
   

4. 在您的視圖類中，覆蓋onCreateDrawableState()方法，然後在適當的時候添加自定義狀態。例如：

   @Override
   protected int[] onCreateDrawableState(int extraSpace) {
       if (mRotaryEnabled) extraSpace++;
       int[] drawableState = super.onCreateDrawableState(extraSpace);
       if (mRotaryEnabled) {
           mergeDrawableStates(drawableState, { R.attr.state_rotary_enabled });
       }
       return drawableState;
   }
   

5. 使視圖的單擊處理程序根據其狀態執行不同的操作。例如，當mRotaryEnabled為false時，單擊處理程序可能什麼都不做，或者它可能會彈出一個 toast。
6. 要使按鈕顯示為禁用，請在視圖的背景可繪製對像中使用app:state_rotary_enabled而不是android:state_enabled 。如果您還沒有，則需要添加：

   xmlns:app="http://schemas.android.com/apk/res-auto"
   

7. 如果您的視圖在任何佈局中被禁用，請將android:enabled="false"替換為app:state_rotary_enabled="false" ，然後添加app命名空間，如上所述。
8. 如果您的視圖以編程方式被禁用，請將對setEnabled()的調用替換為對setRotaryEnabled()的調用。

重點地區

使用FocusAreas將可聚焦視圖劃分為塊，以使導航更容易並與其他應用程序保持一致。例如，如果您的應用程序有一個工具欄，則該工具欄應該與您的應用程序的其餘部分位於一個單獨的FocusArea中。標籤欄和其他導航元素也應該與應用程序的其餘部分分開。大型列表通常應該有自己的FocusArea 。如果沒有，用戶必須輪流瀏覽整個列表才能訪問某些視圖。

FocusArea是 car-ui-library 中LinearLayout的子類。啟用此功能後， FocusArea將在其後代之一被聚焦時突出顯示。要了解更多信息，請參閱Focus 突出顯示自定義。

在佈局文件中創建導航塊時，如果您打算使用LinearLayout作為該塊的容器，請改用FocusArea 。否則，將塊包裝在FocusArea中。

不要將FocusArea嵌套在另一個FocusArea FocusArea 。這樣做會導致未定義的導航行為。確保所有可聚焦的視圖都嵌套在FocusArea中。

FocusArea中的RotaryPlayground示例如下所示：

<com.android.car.ui.FocusArea
       android:layout_margin="16dp"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:orientation="vertical">
       <EditText
           android:layout_width="match_parent"
           android:layout_height="wrap_content"
           android:singleLine="true">
       </EditText>
   </com.android.car.ui.FocusArea>

FocusArea工作原理如下：

1. 在處理旋轉和微調動作時， RotaryService在視圖層次結構中查找FocusArea的實例。
2. 當接收到一個旋轉事件時， RotaryService將焦點移動到另一個可以在同一個FocusArea中獲得焦點的 View。
3. 當接收到一個微調事件時， RotaryService將焦點移動到另一個視圖，該視圖可以在另一個（通常是相鄰的） FocusArea中獲得焦點。

如果您的佈局中不包含任何FocusAreas ，則根視圖將被視為隱式焦點區域。用戶無法輕推以在應用程序中導航。相反，它們將在所有可聚焦的視圖中旋轉，這對於對話框來說可能已經足夠了。

焦點區域定制

兩個標準視圖屬性可用於自定義旋轉導航：

• android:nextFocusForward允許應用程序開發人員指定焦點區域中的旋轉順序。這與用於控制鍵盤導航的 Tab 順序的屬性相同。不要使用此屬性來創建循環。相反，使用app:wrapAround （見下文）創建一個循環。
• android:focusedByDefault允許應用開發者在窗口中指定默認的焦點視圖。不要在同一個FocusArea中使用此屬性和app:defaultFocus （見下文）。

FocusArea還定義了一些屬性來自定義旋轉導航。無法使用這些屬性自定義隱式焦點區域。

1. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   app:defaultFocus可用於指定可聚焦的後代視圖的 ID，當用戶輕推到此FocusArea時，它應該被聚焦。
2. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   app:defaultFocusOverridesHistory可以設置為true以使上面指定的視圖獲得焦點，即使歷史表明此FocusArea中的另一個視圖已被關注。
3. （安卓12 ）
   使用app:nudgeLeftShortcut 、 app:nudgeRightShortcut 、 app:nudgeUpShortcut和app:nudgeDownShortcut來指定可聚焦後代視圖的 ID，當用戶向給定方向輕推時，它應該被聚焦。要了解更多信息，請參閱下面的微調快捷方式的內容。

   （ Android 11 QPR3、Android 11 Car，在 Android 12 中已棄用） app:nudgeShortcut和app:nudgeShortcutDirection僅支持一個輕推快捷方式。

4. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   要在此FocusArea中啟用旋轉環繞，可以將app:wrapAround設置為true 。這通常在視圖以圓形或橢圓形排列時使用。
5. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   要調整此FocusArea中突出顯示的填充，請使用app:highlightPaddingStart 、 app:highlightPaddingEnd 、 app:highlightPaddingTop 、 app:highlightPaddingBottom 、 app:highlightPaddingHorizontal ​​ntal 和app:highlightPaddingVertical 。
6. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   要調整此FocusArea的感知邊界以找到微調目標，請使用app:startBoundOffset 、 app:endBoundOffset 、 app:topBoundOffset 、 app:bottomBoundOffset 、 app:horizontalBoundOffset app:bottomBoundOffset和app:verticalBoundOffset 。
7. （ Android 11 QPR3、Android 11 汽車、Android 12 ）
   要明確指定給定方向上相鄰FocusArea （或多個區域）的 ID，請使用app:nudgeLeft 、 app:nudgeRight 、 app:nudgeUp和app:nudgeDown 。當默認使用的幾何搜索未找到所需目標時使用此選項。

輕推通常在 FocusAreas 之間導航。但是對於輕推快捷方式，輕推有時會首先在FocusArea內導航，因此用戶可能需要輕推兩次才能導航到下一個FocusArea 。當FocusArea包含一個長列表後跟一個Floating Action Button時，微調快捷鍵很有用，如下例所示：

圖 3.微調快捷方式

如果沒有輕推快捷方式，用戶將不得不旋轉整個列表才能到達 FAB。

焦點高亮定制

如上所述， RotaryService建立在 Android 框架現有的視圖焦點概念之上。當用戶旋轉和輕推時， RotaryService會移動焦點，聚焦一個視圖並取消聚焦另一個視圖。在 Android 中，當一個視圖獲得焦點時，如果該視圖：

• 已經指定了自己的焦點高亮，Android 會繪製視圖的焦點高亮。
• 沒有指定焦點高亮，並且默認焦點高亮沒有禁用，Android為視圖繪製默認焦點高亮。

為觸摸而設計的應用程序通常不會指定適當的焦點突出顯示。

默認焦點突出顯示由 Android 框架提供，並且可由 OEM 覆蓋。當應用程序開發人員使用的主題派生自Theme.DeviceDefault時，他們會收到它。

為了獲得一致的用戶體驗，請盡可能使用默認的焦點突出顯示。如果您需要自定義形狀（例如，圓形或藥丸形）的焦點突出顯示，或者如果您使用的主題不是從Theme.DeviceDefault派生的，請使用 car-ui-library 資源來指定您自己的焦點突出顯示每個視圖。

要為視圖指定自定義焦點突出顯示，請將視圖的背景或前景可繪製對象更改為視圖聚焦時不同的可繪製對象。通常，您會更改背景。如果將以下可繪製對像用作方形視圖的背景，則會產生圓形焦點突出顯示：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
   <item android:state_focused="true" android:state_pressed="true">
      <shape android:shape="oval">
         <solid android:color="@color/car_ui_rotary_focus_pressed_fill_color"/>
         <stroke
            android:width="@dimen/car_ui_rotary_focus_pressed_stroke_width"
            android:color="@color/car_ui_rotary_focus_pressed_stroke_color"/>
      </shape>
   </item>
   <item android:state_focused="true">
      <shape android:shape="oval">
         <solid android:color="@color/car_ui_rotary_focus_fill_color"/>
         <stroke
            android:width="@dimen/car_ui_rotary_focus_stroke_width"
            android:color="@color/car_ui_rotary_focus_stroke_color"/>
      </shape>
   </item>
   <item>
      <ripple...>
         ...
      </ripple>
   </item>
</selector>

（ Android 11 QPR3、Android 11 Car、Android 12 ）以上示例中的粗體資源引用標識了由 car-ui-library 定義的資源。 OEM 會覆蓋這些以與他們指定的默認焦點突出顯示一致。這確保了當用戶在具有自定義焦點突出顯示的視圖和具有默認焦點突出顯示的視圖之間導航時，焦點突出顯示顏色、筆劃寬度等不會改變。最後一項是用於觸摸的波紋。用於粗體資源的默認值如下所示：

圖 4.粗體資源的默認值

此外，當按鈕被賦予純色背景色以引起用戶注意時，將調用自定義焦點突出顯示，如下例所示。這會使焦點高光難以看到。在這種情況下，使用輔助顏色指定自定義焦點突出顯示：

• （ Android 11 QPR3、Android 11 汽車、Android 12 ）
  car_ui_rotary_focus_fill_secondary_color
car_ui_rotary_focus_stroke_secondary_color
• （安卓12 ）
  car_ui_rotary_focus_pressed_fill_secondary_color
car_ui_rotary_focus_pressed_stroke_secondary_color

例如：

專注，不按	專注，按下

旋轉滾動

如果您的應用程序使用RecyclerView ，您應該改用CarUiRecyclerView 。這可確保您的 UI 與其他 UI 一致，因為 OEM 的自定義適用於所有CarUiRecyclerView 。

如果列表中的元素都是可聚焦的，則無需執行任何其他操作。旋轉導航通過列表中的元素移動焦點，並且列表滾動以使新獲得焦點的元素可見。

（ Android 11 QPR3、Android 11 汽車、Android 12 ）
如果混合了可聚焦和不可聚焦的元素，或者如果所有元素都不可聚焦，則可以啟用旋轉滾動，這允許用戶使用旋轉控制器逐漸滾動列表，而不會跳過不可聚焦的項目。要啟用旋轉滾動，請將app:rotaryScrollEnabled屬性設置為true 。

（ Android 11 QPR3、Android 11 汽車、Android 12 ）
您可以使用CarUiUtils中的setRotaryScrollEnabled()方法在任何可滾動視圖中啟用旋轉滾動，包括 av CarUiRecyclerView 。如果這樣做，您需要：

• 使可滾動視圖可聚焦，以便在其可聚焦的後代視圖都不可見時聚焦，
• 通過調用setDefaultFocusHighlightEnabled(false)禁用可滾動視圖上的默認焦點突出顯示，以便可滾動視圖看起來沒有焦點，
• 通過調用setDescendantFocusability(ViewGroup.FOCUS_BEFORE_DESCENDANTS)確保可滾動視圖在其後代之前聚焦。
• 使用SOURCE_ROTARY_ENCODER和AXIS_VSCROLL或AXIS_HSCROLL以指示滾動距離和方向（通過標誌）。

當在CarUiRecyclerView上啟用旋轉滾動並且用戶旋轉到不存在可聚焦視圖的區域時，滾動條會從灰色變為藍色，好像表示滾動條已聚焦。如果你願意，你可以實現類似的效果。

除了源之外，MotionEvents 與鼠標滾輪生成的相同。

直接操作模式

通常，輕推和旋轉在用戶界面中導航，而按下中心按鈕會採取行動，儘管情況並非總是如此。例如，如果用戶想要調整鬧鐘音量，他們可能會使用旋轉控制器導航到音量滑塊，按中心按鈕，旋轉控制器以調整鬧鐘音量，然後按返回按鈕返回導航.這稱為直接操作 (DM)模式。在這種模式下，旋轉控制器用於直接與視圖交互而不是導航。

以兩種方式之一實施 DM。如果您只需要處理旋轉並且要操作的視圖適當地響應ACTION_SCROLL_FORWARD和ACTION_SCROLL_BACKWARD AccessibilityEvent ，請使用簡單的機制。否則，使用高級機制。

簡單機制是系統窗口中的唯一選擇；應用程序可以使用任何一種機制。

簡單的機制

（ Android 11 QPR3、Android 11 汽車、Android 12 ）
您的應用應調用DirectManipulationHelper.setSupportsRotateDirectly(View view, boolean enable) 。 RotaryService識別用戶何時處於 DM 模式，並在用戶在視圖聚焦時按下中心按鈕時進入 DM 模式。在 DM 模式下，旋轉執行ACTION_SCROLL_FORWARD或ACTION_SCROLL_BACKWARD並在用戶按下後退按鈕時退出 DM 模式。進入和退出 DM 模式時，簡單的機制會切換視圖的選定狀態。

要提供用戶處於 DM 模式的視覺提示，請在選擇時使您的視圖看起來不同。例如，當android:state_selected為true時更改背景。

先進的機制

該應用程序確定RotaryService進入和退出 DM 模式。為了獲得一致的用戶體驗，在聚焦 DM 視圖的情況下按下 Center 按鈕應進入 DM 模式，而 Back 按鈕應退出 DM 模式。如果不使用中心按鈕和/或輕推，它們可以是退出 DM 模式的替代方法。對於地圖等應用程序，可以使用代表 DM 的按鈕進入 DM 模式。

要支持高級 DM 模式，請查看：

1. （ Android 11 QPR3、Android 11 Car、Android 12 ）必須監聽KEYCODE_DPAD_CENTER事件以進入 DM 模式並監聽KEYCODE_BACK事件以退出 DM 模式，在每種情況下調用DirectManipulationHelper.enableDirectManipulationMode() 。要偵聽這些事件，請執行以下操作之一：
   • 註冊一個OnKeyListener 。
   或者，
   • 擴展視圖，然後覆蓋它的dispatchKeyEvent()方法。
2. 如果視圖應該處理輕推，則應該監聽輕推事件（ KEYCODE_DPAD_UP 、 KEYCODE_DPAD_DOWN 、 KEYCODE_DPAD_LEFT或KEYCODE_DPAD_RIGHT ）。
3. 如果視圖想要處理旋轉，應該監聽MotionEvent並在AXIS_SCROLL中獲取旋轉計數。做這件事有很多種方法：
   1. 註冊一個OnGenericMotionListener 。
   2. 擴展視圖並覆蓋它的dispatchTouchEvent()方法。
4. 為避免卡在 DM 模式，當視圖所屬的 Fragment 或 Activity 不是交互式時，必須退出 DM 模式。
5. 應該提供一個視覺提示來指示視圖處於 DM 模式。

下面提供了使用 DM 模式平移和縮放地圖的自定義視圖示例：

/** Whether this view is in DM mode. */
private boolean mInDirectManipulationMode;


/** Initializes the view. Called by the constructors. */
private void init() {
   setOnKeyListener((view, keyCode, keyEvent) -> {
      boolean isActionUp = keyEvent.getAction() == KeyEvent.ACTION_UP;
      switch (keyCode) {
         // Always consume KEYCODE_DPAD_CENTER and KEYCODE_BACK events.
         case KeyEvent.KEYCODE_DPAD_CENTER:
            if (!mInDirectManipulationMode && isActionUp) {
               mInDirectManipulationMode = true;
               DirectManipulationHelper.enableDirectManipulationMode(this, true);
               setSelected(true); // visually indicate DM mode
            }
            return true;
         case KeyEvent.KEYCODE_BACK:
            if (mInDirectManipulationMode && isActionUp) {
               mInDirectManipulationMode = false;
               DirectManipulationHelper.enableDirectManipulationMode(this, false);
               setSelected(false);
            }
            return true;
        // Consume controller nudge events only when in DM mode.
        // When in DM mode, nudges pan the map.
        case KeyEvent.KEYCODE_DPAD_UP:
           if (!mInDirectManipulationMode) return false;
           if (isActionUp) pan(0f, -10f);
           return true;
        case KeyEvent.KEYCODE_DPAD_DOWN:
           if (!mInDirectManipulationMode) return false;
           if (isActionUp) pan(0f, 10f);
           return true;
        case KeyEvent.KEYCODE_DPAD_LEFT:
           if (!mInDirectManipulationMode) return false;
           if (isActionUp) pan(-10f, 0f);
           return true;
        case KeyEvent.KEYCODE_DPAD_RIGHT:
           if (!mInDirectManipulationMode) return false;
           if (isActionUp) pan(10f, 0f);
           return true;
        // Don't consume other key events.
        default:
           return false;
      }
   });


   // When in DM mode, rotation zooms the map.
   setOnGenericMotionListener(((view, motionEvent) -> {
      if (!mInDirectManipulationMode) return false;
      float scroll = motionEvent.getAxisValue(MotionEvent.AXIS_SCROLL);
      zoom(10 * scroll);
      return true;
   }));
}


@Override
public void onPause() {
   if (mInDirectManipulationMode) {
      // To ensure that the user doesn't get stuck in DM mode, disable DM mode
      // when the fragment is not interactive (e.g., a dialog shows up).
      mInDirectManipulationMode = false;
      DirectManipulationHelper.enableDirectManipulationMode(this, false);
   }
   super.onPause();
}

更多示例可以在RotaryPlayground項目中找到。

活動視圖

使用 ActivityView 時：

• ActivityView不應該是可聚焦的。
• （ Android 11 QPR3、Android 11 Car，在 Android 11 中已棄用）
  ActivityView的內容必須包含一個FocusParkingView作為第一個焦點視圖，並且它的app:shouldRestoreFocus屬性必須是false 。
• ActivityView的內容應該沒有android:focusByDefault視圖。

對於用戶來說，ActivityViews 應該對導航沒有影響，只是焦點區域不能跨越 ActivityViews。換句話說，您不能在ActivityView內部和外部擁有一個包含內容的焦點區域。如果您不向ActivityView ActivityView視圖層次結構的根被視為隱式焦點區域。

按住時操作的按鈕

大多數按鈕在單擊時會引起一些動作。一些按鈕在按住時會起作用。例如，快進和快退按鈕通常在按住時操作。要使此類按鈕支持旋轉，請按如下方式偵聽KEYCODE_DPAD_CENTER KeyEvents ：

mButton.setOnKeyListener((v, keyCode, event) ->
{
    if (keyCode != KEYCODE_DPAD_CENTER) {
        return false;
    }
    if (event.getAction() == ACTION_DOWN) {
        mButton.setPressed(true);
        mHandler.post(mRunnable);
    } else {
        mButton.setPressed(false);
        mHandler.removeCallbacks(mRunnable);
    }
    return true;
});

其中mRunnable採取行動（例如倒帶）並安排自己在延遲後運行。

觸控模式

用戶可以通過兩種方式使用旋轉控制器與汽車中的主機交互，通過使用旋轉控制器或通過觸摸屏幕。使用旋轉控制器時，將突出顯示其中一個可聚焦視圖。觸摸屏幕時，不會出現焦點突出顯示。用戶可以隨時在這些輸入模式之間切換：

• 旋轉→觸摸。當用戶觸摸屏幕時，焦點突出顯示消失。
• 觸摸 → 旋轉。當用戶輕推、旋轉或按下中心按鈕時，會出現焦點突出顯示。

Back 和 Home 按鈕對輸入模式沒有影響。

旋轉搭載 Android 現有的觸控模式概念。您可以使用View.isInTouchMode()來確定用戶正在使用哪種輸入模式。您可以使用OnTouchModeChangeListener來監聽變化。雖然這可用於為當前輸入模式自定義用戶界面，但請避免任何重大更改，因為它們可能會令人不安。

故障排除

在為觸摸設計的應用程序中，嵌套可聚焦視圖並不少見。例如， ImageButton周圍可能有一個FrameLayout ，兩者都是可聚焦的。這對觸摸沒有任何危害，但會導致用戶對旋轉的體驗不佳，因為用戶必須旋轉控制器兩次才能移動到下一個交互式視圖。為了獲得良好的用戶體驗，Google 建議您將外部視圖或內部視圖設為可聚焦，但不能同時設置兩者。

如果通過旋轉控制器按下按鈕或開關時失去焦點，可能會出現以下情況之一：

• 由於按下按鈕，按鈕或開關被禁用（短暫或無限期）。無論哪種情況，有兩種方法可以解決這個問題：
  • 將android:enabled狀態保留為true並使用自定義狀態使按鈕或開關變灰，如Custom State中所述。
  • 使用容器圍繞按鈕或開關，並使容器而不是按鈕或開關成為焦點。 （點擊監聽器必須在容器上。）
• 正在更換按鈕或開關。例如，按下按鈕或切換開關時採取的操作可能會觸發可用操作的刷新，從而導致新按鈕替換現有按鈕。有兩種方法可以解決這個問題：
  • 不要創建新按鈕或開關，而是設置現有按鈕或開關的圖標和/或文本。
  • 如上所述，在按鈕或開關周圍添加一個可聚焦的容器。

旋轉遊樂場

RotaryPlayground是一個旋轉的參考應用程序。使用它來了解如何將旋轉功能集成到您的應用程序中。 RotaryPlayground包含在模擬器構建和運行 Android Automotive OS (AAOS) 的設備的構建中。

• RotaryPlayground存儲庫： packages/apps/Car/tests/RotaryPlayground/
• 版本：Android 11 QPR3、Android 11 Car 和 Android 12

RotaryPlayground應用程序在左側顯示以下選項卡：

• 牌。測試在焦點區域周圍導航，跳過無法聚焦的元素和文本輸入。
• 直接操縱。測試支持簡單和高級直接操作模式的小部件。此選項卡專門用於在應用程序窗口中進行直接操作。
• 系統用戶界面操作。在僅支持簡單直接操作模式的系統窗口中測試支持直接操作的小部件。
• 網格。使用滾動測試 z 模式旋轉導航。
• 通知。測試輕推進出平視通知。
• 滾動。測試滾動瀏覽可聚焦和不可聚焦的內容。
• 網絡視圖​​。測試通過WebView中的鏈接導航。
• 自定義FocusArea 。測試FocusArea自定義：
  • 環繞。
  • android:focusedByDefault和app:defaultFocus
  .
  • 明確的微調目標。
  • 輕推快捷方式。
  • 沒有可聚焦視圖的FocusArea 。