新推出的 Android 5.0 版本提供支援 Google Cast 的 Android TV。 本文說明如何在 Android TV 上設定及測試 開發投放應用程式您現有的 Cast 應用程式會在以下位置執行: 輕鬆 Android TV。如果您要開發 Cast 應用程式 第一次,請參閱 Google Cast 說明文件 著手開發您的投放應用程式,讓它在 Chromecast 裝置上運作 開發及測試 Android TV 產品
設定開發
- 設定 Android TV 裝置:
- 將 Android TV 裝置連線至區域網路。
- 登入 Google 帳戶。
- 從「設定」的「裝置」列中選取「關於」。
- 向下捲動並點按「Build」數次,直到對話方塊出現 並顯示「開發人員設定已啟用」的訊息。
- 如果是 USB 偵錯:
- 安裝 USB 傳輸線,但不要連接 USB 傳輸線的主端 到你的電腦
- 在「Preferences」列中,選取「Developer options」,然後選取 「USB 偵錯」,然後選取「開啟」。
- 返回主畫面。您必須執行這項操作,才能套用 剛剛選取的項目除非恢復原廠設定,否則系統會保留這些設定。
- 前往以下位置註冊 Android TV 裝置: Google Cast SDK 開發人員控制台 「裝置註冊」中所述的程序。
偵錯
如要在 Android TV 裝置上測試 Web Receiver 應用程式並進行偵錯,請執行下列步驟: 包括:
- 前往以下網站註冊 Android TV 裝置和您的應用程式: Google Cast SDK 開發人員控制台。 如要進一步瞭解註冊資訊,請參閱註冊 註冊裝置和應用程式。
- 啟動傳送端應用程式,然後投放到 Android TV 裝置。
- 透過 ADB 連線至 Android TV 裝置,詳情請參閱 使用 Android Debug Bridge。
- 在開發機器上開啟 Chrome 瀏覽器視窗,然後前往 chrome://inspect。
- 按一下「檢查」連結,將網路接收器移至偵錯工具。
在 Chrome 遠端偵錯工具主控台中輸入 包括:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
詳情請參閱偵錯。
Android TV 相容性指南
讓 Cast 應用程式與 Android TV 相容,只需極少作業即可 其他作業以下提供一些建議和常見陷阱 確保應用程式與 Android TV 相容:
- 請注意,使用者代理程式字串同時包含「Android」和「CrKey」; 有些網站可能會因為偵測到 「Android」標籤。請勿假設「Android」一律在使用者代理程式字串中 代表行動裝置使用者。
- Android 的媒體堆疊可能會使用透明的 GZIP 擷取資料。請確認
你的媒體資料可對「
Accept-Encoding: gzip
」做出回應。 - Android TV HTML5 媒體事件的觸發時機與 Chromecast,可能會顯示 Chromecast 隱藏的問題。
- 更新媒體時,請使用
<audio>/<video>
觸發的媒體相關事件 元素,例如timeupdate
、pause
和waiting
。 請避免使用progress
、suspend
和stalled
,因為這類事件大多與平台有關。 - 設定網路接收端網站的 HTTPS 憑證時,請務必 包括中繼 CA 憑證。詳情請參閱 Qualsys SSL 測試頁面 驗證:網站的信任認證路徑是否包含 CA 系統可能無法在 Android 裝置 平台。
- 雖然 Chromecast 以 720p 顯示卡顯示網路接收器頁面, 其他投放平台 (包括 Android TV) 可顯示最高 1080p 的網頁。 確認您的 Web Receiver 網頁能以不同的解析度正常縮放。
使用 Android Debug Bridge
Android TV 平台會出現在多種消費性電子產品上 裝置:電視、機上盒、遊戲主機等。 每個項目的設定方式可能不同。如果無法存取 透過裝置的使用者介面存取 Android TV 系統資源,您可以 使用 Android Debug Bridge (ADB) 來取得裝置序號 以及對應用程式偵錯請參閱 Android 偵錯 Bridge 可能不準確或不適當
透過 Wi-Fi 使用 ADB
如要透過 ADB 透過 Wi-Fi 連線裝置,請按照下列步驟操作:
- 按照下文所述步驟,在 Android TV 裝置上啟用開發人員選項 為開發做好準備。
- 請確認您的電腦與 Android 裝置連上相同的網路 電視。
開啟終端機並輸入以下指令:
adb connect Android TV device IP address:4321
在電腦上開啟終端機,然後輸入 ADB 指令。您可以驗證 且 Android TV 裝置正在通訊 執行下列指令:
adb logcat
搭配 USB 傳輸線使用 ADB
如何透過 USB 傳輸線連接 ADB 連接裝置:
- 按照下列說明設定開發用的 Android TV 裝置: 為開發做好準備。
- 將 USB 傳輸線的主線端連接至電腦。
- 在「允許 USB 偵錯嗎?」對話方塊中,選取「一律允許」 這部電腦,然後選取「OK」。
在電腦上開啟終端機,然後輸入 ADB 指令。您可以驗證 且 Android TV 裝置正在通訊 執行下列指令:
adb logcat
透過 TCP/IP 使用 ADB
ADB 不需要 USB 傳輸線,透過 TCP/IP 運作,但您必須先取得 Android 電視裝置的 IP 位址。開發人員問題裝置監聽 ADB 通訊埠連線 並且可在不初始化通訊埠的情況下連線。標準 零售 Android TV 裝置不會自動監聽 ADB 連線;的 這些裝置必須先使用 USB 傳輸線連線至 ADB,然後進行初始化 通訊埠。
- 按照下列說明設定開發用的 Android TV 裝置: 為開發做好準備。
- 在 Android TV 的「裝置」列中選取「網路」>Wi-Fi、 並選取已連線的網路
- 選取「狀態資訊」,然後記下「IP 位址」。
如果您的裝置是標準的 Android TV 零售裝置,請按照下列步驟操作:
- 請按照下方 透過 USB 傳輸線使用 ADB。
- 確認您的電腦與 Android 裝置已連上相同的網路 電視。
在電腦上的終端機中,透過下列方式初始化 TCP/IP 的通訊埠: 輸入以下內容:
adb tcpip 5555
移除 USB 傳輸線,然後在終端機中輸入以下內容:
adb connect Android TV device IP address:5555
如果裝置是開發人員問題的 Android TV,請按照下列步驟操作:
- 請確認您的電腦與 Android 裝置連上相同的網路 電視。
開啟終端機並輸入以下指令:
adb connect Android TV device IP address:4321
在 Android TV 的「允許 USB 偵錯嗎?」對話方塊中,選取「永遠」 允許在這部電腦上安裝,然後選取確定。您可以驗證連線 且 Android TV 裝置可透過 執行下列指令:
adb logcat