TV 應用程式品質指南

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

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

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

視覺設計和使用者互動

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

類型 Test 說明
啟動器 TV-LM

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

電視 - 磅

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

TV-BN

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

TV-LG

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

TV-LS

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

版面配置 TV-LO

所有應用程式介面都會以橫向顯示,不會加上垂直黑邊/左右黑邊。原始格式影片的長條只能使用黑色色。詳情請參閱「建構基本的電視版面配置」。

TV-OV

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

TV-TR

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

TV-DP

應用程式功能可透過五向 D-Pad 控制項進行瀏覽 (除非應用程式需要遊戲控制器;如「功能」表格「控制器」部分中的「TV-GP」條件所述)。詳情請參閱「電視導覽」。

TV-DK

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

電視 - 即時訊息

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

電視資料庫

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

TV-DL

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

TV-SB

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

功能

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

類型 Test 說明
資訊清單 電視-機器學習

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

TV-MT

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

遊戲控制器 TV-GP

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

TV-GC

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

廣告 TV-AP

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

電視廣告

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

TV-AU

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

TV-AA

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

網路內容 TV-WB

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

媒體播放 TV-NP

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

建議您在使用者退出應用程式後暫停影片,不要將影片與「現正播放」資訊卡整合。

TV-PA

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

TV-PP

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

電視電腦

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

TV-PN

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

微光模式 TV-BU

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

TV-BY

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

TV-BA

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

Google Play

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

類型 Test 說明
子母畫面 電視 IC

應用程式會設定適當的中繼資料,將其子母畫面的使用情形分類為其中一種許可用途。也會宣告標題和子標題,準確反映這個子母畫面的用途。

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

TV-IP

使用子母畫面時,應用程式不會顯示非本質為內容來源的宣傳素材或廣告。

TV-IQ

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

應用程式不應使用過多資源、接管音訊焦點、幹擾進行中的 MediaSession,或要求使用過多的解碼器工作階段。

TV-IH

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

TV-IE

使用子母畫面模式時,使用者必須在應用程式中執行明確動作。除非使用者正在進行通話,否則應用程式不會自動進入子母畫面 (setAutoEnterEnabled 設為 false)。

電視曝光比重

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

TV-IX

應用程式只會使用子母畫面模式接續持續進行的活動。子母畫面功能不會在活動期間或活動結束後,鼓勵或鼓勵使用者返回應用程式的全螢幕檢視畫面。

Play 政策 TV-G1

凡是在 Google Play 商店中發布的 Android TV 應用程式和現有 TV 應用程式,都必須採用 Android App Bundle

TV-G2

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

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

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

TV-G4

提交的應用程式至少上傳了一張未經修改的高解析度螢幕截圖,能準確呈現電視應用程式的目前版本。

登入憑證 TV-G5

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

常見問題

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

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

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

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

只有在所有變更都獲得核准後,才能發布 Google Play 商店資訊的更新內容。如果板型規格構件更新後,導致無法繼續更新其他裝置 (例如手機或平板電腦) 的商店資訊,建議您在移除這個構件前將其替換為空白提交內容,直到解決這些規定為止。

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

符合 TV 版本的應用程式會立即顯示在 TV 裝置上的 Play 商店中。