電視裝置需要次要硬體裝置才能與應用程式互動,也就是基本的遙控器或遊戲控制器。因此,您的應用程式必須支援方向鍵 (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® 檔案。