支援 Google Cast 的 Android TV

新推出的 Android 5.0 版本提供支援 Google Cast 的 Android TV。 本文說明如何在 Android TV 上設定及測試 開發投放應用程式您現有的 Cast 應用程式會在以下位置執行: 輕鬆 Android TV。如果您要開發 Cast 應用程式 第一次,請參閱 Google Cast 說明文件 著手開發您的投放應用程式,讓它在 Chromecast 裝置上運作 開發及測試 Android TV 產品

設定開發

  1. 設定 Android TV 裝置:
    1. 將 Android TV 裝置連線至區域網路。
    2. 登入 Google 帳戶。
  2. 從「設定」的「裝置」列中選取「關於」
  3. 向下捲動並點按「Build」數次,直到對話方塊出現 並顯示「開發人員設定已啟用」的訊息。
  4. 如果是 USB 偵錯:
    1. 安裝 USB 傳輸線,但不要連接 USB 傳輸線的主端 到你的電腦
    2. 在「Preferences」列中,選取「Developer options」,然後選取 「USB 偵錯」,然後選取「開啟」
  5. 返回主畫面。您必須執行這項操作,才能套用 剛剛選取的項目除非恢復原廠設定,否則系統會保留這些設定。
  6. 前往以下位置註冊 Android TV 裝置: Google Cast SDK 開發人員控制台裝置註冊」中所述的程序。

偵錯

如要在 Android TV 裝置上測試 Web Receiver 應用程式並進行偵錯,請執行下列步驟: 包括:

  1. 前往以下網站註冊 Android TV 裝置和您的應用程式: Google Cast SDK 開發人員控制台。 如要進一步瞭解註冊資訊,請參閱註冊 註冊裝置和應用程式。
  2. 啟動傳送端應用程式,然後投放到 Android TV 裝置。
  3. 透過 ADB 連線至 Android TV 裝置,詳情請參閱 使用 Android Debug Bridge
  4. 在開發機器上開啟 Chrome 瀏覽器視窗,然後前往 chrome://inspect
  5. 按一下「檢查」連結,將網路接收器移至偵錯工具。
  6. 在 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> 觸發的媒體相關事件 元素,例如 timeupdatepausewaiting。 請避免使用 progresssuspendstalled,因為這類事件大多與平台有關。
  • 設定網路接收端網站的 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 連線裝置,請按照下列步驟操作:

  1. 按照下文所述步驟,在 Android TV 裝置上啟用開發人員選項 為開發做好準備
  2. 請確認您的電腦與 Android 裝置連上相同的網路 電視。
  3. 開啟終端機並輸入以下指令:

    adb connect Android TV device IP address:4321
    
  4. 在電腦上開啟終端機,然後輸入 ADB 指令。您可以驗證 且 Android TV 裝置正在通訊 執行下列指令:

    adb logcat

搭配 USB 傳輸線使用 ADB

如何透過 USB 傳輸線連接 ADB 連接裝置:

  1. 按照下列說明設定開發用的 Android TV 裝置: 為開發做好準備
  2. 將 USB 傳輸線的主線端連接至電腦。
  3. 在「允許 USB 偵錯嗎?」對話方塊中,選取「一律允許」 這部電腦,然後選取「OK」
  4. 在電腦上開啟終端機,然後輸入 ADB 指令。您可以驗證 且 Android TV 裝置正在通訊 執行下列指令:

    adb logcat

透過 TCP/IP 使用 ADB

ADB 不需要 USB 傳輸線,透過 TCP/IP 運作,但您必須先取得 Android 電視裝置的 IP 位址。開發人員問題裝置監聽 ADB 通訊埠連線 並且可在不初始化通訊埠的情況下連線。標準 零售 Android TV 裝置不會自動監聽 ADB 連線;的 這些裝置必須先使用 USB 傳輸線連線至 ADB,然後進行初始化 通訊埠。

  1. 按照下列說明設定開發用的 Android TV 裝置: 為開發做好準備
  2. 在 Android TV 的「裝置」列中選取「網路」>Wi-Fi、 並選取已連線的網路
  3. 選取「狀態資訊」,然後記下「IP 位址」
  4. 如果您的裝置是標準的 Android TV 零售裝置,請按照下列步驟操作:

    1. 請按照下方 透過 USB 傳輸線使用 ADB
    2. 確認您的電腦與 Android 裝置已連上相同的網路 電視。
    3. 在電腦上的終端機中,透過下列方式初始化 TCP/IP 的通訊埠: 輸入以下內容:

      adb tcpip 5555
    4. 移除 USB 傳輸線,然後在終端機中輸入以下內容:

      adb connect Android TV device IP address:5555
      
  5. 如果裝置是開發人員問題的 Android TV,請按照下列步驟操作:

    1. 請確認您的電腦與 Android 裝置連上相同的網路 電視。
    2. 開啟終端機並輸入以下指令:

      adb connect Android TV device IP address:4321
      
  6. 在 Android TV 的「允許 USB 偵錯嗎?」對話方塊中,選取「永遠」 允許在這部電腦上安裝,然後選取確定。您可以驗證連線 且 Android TV 裝置可透過 執行下列指令:

    adb logcat