管理 TV 遙控器

電視裝置必須使用次要硬體裝置才能與應用程式互動,例如基本遙控器或遊戲控制器。因此,您的應用程式必須支援方向鍵 (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_BKEYCODE_BACK返回
KEYCODE_BUTTON_SELECTKEYCODE_BUTTON_AKEYCODE_ENTERKEYCODE_DPAD_CENTERKEYCODE_NUMPAD_ENTER選項
KEYCODE_DPAD_UPKEYCODE_DPAD_DOWNKEYCODE_DPAD_LEFTKEYCODE_DPAD_RIGHT導覽

媒體事件

當使用者觀看媒體時,請為產生 KeyEvent 類型的按鈕指派行為,如下表所示。如果您的應用程式控制 MediaSession,請使用 MediaControllerAdapter 呼叫表格中顯示的其中一個 MediaControllerCompat.TransportControls 方法。請注意,在這種情況下,選取按鈕的作用是「播放」或「暫停」按鈕。

KeyEventTransportControls 呼叫行為
BUTTON_SELECTBUTTON_AENTERDPAD_CENTERKEYCODE_NUMPAD_ENTER play()播放
BUTTON_STARTBUTTON_SELECTBUTTON_AENTERDPAD_CENTERKEYCODE_NUMPAD_ENTER pause()暫停
BUTTON_R1skipToNext()跳到下一個
BUTTON_L1skipToPrevious()跳到上一個
DPAD_RIGHTBUTTON_R2AXIS_RTRIGGERAXIS_THROTTLEfastForward()快轉
DPAD_LEFTBUTTON_L2AXIS_LTRIGGERAXIS_BRAKErewind()倒轉
stop()停止

注意:使用 MediaSession 時,請勿覆寫媒體特定按鈕 (例如 KEYCODE_MEDIA_PLAYKEYCODE_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 遊戲手把範本的控制器操作說明範例。