TV 應用程式品質指南

相較於使用手機或平板電腦,使用者觀看電視節目時會有不同的預期行為。電視使用者通常會坐在離畫面約 10 英尺 (約 3 公尺) 處,因此較不會注意小細節,且難以閱讀小型文字。由於使用者坐在遠離電視的位置,必須使用遙控器裝置進行瀏覽及選取,而不是輕觸螢幕上的元素。這些差異會大幅影響對優質電視使用者體驗的要求定義。

如要打造優質的電視使用者體驗,第一步就是詳閱並遵循 Android TV 設計指南。如要瞭解 TV 應用程式的基本實作要求,請同時參閱「打造 TV 應用程式」訓練課程。

如要瞭解如何在 Google Play 發布 TV 應用程式,請參閱「發布到 Android TV」一文。

視覺設計和使用者互動

下列標準可確保應用程式遵循重要的設計和互動模式,進而在 TV 裝置上提供一致、直覺且愉悅的使用者體驗。

類型 Test 說明
啟動器 TV-LM

安裝完成後,應用程式會在 Android TV 啟動器中顯示啟動器圖示。詳情請參閱「宣告 TV Activity」。

TV-LB

應用程式會在 Android TV 啟動器中顯示 320x180 像素的原尺寸橫幅,以及至少 160x160 像素 (xhdpi 密度) 的應用程式圖示,做為啟動器圖示。詳情請參閱「 Android TV 應用程式圖示和橫幅規範」。

TV-BN

應用程式啟動橫幅包含應用程式名稱。

TV-LG

如果應用程式是遊戲,會出現在 Android TV 啟動器的「遊戲」列中。
詳情請參閱「在主畫面上顯示遊戲」。

TV-LS

應用程式可順利執行,且不會顯示錯誤訊息,包括安裝、載入和測試期間。詳情請參閱「執行 TV 應用程式」。

版面配置 TV-LO

所有應用程式介面都會以橫向呈現,且不會出現垂直上下黑邊/左右黑邊。原始格式影片的兩側只能為黑色。 詳情請參閱「建構基本 TV 版面配置」。

TV-OV

應用程式顯示的任何文字或功能都不會在螢幕邊緣遭到截斷。詳情請參閱「過掃」。

TV-TR

應用程式不會局部遮蓋其他應用程式。應用程式會填滿整個螢幕,並採用不透明背景。

TV-DP

除非應用程式需要如後方「功能」表格「控制器」部分 TV-GP 條件中指定的遊戲控制器,否則所有應用程式功能均可使用五向 D-Pad 控制器進行瀏覽。詳情請參閱「電視導覽」。

TV-DK

如果應用程式需要如 TV-GP 準則中指定的遊戲控制器,所有功能均可使用標準 Android 遊戲控制鍵進行瀏覽。詳情請參閱「處理遊戲手把按鈕的按下動作」。

TV-DM

應用程式不須仰賴具有選單按鈕的遙控器,存取使用者介面控制項。

TV-DB

按下返回按鈕可以返回 Android TV 主畫面。詳情請參閱「提供適當的返回按鈕行為」。

TV-DL

如果應用程式在「直播」分頁中整合了電視直播動態饋給,必須能夠滿足流暢播放體驗和返回導向的要求。 詳情請參閱返回按鈕

TV-SB

應用程式內搜尋查詢會顯示在搜尋框中,與 SearchFragment 提供的使用者介面類似,且結果與該查詢相關。詳情請參閱「在電視應用程式中搜尋」。

功能和效能

這些標準可確保應用程式設定正確無誤,且能提供預期的功能行為。

類型 Test 說明
SDK TV-PS 除了核心效能和穩定性規定外,應用程式還會設定 Android SDK 最低版本為 31 以下,藉此聲明支援常用的 Android TV 裝置 (設定 minSdkVersion 值)。
資訊清單 TV-ML

應用程式資訊清單會搭配 CATEGORY_LEANBACK_LAUNCHER 類別,將意圖類型設為 ACTION_MAIN。詳情請參閱「宣告 TV Activity」。

TV-MT

應用程式資訊清單會將 android.hardware.touchscreen 和「為 TV 宣告硬體需求」中列出的其他功能設為非必要功能。詳情請參閱「宣告 TV 的硬體需求」。

遊戲控制器 TV-GP

如果應用程式使用遊戲控制器做為主要輸入方式,則會使用 <uses-feature> 資訊清單標記宣告適當的需求。詳情請參閱「宣告支援遊戲控制器」。

TV-GC

如果應用程式提供使用遊戲控制器的視覺操作說明,操作說明不得含有品牌宣傳內容,並且顯示相容的按鈕版面配置。詳情請參閱「處理遊戲的控制器」。

廣告 TV-AP

應用程式允許使用 D-Pad 控制器與廣告互動。詳情請參閱「啟用 D-pad 導覽」。

TV-AD

針對全螢幕或非影片性質的廣告,應用程式能讓使用者立即使用 D-Pad 或遊戲手把控制器關閉廣告。

TV-AU

如果廣告具有可點擊、非全螢幕或非影片性質,應用程式就不得允許廣告連結至網頁網址。

TV-AA

如果廣告具有可點擊、非全螢幕或非影片性質,應用程式就不得允許廣告連結至另一個不能在電視裝置上使用的應用程式。

網路內容 TV-WB

針對網路內容,應用程式只能使用 WebView 元件。應用程式不得嘗試啟動網路瀏覽器應用程式。

媒體播放 TV-NP

