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 商店中。