支援 Google Cast 的 Android TV

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

注意： 本文件假設您已開發出 執行應用程式，因為這項功能必須開啟 安裝在 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。
   注意：這是 不同於 Chromecast 裝置的偵錯選項，請前往 通訊埠 9222 的網路接收端 IP 位址。
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> 觸發的媒體相關事件 元素，例如 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 連線裝置，請按照下列步驟操作：

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