電視裝置必須使用次要硬體裝置才能與應用程式互動，例如基本遙控器或遊戲控制器。因此，您的應用程式必須支援方向鍵 (D-pad) 輸入。 此外，應用程式可能需要處理離線的控制器，以及多種控制器的輸入內容。
本指南說明處理 TV 裝置控制器的相關規定。
D-Pad 最小控制項
電視裝置的預設控制器是 D-Pad。一般來說，您的應用程式必須能夠透過遠端控制器運作，且該控制器中只能使用向上、向下、向左、向右、選取、返回和主畫面按鈕。如果應用程式的遊戲通常需要使用具有額外控制項的遊戲控制器，請嘗試只使用這些 D-Pad 控制器支援遊戲功能。否則，請警告使用者需要使用控制器，並讓他們使用 D-Pad 控制器順利結束遊戲。
如要進一步瞭解如何使用 D-Pad 控制器處理電視裝置的導覽功能，請參閱「電視導覽」。
處理控制器中斷連線
電視控制器通常是藍牙裝置，可能會定期進入睡眠模式，並中斷電視裝置的連線，嘗試節省電力。這表示如果應用程式未設定處理這些重新連線事件，應用程式可能會中斷或重新啟動。以下任何一種情況都可能發生這些事件：
- 如果影片有好幾分鐘，則 D-Pad 或遊戲控制器可能會進入休眠模式，中斷與電視裝置的連線，稍後重新連線。
- 在遊戲過程中，新玩家可能會使用尚未連線的遊戲控制器加入遊戲。
- 在遊戲過程中，玩家可能會離開遊戲並取消連結遊戲控制器。
凡是會中斷連線和重新連線事件的 TV 應用程式活動，都必須設為處理應用程式資訊清單中的重新連線事件。下列程式碼範例示範如何讓活動處理設定變更，包括鍵盤或導航裝置的連線、中斷連線或重新連線：
<activity
android:name="com.example.android.TvActivity"
android:label="@string/app_name"
android:configChanges="keyboard|keyboardHidden|navigation"
android:theme="@style/Theme.Leanback">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LEANBACK_LAUNCHER" />
</intent-filter>
...
</activity>
這項設定變更可讓應用程式透過重新連線事件繼續執行，而非由 Android 架構重新啟動，但使用體驗不佳。
處理 D-Pad 輸入變化版本
電視裝置使用者可能會與電視搭配使用的多種控制器。舉例來說，一個使用者可能同時擁有基本的 D-Pad 控制器和遊戲控制器。遊戲控制器用於 D-Pad 函式時提供的按鍵碼，可能與基本 D-Pad 傳送的按鍵碼不同。
處理 D-Pad 輸入的變化，讓使用者不必切換控制器就能操作應用程式。如要進一步瞭解如何處理輸入變化版本，請參閱「 處理方向鍵輸入」。
處理按鈕事件
當使用者按一下控制器上的按鈕時，應用程式會收到帶有 KeyEvent 的事件。按鈕的預期行為可能是媒體事件 (例如播放、暫停或停止)，也可能是電視類型事件，例如選取或瀏覽。為了提供良好的使用者體驗，請為控制器按鈕指派一致的行為。
電視 UI 事件
將電視 UI 行為指派給產生 KeyEvent 類型的按鈕，如下表所示：
KeyEvent | 行為 |
|---|---|
KEYCODE_BUTTON_B、KEYCODE_BACK | 返回 |
KEYCODE_BUTTON_SELECT、KEYCODE_BUTTON_A、KEYCODE_ENTER、
KEYCODE_DPAD_CENTER、KEYCODE_NUMPAD_ENTER | 選項 |
KEYCODE_DPAD_UP、KEYCODE_DPAD_DOWN、KEYCODE_DPAD_LEFT、KEYCODE_DPAD_RIGHT | 導覽 |
媒體事件
當使用者觀看媒體時，請為產生 KeyEvent 類型的按鈕指派行為，如下表所示。如果您的應用程式控制 MediaSession，請使用 MediaControllerAdapter 呼叫表格中顯示的其中一個 MediaControllerCompat.TransportControls 方法。請注意，在這種情況下，選取按鈕的作用是「播放」或「暫停」按鈕。
KeyEvent | TransportControls 呼叫 | 行為 |
|---|---|---|
BUTTON_SELECT、BUTTON_A、ENTER、
DPAD_CENTER、KEYCODE_NUMPAD_ENTER |
play() | 播放 |
BUTTON_START、BUTTON_SELECT、BUTTON_A、
ENTER、DPAD_CENTER、KEYCODE_NUMPAD_ENTER |
pause() | 暫停 |
BUTTON_R1 | skipToNext() | 跳到下一個 |
BUTTON_L1 | skipToPrevious() | 跳到上一個 |
DPAD_RIGHT、BUTTON_R2、AXIS_RTRIGGER、AXIS_THROTTLE | fastForward() | 快轉 |
DPAD_LEFT、BUTTON_L2、AXIS_LTRIGGER、AXIS_BRAKE | rewind() | 倒轉 |
| 無 | stop() | 停止 |
注意：使用 MediaSession 時，請勿覆寫媒體特定按鈕 (例如 KEYCODE_MEDIA_PLAY 或 KEYCODE_MEDIA_PAUSE) 的處理方式。系統會自動觸發適當的 MediaSession.Callback 方法。
提供適當的返回按鈕行為
「返回」按鈕不得做為切換鈕。例如，請不要同時使用它來開啟和關閉選單。請勿使用此按鈕向後瀏覽導覽標記樣式，也就是玩家所停留的上一個畫面。
由於「返回」按鈕只能執行線性的反向導覽，因此您可以使用這個按鈕離開由其他按鈕開啟的應用程式內選單，並返回應用程式。連續按下「返回」按鈕一律必須導向 Android TV 主畫面。例如：遊戲 > 遊戲暫停畫面 > 遊戲主畫面 > Android TV 主畫面或電視節目 > TV 應用程式主畫面 > Android TV 主畫面。
如要進一步瞭解導覽設計，請參閱「 設計返回和向上導覽」。如要瞭解實作方式，請參閱「提供正確的返回導覽功能」一文。
處理遊戲控制器
支援 D-Pad 控制項
請規劃 D-Pad 控制器的控制項配置，因為這個控制項集是 Android TV 裝置的預設選項。玩家必須能夠針對遊戲的所有層面使用 D-Pad，不僅可以控制核心遊戲過程，也能瀏覽選單和廣告。因此，請確保 Android TV 遊戲不會參照含有「輕觸這裡」等語言的觸控介面。
決定玩家與控制器之間的互動方式，是提供優質使用者體驗的關鍵。請考慮採用下列最佳做法：
- 事先說明控制器需求：運用 Google Play 說明，告知玩家任何與控制器相關的期望。如果遊戲比較適合使用有搖桿的遊戲手把，而不是只有 D-Pad 的手把，請清楚說明。如果玩家在遊戲中使用不合宜的控制器，可能會體驗不佳的遊戲體驗，進而給予遊戲不良的評分。
- 使用一致的按鈕對應：符合直覺的按鈕對應是打造優質使用者體驗的關鍵。舉例來說，您可以使用 A 按鈕「接受」和 B 按鈕「取消」，以便遵循已接受的海關。您也可以提供可重玩性形式的彈性。如要進一步瞭解按鈕對應，請參閱「處理控制器動作」。
- 偵測控制器功能並視情況調整：查詢控制器的功能，將控制器與遊戲之間的比對最佳化調整至最佳狀態。舉例來說，您可能打算讓玩家搖動空氣中的控制器來控制物體，但如果玩家的控制器沒有加速計和陀螺儀硬體，則無法揮動。查詢控制器。如果不支援動作偵測功能，請改用其他可用的控製配置。如要進一步瞭解如何查詢控制器功能，請參閱「跨 Android 版本支援控制器」。
使用適當的按鈕
並非所有遊戲控制器都提供「開始」、「搜尋」或「選單」按鈕。請確保 UI 不需要使用這些按鈕。
處理多個控制器
如果有多位玩家在玩同一款遊戲，每個玩家都有自己的控制器，請務必對應各個玩家與控制器組合。如要瞭解如何實作控制器號碼識別功能，請參閱
getControllerNumber()。
處理控制器中斷連線
如果在遊戲過程中中斷控制器連線，請暫停遊戲並顯示對話方塊，提示已中斷連線的玩家重新連結控制器。
此外，請在對話方塊中提供疑難排解提示。例如，指示玩家「檢查藍牙連線」。如要進一步瞭解如何實作輸入裝置支援，請參閱「處理控制器動作」和「藍牙總覽」。
顯示控制器操作說明
如果您的遊戲提供視覺遊戲控制操作說明，請使用沒有品牌宣傳的控制器圖片，並只加入與 Android 相容的按鈕。
如需 Android 相容控制器的範例圖片，請下載 Android TV 遊戲手把範本 (ZIP)。它有一個黑色背景的白色控制器，以及白色背景的黑色控制器 (如圖 1 所示)，格式為 PNG 檔案和 Adobe® Illustrator® 檔案。
圖 1 使用 Android TV 遊戲手把範本的控制器操作說明範例。