本頁面由 Cloud Translation API 翻譯而成。

管理 TV 遙控器

電視裝置需要次要硬體裝置才能與應用程式互動，也就是基本的遙控器或遊戲控制器。因此，您的應用程式必須支援方向鍵 (D-Pad) 輸入。此外，應用程式可能需要處理離線的控制器，以及多種控制器的輸入。

本指南說明電視裝置控制器的處理規定。

D-Pad 最小控制項

電視裝置的預設控制器為 D-Pad。一般來說，應用程式必須能夠使用只有向上、向下、左、右、選取、返回和主畫面按鈕的遙控器運作。如果您的應用程式通常會要求提供具備額外控制項的遊戲控制器，請嘗試僅採用這些 D-Pad 控制器來支援遊戲。否則，請警告使用者需要使用控制器，並讓他們使用 D-Pad 控制器正常退出遊戲。

如要進一步瞭解如何針對電視裝置使用 D-Pad 控制器處理導航，請參閱「電視導航」。

處理控制器中斷連線

電視控制器通常為藍牙裝置，這類裝置可能會定期進入休眠模式，並中斷與電視裝置的連線，藉此節省電力。因此，如果應用程式未設定處理這些重新連線事件，可能會中斷或重新啟動。這些事件可能會在下列任一情況下發生：

如果影片長時間播放數分鐘，D-Pad 或遊戲控制器可能會進入休眠模式，與電視裝置中斷連線，稍後再重新連線。
在遊戲過程中，新玩家可能會使用尚未連線的遊戲控制器加入遊戲。
在遊戲過程中，玩家可能會離開遊戲，並取消連結遊戲控制器。

凡是需要中斷連線和重新連線事件的電視應用程式活動，都必須設為處理應用程式資訊清單中的重新連線事件。下列程式碼範例說明如何讓活動處理設定變更，包括鍵盤或導航裝置連線、中斷連線或重新連線：

<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 的事件。按鈕的預期行為是播放、暫停或停止等媒體事件，或是電視類型的事件 (例如選取或瀏覽)。為提供良好的使用者體驗，請為控制器按鈕指派一致的行為。

TV UI 事件

將 TV 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 遊戲手把範本的控制器操作說明範例。

Handle TV hardware

On-screen keyboard