如果您使用樣式媒體接收器或建構自訂接收器,就必須註冊應用程式。註冊應用程式後,您會收到應用程式 ID,傳送端應用程式會使用這個 ID 執行 API 呼叫,例如啟動 Web 接收端應用程式。
如果您使用預設媒體接收器,就不需要註冊應用程式。預設媒體接收器不允許您為媒體播放器 UI 提供任何樣式,並使用提供的常數做為應用程式 ID。
此外,您必須註冊 Google Cast 裝置,才能在發布前存取 Web 接收器應用程式。發布接收端應用程式後,所有 Google Cast 裝置都能使用。
應用程式
註冊應用程式後,您可以在發布前,使用已註冊的 Cast 裝置測試應用程式。發布應用程式後,所有 Cast 裝置都能使用。
註冊應用程式
您必須註冊樣式媒體接收端或自訂接收端,才能接收與傳送端應用程式 API 呼叫搭配使用的應用程式 ID。
如要註冊 Cast 應用程式,請按照下列步驟操作:
- 登入 Google Cast SDK 開發人員控制台。
- 在「Overview」(總覽) 頁面或「Applications」(應用程式) 頁面中,按一下「Add New Application」(新增應用程式)。
選取要使用的 Web 接收端應用程式類型:
自訂接收端
如果應用程式需要樣式媒體接收器未提供的使用者介面元件或互動模式,請選取這個選項。如果您的內容類型未列為樣式媒體接收器支援的媒體類型,可能也需要選取自訂接收器。
請注意,這個選項需要您為 Web 接收器應用程式建構完整的網頁應用程式。
詳情請參閱「自訂接收端應用程式」。
樣式化媒體接收器
如果應用程式使用其中一種支援的媒體類型串流影片或音訊內容,且您想在電視上提供使用者介面,請選取這個選項。該介面可使用預設媒體播放器 UI,或在預設媒體播放器 UI 上套用一組自訂樣式。
您可以提供自訂樣式,定義播放器 UI 各種元素的外觀 (例如啟動畫面和進度列),只要提供 CSS 檔案即可,不必建構接收端應用程式。
詳情請參閱「樣式媒體接收器」。
填寫網路接收器應用程式的詳細資料:
在「Name」欄位中輸入應用程式名稱。
如果使用樣式化媒體接收器,這是網路接收器載入或處於閒置狀態時顯示的應用程式名稱。如果您使用自訂接收端,且未透過
setApplicationState方法設定應用程式狀態,這個欄位的值會是應用程式狀態的預設值。指定 Web 接收端應用程式的外觀:
如果是自訂接收端,請在「URL」欄位中指定應用程式網址。
輸入 Google Cast 裝置在載入 Web 接收端應用程式時應要求的網址。在開發期間,網址可以使用 HTTP,但應用程式發布後,必須使用 HTTPS。網址可能是 HTML 網頁或其他可透過網路瀏覽器存取的檔案類型。網路接收器可以位於內部 (NAT 註冊) IP 位址,但不能位於 localhost,因為 localhost 很少是頂層網域。雖然 Web 接收端應用程式發布時必須透過 SSL (HTTPS) 提供,但 Web 接收端應用程式載入的內容可透過 HTTP 提供。
如果是樣式媒體接收器,請在「Skin URL」(外觀網址) 欄位中指定樣式表的網址。
請提供 HTTPS 網址,指向位於您網站上的 CSS 檔案。如要使用預設樣式,請將欄位留空。如要提供或更新自訂樣式,隨時可以編輯。
勾選或取消勾選「支援中繼投放」核取方塊。
轉發投放功能可讓 Web 接收端支援未連上相同 Wi-Fi 網路的傳送端投放內容。如要停用接收端的中繼投放功能,請取消勾選這個方塊。
勾選或取消勾選「Supports casting to audio-only devices」(支援投放到僅限音訊裝置) 核取方塊。
如要允許應用程式搜尋 Google Cast for Audio 裝置,請勾選這個方塊。如要停用純音訊裝置支援,請取消勾選這個方塊。詳情請參閱「音訊裝置」。
按一下「儲存」。
系統會顯示註冊詳細資料,包括應用程式 ID、名稱、類型和狀態。請記下應用程式 ID,因為您需要將其提供給應用程式的 Cast API 呼叫。
按一下「完成」返回「應用程式」頁面。
編輯應用程式資訊
您必須先提供一些額外資訊,才能發布應用程式。您也可以更新註冊時提供的應用程式資訊。
如要編輯應用程式資訊,請按照下列步驟操作:
- 在 Google Cast SDK 開發人員控制台的「Overview」頁面或「Applications」頁面,按一下「應用程式 ID」,或按一下要編輯的應用程式對應的「Edit」。
- 在「Name」(名稱) 欄位中,更新您在註冊應用程式時提供的名稱。
- 如果是自訂接收端應用程式,請在「URL」欄位中,更新已註冊的 Web 接收端應用程式位置。
- 如果是樣式接收器應用程式,請在「Skin URL」(外觀網址) 欄位中,更新應用程式樣式表的位置。
勾選或取消勾選「支援中繼投放」核取方塊。
透過轉送投放功能,Web 接收端可支援與接收端連上不同 Wi-Fi 網路的傳送端投放內容。如要停用接收端的中繼投放功能,請取消勾選這個方塊。
勾選或取消勾選「支援投放到純音訊裝置」核取方塊。
如要允許應用程式搜尋 Google Cast for Audio 裝置,請勾選這個方塊。如要停用純音訊裝置支援功能,請取消勾選這個方塊。詳情請參閱「音訊裝置」。
在「Sender Details」部分,針對應用程式支援的每個平台提供下列資訊:
Android:
- 應用程式套件的完整名稱。
iOS:
- Apple 要求的 iTunes ID 和軟體包 ID。
- 應用程式啟動 URI:使用 Google Home 應用程式啟動應用程式的 URI。如要進一步瞭解必要的 URI 格式,請參閱「使用網址配置與應用程式通訊」。
網頁:
- 應用程式的網站網址。
在「Listing Details」部分,選擇是否要在 Google 資源 (例如 chromecast.com/apps) 上列出應用程式。
在「Category」(類別) 下拉式選單中,選取最符合您應用程式的類別。
注意:應用程式必須支援此處所述的媒體類型,以及其他設定隱含的媒體類型。舉例來說,如果您的應用程式支援 Google Cast 音訊,且您在此處選取「電視和電影」,則應用程式必須支援音訊裝置中所述的僅限音訊裝置,以及影片播放規定。
如要說明應用程式適用的國家/地區,請選取「All countries」或「Only in selected countries」圓形按鈕;如要指定國家/地區,請在顯示的清單中勾選這些國家/地區的方塊。
在「Title」(標題) 欄位中,輸入應用程式的描述性標題。
長度不得超過 50 個半形字元。例如「YouTube」。
在「Description」(說明) 欄位中輸入應用程式說明。
最多 80 個半形字元。例如:「在家中最好的螢幕上觀看喜愛的 YouTube 頻道。」
在「Graphics」(圖片) 部分,按一下加號,上傳應用程式的圖示圖片。
圖片必須為 512 X 512 像素,且可使用透明背景。
在「Add Your Own Translations」下方,如要提供「Title」和「Description」欄位的翻譯,請從下拉式選單中選取語言,然後按一下「Add」,並在隨即顯示的對話方塊中輸入翻譯文字。您也可以上傳該翻譯專用的圖示圖片。
應用程式資訊更新完畢後,請按一下「儲存」。
發布應用程式
發布應用程式後,全球所有 Cast 裝置都能使用該應用程式。此外,系統也會在 Google 資源 (例如 chromecast.com/apps 資訊網站) 上建立應用程式資訊,方便使用者探索及下載應用程式。如果您在上述步驟 6 編輯應用程式資訊時,選擇列出應用程式,應用程式發布後就會顯示在 chromecast.com/apps。
如要發布應用程式,請按照下列步驟操作:
在 Google Cast SDK 開發人員控制台的「總覽」或「應用程式」頁面中,找到要發布的應用程式,然後按一下「發布」。
如果應用程式資訊完整,系統會顯示預覽畫面,其中包含您在「Edit application information」(編輯應用程式資訊) 中輸入的應用程式資訊。如果沒有,系統會顯示訊息,說明您需要提供的資訊。
您可以點選「編輯」返回並更新任何資訊。
如果已準備好發布應用程式,請按一下「發布」。
統計資料
Google Cast SDK 開發人員控制台會追蹤應用程式的效能。在「應用程式」或「總覽」頁面中,按一下「統計資料」欄中的「查看」,即可查看各個已發布應用程式的成效資料。
系統會顯示下列資訊:
- 啟動應用程式的 Cast 接收端數量
- 啟動的工作階段數
- 每個工作階段的平均媒體播放時間 (分鐘)
如果統計資料中顯示「其他」平台,表示傳送者未指明平台,例如舊版 iOS 傳送者未更新。
裝置
根據預設,Google Cast 裝置 (例如 Chromecast 或 Android TV 裝置) 不會啟用開發和測試功能。如要將裝置轉換為開發裝置,並在開發期間存取未發布的 Web 接收器應用程式,您必須向應用程式註冊裝置。註冊後,您也可以透過遠端瀏覽器視窗存取接收器,以便偵錯 (請參閱「偵錯」)。
如何註冊 Google Cast 裝置:
設定 Google Cast 裝置,並連上與電腦相同的 Wi-Fi 網路。
詳情請參閱投放裝置設定操作說明。
在電腦上開啟支援 Cast 的網路瀏覽器。
找出要註冊的裝置序號。
在「總覽」或「裝置」頁面中,按一下「新增裝置」。
輸入裝置序號。
輸入說明,然後按一下「確定」。
這只是裝置的易記名稱,不必與使用者設定期間指定的裝置名稱相同。
請等待十五分鐘,再繼續操作。
註冊完成後,裝置狀態會顯示為「Ready for Testing」(可供測試)。
重新啟動投放裝置:拔除裝置的電源線或 USB 傳輸線,然後重新插回。
查看裝置序號
如要找出任何裝置的序號,可以將 Cast 開發人員控制台頁面投放到裝置:
按一下「投放」按鈕 (就像要投放這個網頁一樣)。
提示會顯示「投放分頁」,並列出可用的裝置。
從下拉式選單中,選取要取得序號的裝置。
- 如果是螢幕裝置,序號會顯示在電視螢幕上,並透過電視喇叭大聲朗讀 (有助於區分 0 和 O)。
- 如果是音訊裝置,投放目標喇叭會朗讀序號。
Android TV 軟體序號
Android TV (ATV) 裝置有多個相關聯的序號。如要取得軟體 (Cast) 序號,請按照上述步驟將 Cast 開發人員控制台頁面投放到 Android TV 裝置,或將 Android TV 裝置設為開發人員模式,然後在 Cast 設定中查看軟體序號。
如要將 ATV 裝置設為開發人員模式,請依序前往「Settings」>「System」>「About」>「Android TV OS build」,然後多次點選版本,直到裝置通知您已進入開發人員模式。進入開發人員模式後,請依序前往「設定」>「裝置偏好設定」>「Google Cast」或「設定」>「系統」>「Cast」(視 Android TV 型號而定),即可查看軟體序號。


