指令與控制 (CaC) 工具

Command and Control (CaC) 工具是功能完善的網頁寄件者，開發人員可測試 Web Receiver 應用程式並進行偵錯。

開發人員可以透過「CaC 工具」：

  • 在支援 Cast 的裝置上啟動 Web Receiver 應用程式並傳送載入要求以開始播放媒體。
  • 模擬 Google 助理傳送給 Web Receiver 的語音指令。
  • 從 Cast 偵錯記錄器擷取記錄，並控制 Web Receiver 偵錯重疊。

啟動 Web Receiver 應用程式

使用 CaC 工具啟動 Web 接收器的方法有兩種：

  1. 如何開始新的投放工作階段：

    1. 開啟 CaC 工具，輸入您的網路接收器應用程式 ID，然後按一下「SET APP ID」(設定應用程式 ID) 按鈕。

    2. 按一下「投放」按鈕，然後選取裝置，在支援 Cast 的遠端裝置上啟動 Web 接收器。

  2. 如何加入現有的 Cast 工作階段：

    1. 請使用以下程式碼，取得執行中的 Cast 工作階段 ID：

      在 Web 接收器端，使用以下方法在 Chrome 遠端偵錯工具主控台中取得工作階段 ID：

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;

      如要從已連結的網路寄件者取得工作階段 ID，請使用以下方法：

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();

    2. 在 CaC 工具中輸入工作階段 ID，然後按一下 [恢復] 按鈕。

當「CaC 工具」連線至 Web Receiver 應用程式時，「投放」按鈕會呈現填滿畫格的外框形狀。網路接收器應用程式 ID 和工作階段 ID 也會顯示在工具頂端。

載入媒體

從寄件者應用程式或 CaC 工具載入媒體。

寄件者應用程式

如要在網路接收器上播放媒體，請將傳送者應用程式投放至支援 Cast 的同一部裝置，並將傳送應用程式的要求傳送至網路接收器。

CaC 工具

CaC 工具也提供透過多種方式將載入要求傳送至 Web Receiver 應用程式：

依實體載入 (語音投放)

當使用者透過 Google 助理啟動媒體播放時，Google 助理會使用命令與控制 (CaC) 訊息，將使用者憑證和實體傳送給您的網路接收器。

CaC 工具會模擬語音投放，並使用 credentials 和 entity 傳送載入要求。

依內容載入

CaC 工具也可以模擬您的應用程式透過 Content ID 或 Content Url 傳送載入要求。

媒體播放開始時，CaC 工具會從您的 Web Receiver 應用程式接收媒體狀態訊息，並顯示在「MEDIA STATUS」(媒體狀態) 分頁中。

自訂載入要求

如要使用自己的 Load Request 物件測試接收器，請使用「LOAD MEDIA」(載入媒體) 分頁下方的「Custom Load Request」(自訂載入要求) 欄位。首先，從「Select Request Type」圓形按鈕選取要求類型，然後複製或建立自己的 JSON 物件。

測試語音指令

CaC 工具也會模擬 Google 助理傳送到網頁接收器應用程式的語音指令。您可以測試應用程式支援的媒體指令是否正常運作。您必須使用適當的錯誤類型和錯誤原因來處理不支援的媒體指令。

檢查及控制 Cast Debug Logger

如果您的網路接收器應用程式啟用投放偵錯記錄工具，CaC 工具會擷取記錄訊息並控制 Web Receiver 偵錯重疊。

請使用以下按鈕控制網路接收器和記錄訊息：

  • Web Receiver 應用程式 ID
    • 清除快取和停止 Web Receiver - 重新載入 Web Receiver 應用程式並停止投放
  • 網路接收器偵錯疊加層
    • 顯示：在網路接收器上切換偵錯重疊顯示
    • 「Clear」(清除)：清除 Web Receiver 偵錯重疊事件上的記錄訊息
  • 記錄訊息控制項
    • 插入訊息 - 在記錄區域中插入註解或分隔線
    • 下載記錄 - 儲存記錄訊息
    • 「Clear Log」(清除記錄)：清除記錄區域中的記錄訊息
  • 記錄訊息
    • 自訂標記：勾選核取方塊即可篩選記錄訊息

以下標記可能會顯示在「自訂標記」下方。這些項目由 CA 工具新增，以顯示及篩選與偵錯工作階段相關的重要記錄或訊息：

  • MEDIA - 成功透過媒體命名空間傳送的訊息
  • MEDIA-ERROR - 傳送或回應透過媒體命名空間傳送的訊息時發生錯誤
  • CAC：成功透過 CAC 命名空間傳送的郵件
  • CAC-ERROR：傳送或回應透過 CAC 命名空間傳送的訊息時發生錯誤
  • PLAYING：在 CaC 工具中點選「What's Playing」按鈕時，系統顯示結果的記錄
  • USER - 記錄使用者為自訂工具訊息所輸入的自訂訊息 (在 CaC 工具中使用 [Insert Message] 按鈕)

測試 Cast Connect

如要測試 Cast Connect，請先建立下列步驟再建立工作階段：

  1. 輸入與支援 Cast Connect 的接收器相關聯的接收器應用程式 ID，然後按一下 [設定應用程式 ID]。
  2. 按一下 [顯示 Android TV 選項] 按鈕。
  3. 勾選 [androidReceivercompatible] 核取方塊。如果接收器不需要設定 Launch Credentials，或者您想要測試在未設定的情況下發生的情況，您可以停止並繼續步驟 5。
  4. (選用) 輸入 Launch Credentials 並按一下「Set Launch Credentials」(設定啟動憑證) 按鈕，以便設定 Cast Connect 工作階段的啟動憑證。
  5. 按一下標頭中的「投放」圖示，或開啟 Chrome 瀏覽器的「投放」選單，即可開始投放工作階段。

您的 Android TV 應用程式隨即會在裝置上啟動。

上一頁
Cast 偵錯記錄
下一頁
Chrome 遠端偵錯工具