當使用者返回主畫面或切換至其他應用程式後,如果應用程式繼續播放音訊,會在主畫面的推薦列上提供「現正播放」資訊卡,方便使用者返回應用程式控制播放作業。詳情請參閱「顯示『現正播放』資訊卡」。

建議您在使用者切換應用程式時暫停影片,且不要將影片與「聽聲辨曲」資訊卡整合。

TV-PA

如果應用程式提供「現正播放」資訊卡,會在使用者選取這張資訊卡後,將他們導向至可暫停播放的畫面。

TV-PP

如果應用程式會播放影片或音樂內容,可根據播放過程中傳送的播放或暫停鍵事件,切換媒體的播放與暫停播放作業。詳情請參閱 KEYCODE_MEDIA_PLAY_PAUSE

TV-PC

播放影片或音訊時,按下 D-Pad 的中央按鈕會暫停正在播放的媒體。暫停播放時,按下 D-Pad 的中央按鈕應能繼續播放。D-Pad 的左右按鈕分別可快轉和倒轉目前曲目。詳情請參閱「媒體事件」。

TV-PN

系統會根據應用程式開發人員的「接下來請看」指南,將項目新增至「接下來請看」頻道。

微光模式 TV-BU

當使用者主動啟動影片播放時,應用程式會防止裝置進入微光模式。詳情請參閱「微光模式」。

TV-BY

如果使用者未主動播放影片或動畫,應用程式不會禁止裝置進入微光模式。

TV-BA

如果是純音訊播放,應用程式不會阻止裝置進入微光模式,除非應用程式在播放音樂時導入非靜態圖像 (例如音樂影片或圖像) 的體驗。

記憶體
TV-ME

如果是低 RAM 裝置 ( ActivityManager.isLowRamDevice() 會傳回 true),前景應用程式的最大記憶體用量 (匿名 + 交換 + Graphics + 檔案記憶體) 必須維持在「最佳化記憶體用量」中定義的限制內 (包括特定測量機制和注意事項)。

Google Play

請按照下列規定,確保應用程式的設定與 Google Play 上的其他資訊和分類一致:

類型 Test 說明
子母畫面 TV-IC

應用程式會設定適當的中繼資料,將子母畫面使用情形歸類為其中一種允許的使用類型。此外,它也會宣告標題和副標題,如實呈現這個 PIP 的用途。

詳情請參閱「在電視上執行多工處理」。

TV-IP

在子母畫面模式下,應用程式不會顯示宣傳素材或廣告,除非這些內容本來就是內容來源的一部分。

TV-IQ

在子母畫面模式下,應用程式不會降低其他全螢幕活動的體驗。

應用程式不應使用過多資源、搶走音訊焦點、干擾作用中的 MediaSession,或要求不成比例的解碼器工作階段數量。

TV-IH

應用程式在子母畫面模式下不會顯示任何 UI 控制項或可導覽的元素。 應用程式可能會直接在子母畫面視窗中顯示特定使用者控制項

TV-IE

使用者必須在應用程式中明確且刻意採取動作,才能進入子母畫面模式。除非使用者正在通話,否則應用程式不會自動進入子母畫面模式 (setAutoEnterEnabled 設為 false)。

TV-IS

如果裝置停用子母畫面模式,應用程式就不得顯示任何 UI 來進入子母畫面模式。

TV-IX

應用程式只會使用子母畫面模式,繼續執行進行中的活動。在活動進行中或結束後,子母畫面體驗不會鼓勵或促使使用者返回應用程式的全螢幕檢視畫面。

Play 政策 TV-G1

Google Play 商店中的所有新電視應用程式和現有電視應用程式,都必須採用 Android App Bundle

TV-G2

您的應用程式必須符合Play 開發人員政策中心的規定。

應用程式詳細資料頁面 TV-G3

應用程式功能可正常運作,或是符合 Google Play 商店資訊中的應用程式說明內容。

TV-G4

應用程式提交內容已上傳至少一張未經修改的高解析度螢幕截圖,清楚展示電視應用程式的目前版本。

登入憑證 TV-G5

如果應用程式提供付費功能,請務必在 Google Play 管理中心提供登入憑證,以便測試完整的應用程式體驗。詳情請參閱「應用程式審查準備工作」中的「應用程式存取權」。

常見問題

提交應用程式後,如何判斷自己的應用程式是否符合 TV 裝置的所有要求?

如果您的應用程式不符合本頁所述的可用性要求,Play 商店團隊會透過電子郵件與您聯絡,信件將會寄到與該應用程式相關聯的 Google Play 管理中心帳戶中指定的電子郵件地址。

注意:請確認您的應用程式包含 TV 裝置適用的必要資訊清單項目。否則系統不會將您的應用程式視為 TV 應用程式,因此無法進行 TV 可用性要求審查。

我的應用程式不僅指定 TV 裝置,也指定其他板型規格。如果我的應用程式不符合 TV 裝置要求,適用於其他裝置的新版或更新版應用程式仍會顯示在 Google Play 上嗎?

只有在所有變更都獲得核准後,才能發布 Google Play 商店資訊的更新。如果特定外型規格的構件更新,導致您無法更新手機或平板電腦等其他裝置的商店資訊,建議您先以空白提交內容取代該構件,直到符合相關規定為止。

如果我的應用程式符合發布要求,何時會在 Google Play 商店上架供 TV 裝置使用?

符合 TV 裝置要求的應用程式會立即顯示在 Play 商店中供 TV 裝置使用。