請注意,ATV 裝置恢復原廠設定後,軟體序號會變更。恢復原廠設定後,請按照上述步驟找出軟體序號,並在 Cast 開發人員控制台中重新註冊裝置的新軟體序號。
帳戶問題
我想取消註冊 Google Cast 開發人員控制台
$5 美元的開發人員帳戶註冊費無法退款。
我無法再存取 Google Cast 開發人員控制台
如果您先前曾收到我們的電子郵件,指出您的開發人員帳戶因多次違反《服務條款》或《內容政策》而遭到停權,請回覆該電子郵件,要求進一步說明。
我的應用程式已從 Google Cast 下架
應用程式遭到移除,視同系統對開發人員帳戶發出警告,可能影響您的記錄良好。如果多次或嚴重違反政策,開發人員帳戶可能會遭到終止。
下架後,使用者將無法查看或存取該應用程式。如果您的開發人員憑證在 Google Cast 仍維持記錄良好,且應用程式性質允許,您可以修正問題,並發布符合規範的新版應用程式。
在修正違反政策的問題前,請勿重新發布遭下架的應用程式。
我想變更與帳戶相關聯的電子郵件地址
您無法變更與 Google Cast 開發人員帳戶相關聯的電子郵件地址。如果您為機構工作,建議使用團隊電子郵件地址,以免日後發生存取問題。
我有其他問題
請參閱 Cast SDK 支援頁面。