電視裝置必須使用次要硬體裝置才能與應用程式互動,例如基本遙控器或遊戲控制器。因此,您的應用程式必須支援方向鍵 (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 遊戲手把範本的控制器操作說明範例。