Command and Control (CaC) 工具是功能完善的網頁寄件者,開發人員可測試 Web Receiver 應用程式並進行偵錯。
開發人員可以透過「CaC 工具」:
- 在支援 Cast 的裝置上啟動 Web Receiver 應用程式並傳送載入要求以開始播放媒體。
- 模擬 Google 助理傳送給 Web Receiver 的語音指令。
- 從 Cast 偵錯記錄器擷取記錄,並控制 Web Receiver 偵錯重疊。
啟動 Web Receiver 應用程式
使用 CaC 工具啟動 Web 接收器的方法有兩種:
如何開始新的投放工作階段:
- 開啟 CaC 工具,輸入您的網路接收器應用程式 ID,然後按一下「SET APP ID」(設定應用程式 ID) 按鈕。
按一下「投放」按鈕,然後選取裝置,在支援 Cast 的遠端裝置上啟動 Web 接收器。
如何加入現有的 Cast 工作階段:
請使用以下程式碼,取得執行中的 Cast 工作階段 ID:
在 Web 接收器端,使用以下方法在 Chrome 遠端偵錯工具主控台中取得工作階段 ID:
cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
如要從已連結的網路寄件者取得工作階段 ID,請使用以下方法:
cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
在 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,請先建立下列步驟再建立工作階段:
- 輸入與支援 Cast Connect 的接收器相關聯的接收器應用程式 ID,然後按一下 [設定應用程式 ID]。
- 按一下 [顯示 Android TV 選項] 按鈕。
- 勾選 [androidReceivercompatible] 核取方塊。如果接收器不需要設定
Launch Credentials
,或者您想要測試在未設定的情況下發生的情況,您可以停止並繼續步驟 5。 - (選用) 輸入
Launch Credentials
並按一下「Set Launch Credentials」(設定啟動憑證) 按鈕,以便設定 Cast Connect 工作階段的啟動憑證。 - 按一下標頭中的「投放」圖示,或開啟 Chrome 瀏覽器的「投放」選單,即可開始投放工作階段。
您的 Android TV 應用程式隨即會在裝置上啟動。