Android Studio V3.12環(huán)境下TV開發(fā)教程
（轉(zhuǎn)自Android官網(wǎng)https://developer.android.com/training/tv/start）
文章源自：光谷佳武 https://blog.csdn.net/jiawuhan/article/details/80618879
電視設(shè)備需要一個輔助硬件設(shè)備來與應(yīng)用程序進行交互，形式為基本的遙控器或游戲控制器。?這意味著您的應(yīng)用必須支持D-pad輸入。?這也意味著你的應(yīng)用程序可能需要處理離線的控制器，以及來自多種類型的控制器的輸入。
本課討論處理電視設(shè)備控制器的要求。
電視設(shè)備的默認(rèn)控制器是D-pad。?一般來說，您的應(yīng)用程序應(yīng)該可以從僅具有上，下，左，右，選擇，后退和主頁按鈕的遙控器操作。?如果您的應(yīng)用程序是通常需要帶有附加控件的游戲控制器的游戲，則您的應(yīng)用程序應(yīng)嘗試使用這些D-pad控件進行游戲。?在這種情況下，您的應(yīng)用程序還應(yīng)警告用戶需要控制器，并允許他們使用D-pad控制器優(yōu)雅地退出游戲。?有關(guān)使用電視設(shè)備的D-pad控制器進行導(dǎo)航的更多信息，請參閱創(chuàng)建電視導(dǎo)航?。
電視控制器通常是藍牙設(shè)備，它可能會嘗試通過定期進入睡眠模式和斷開電視設(shè)備來節(jié)省電量。?這意味著如果應(yīng)用程序未配置為處理這些重新連接事件，則可能會中斷或重新啟動應(yīng)用程序。?這些事件可能發(fā)生在以下任何情況下：
在觀看幾分鐘長的視頻時，D-Pad或游戲控制器進入睡眠模式，斷開與電視設(shè)備的連接，然后重新連接。
在游戲過程中，新玩家使用當(dāng)前未連接的游戲控制器加入游戲。
在游戲過程中，玩家離開游戲并斷開游戲控制器。
任何可能斷開和重新連接事件的TV應(yīng)用程序活動都必須配置為處理應(yīng)用程序清單中的重新連接事件。?以下代碼示例演示了如何啟用活動來處理配置更改，包括連接，斷開連接或重新連接的鍵盤或?qū)Ш皆O(shè)備：
android:configChanges="keyboard|keyboardHidden|navigation"? android:theme="@style/Theme.Leanback">? ? ? ? ? ? ? ...
此配置更改允許應(yīng)用繼續(xù)通過重新連接事件運行，而不是由Android框架重新啟動，這不是一個好的用戶體驗。
電視設(shè)備用戶可能有多種類型的控制器，他們使用他們的電視。?例如，用戶可能同時擁有基本的D-pad控制器和游戲控制器。?游戲控制器在用于D-pad功能時提供的鍵碼可能與物理D-pad發(fā)送的鍵碼不同。
你的應(yīng)用程序應(yīng)該處理來自游戲控制器的D-pad輸入的變化，所以用戶不必物理地切換控制器來操作你的應(yīng)用程序。?有關(guān)處理這些輸入變化的更多信息，請參閱處理控制器操作?。
當(dāng)用戶點擊控制器上的按鈕時，您的應(yīng)用會收到一個帶有KeyEvent的事件。?該按鈕的預(yù)期行為可能是媒體事件（如播放，暫?；蛲Ｖ梗?，也可能是電視類型的事件（如選擇或?qū)Ш剑?為了提供良好的用戶體驗，您的應(yīng)用應(yīng)該為控制器按鈕分配一致的行為。
生成這些KeyEvent的按鈕應(yīng)該由應(yīng)用根據(jù)下表處理。
KeyEvent的行為
BUTTON_B，BACK背部
BUTTON_SELECT，BUTTON_A，ENTER，DPAD_CENTER，KEYCODE_NUMPAD_ENTER選擇
DPAD_UP，DPAD_DOWN，DPAD_LEFT，DPAD_RIGHT導(dǎo)航
當(dāng)用戶正在觀看媒體時，生成這些KeyEvent的按鈕應(yīng)按照下表處理。?如果您的應(yīng)用程序正在控制MediaSession，它應(yīng)該調(diào)用其中一個TransportControls方法，如下所示。?請注意，選擇按鈕在這種情況下充當(dāng)播放/暫停按鈕。
KeyEvent的TransportControls調(diào)用行為
BUTTON_SELECT，BUTTON_A，ENTER，DPAD_CENTER，
KEYCODE_NUMPAD_ENTERpause()玩
BUTTON_START，BUTTON_SELECT，BUTTON_A，ENTER，
DPAD_CENTER，KEYCODE_NUMPAD_ENTERpause()暫停
BUTTON_R1skipToNext()跳到下一個
BUTTON_L1skipToPrevious()跳到上一個
DPAD_RIGHT，BUTTON_R2，AXIS_RTRIGGER，AXIS_THROTTLEfastForward()快進
DPAD_LEFT，BUTTON_L2，AXIS_LTRIGGER，AXIS_BRAKErewind()倒帶
（沒有KeyEvent與Stop關(guān)聯(lián)）stop()停止
由于此控件集是Android TV設(shè)備的默認(rèn)設(shè)置，因此圍繞方向鍵盤（D-pad）控件規(guī)劃控制方案。?玩家需要能夠在游戲的各個方面使用D-Pad，而不僅僅是控制核心游戲玩法，還需要導(dǎo)航菜單和廣告。?出于這個原因，您還應(yīng)該確保您的Android TV游戲不涉及觸摸界面。?例如，Android TV游戲不應(yīng)該告訴玩家“?點擊此處繼續(xù)”。
如何塑造播放器與控制器的交互可能是實現(xiàn)卓越用戶體驗的關(guān)鍵：
預(yù)先溝通控制器要求?。?使用您的Google Play說明與玩家溝通對控制器的任何期望。?如果一個游戲比一個只有一個D-pad的游戲手柄更適合于游戲手柄，請明確說明這一點。?使用不合適的控制器進行游戲的玩家很可能會有次級體驗，并在評分中懲罰您的游戲。
使用一致的按鈕映射?。?直觀靈活的按鈕映射是獲得良好用戶體驗的關(guān)鍵。?例如，您應(yīng)該使用A按鈕接受?，并按下B按鈕取消?，以遵守接受的海關(guān)。?您還可以提供可重新映射形式的靈活性。?有關(guān)按鈕映射的更多信息，請參閱處理控制器操作?。
檢測控制器功能并據(jù)此進行調(diào)整?。?向控制器查詢其功能以優(yōu)化控制器和游戲之間的匹配。?例如，您可能希望玩家通過在空中揮動控制器來引導(dǎo)物體。?如果玩家的控制器缺乏加速計和陀螺儀硬件，揮手將無法工作。?所以，你的游戲應(yīng)該查詢控制器，如果不支持運動檢測，切換到另一種可用的控制方案。?有關(guān)查詢控制器功能的更多信息，請參閱Android版本的支持控制器?。
后退按鈕不應(yīng)該充當(dāng)切換。?例如，不要用它來打開和關(guān)閉菜單。?它應(yīng)該僅通過前一個屏幕（例如：游戲玩法>游戲暫停屏幕>游戲主屏幕> Android主屏幕）向后導(dǎo)航，即面包屑式。
由于后退按鈕只應(yīng)執(zhí)行線性（向后）導(dǎo)航，因此您可以使用后退按鈕離開游戲內(nèi)菜單（由不同的按鈕打開）并返回游戲狀態(tài)。?有關(guān)導(dǎo)航設(shè)計的更多信息，請參閱導(dǎo)航?。?要了解實施情況，請參閱提供適當(dāng)?shù)暮笸藢?dǎo)航?。
并非所有游戲控制器都提供開始，搜索或菜單按鈕。?確保你的用戶界面不依賴于這些按鈕的使用。
當(dāng)多個玩家正在玩一個游戲時，每個玩家都有自己的控制器，因此映射每個玩家 - 控制器對非常重要。?有關(guān)如何實現(xiàn)控制器編號標(biāo)識的信息，請參閱getControllerNumber()?。
當(dāng)游戲過程中控制器斷開連接時，游戲應(yīng)該暫停，并且會出現(xiàn)一個對話框，提示斷開的玩家重新連接他或她的控制器。
該對話框還應(yīng)提供故障排除提示（例如，彈出對話框告訴玩家“檢查您的藍牙連接”）。?有關(guān)實現(xiàn)輸入設(shè)備支持的更多信息，請參閱處理控制器操作?。?有關(guān)藍牙連接的特定信息位于藍牙?。
如果您的游戲提供視覺游戲控制指令，則控制器圖像應(yīng)該沒有品牌，并且只包含與Android兼容的按鈕?。
有關(guān)Android兼容控制器的示例圖像，請下載Android TV游戲板模板（ZIP）?。?它包括黑色背景上的白色控制器和白色背景上的黑色控制器（如圖1所示），作為PNG文件和Adobe?Illustrator?文件。
圖1.使用Android TV游戲板模板（ZIP）的示例控制器說明。
