註冊

如果您使用樣式化媒體接收器或建構自訂接收器,則必須註冊應用程式。註冊應用程式後,您會收到應用程式 ID,寄件者應用程式會使用此 ID 來執行 API 呼叫,例如啟動 Web Receiver 應用程式。

如果您使用預設媒體接收器,就不需要註冊應用程式。「預設媒體接收器」不允許您向媒體播放器 UI 提供任何樣式,並使用所提供的常數做為應用程式 ID。

此外,您必須註冊 Google Cast 裝置,它才能在您發布 Web 接收器應用程式後發布應用程式。發布接收器應用程式後,所有 Google Cast 裝置都能使用該應用程式。

應用程式

註冊應用程式後,您就可以在發布應用程式時對已註冊的投放裝置進行測試。發布應用程式後,所有 Cast 裝置都能使用該應用程式。

註冊應用程式

您必須註冊樣式化媒體接收器自訂接收器,才能接收寄件者應用程式用於 API 呼叫的應用程式 ID。

如何註冊 Cast 應用程式:

  1. 登入 Google Cast SDK 開發人員控制台
  2. 在「Overview」(總覽) 頁面或「Applications」(應用程式) 頁面中,按一下「Add New Application」(新增應用程式)
  3. 選取您要使用的 Web Receiver 應用程式類型:

    • 自訂接收器

      如果您的應用程式要求由 Styled Media 接收器提供的使用者介面元件或互動模式,請選取這個選項。如果您的內容類型未列在樣式樣式媒體接收器的支援的媒體類型中,可能也需要選取自訂接收器。

      請注意,您必須針對 Web Receiver 應用程式建構完整的網頁應用程式,才能使用這個選項。

      詳情請參閱自訂接收器應用程式

    • 樣式化媒體接收器

      如果您的應用程式使用其中一種支援的媒體類型串流播放影片或音訊內容,且想在電視上提供使用預設媒體播放器 UI 或預設媒體播放器介面的自訂樣式,請選取這個選項。

      您提供的自訂樣式可讓您提供 CSS 檔案,藉此定義玩家 UI 不同元素 (例如啟動畫面和進度列) 的外觀,無需建構接收器應用程式。

      詳情請參閱樣式化媒體接收器

  4. 填寫您的網路接收器應用程式詳細資料:

    1. 在「Name」(名稱) 欄位中輸入應用程式名稱。

      這是網路接收器載入時,也就是使用 Styled Media 接收器時處於閒置狀態的應用程式名稱。如果您使用自訂接收器,如果沒有使用 setApplicationState 方法設定,這個欄位的值會是應用程式狀態的預設值。

    2. 指定 Web Receiver 應用程式的外觀:

      • 在「自訂接收器」的「網址」欄位中,指定應用程式網址。

        輸入 Google Cast 裝置在載入 Web Receiver 應用程式時應要求的網址。在開發期間,網址可以使用 HTTP,但發布應用程式時必須使用 HTTPS。網址可能是 HTML 網頁或其他網路瀏覽器可存取的檔案類型。您的網路接收器可以位於內部 (NAT 註冊) IP 位址,但不可透過 localhost 使用,因為這類網域很少是頂層網域。雖然 Web Receiver 應用程式在發布時必須透過安全資料傳輸層 (SSL) (HTTPS) 提供,但透過 Web Receiver 應用程式載入的內容可透過 HTTP 提供。

      • 針對「Styled Media Receiver」,在「Skin URL」欄位中,指定樣式工作表的網址。

        提供指向您網站中 CSS 檔案的 HTTPS 網址。如要使用預設樣式,請將欄位留白。如果想要提供或更新自訂樣式,稍後可以編輯。

      • 勾選或取消勾選「支援轉發投放」核取方塊。

        轉送投放功能可讓網路接收器從未與接收器連上相同 Wi-Fi 網路的寄件者投放內容。如要停用接收器的轉發投放功能,請取消勾選這個方塊。

      • 勾選或取消勾選「支援將音訊投放至純音訊裝置」核取方塊。

        為了讓您的應用程式探索音訊裝置的 Google Cast,請勾選這個方塊。如要停用純音訊裝置支援功能,請取消勾選這個方塊。詳情請參閱「音訊裝置」。

  5. 按一下「儲存」。

    系統會顯示您的註冊詳細資料,包括應用程式 ID、名稱、類型和狀態。記下應用程式 ID,因為您將提供應用程式的 Cast API 呼叫。

  6. 按一下「完成」返回「應用程式」頁面。

編輯應用程式資訊

您必須先提供一些額外資訊,才能發布應用程式。您也可以在註冊時更新先前提供的應用程式相關資訊。

如何編輯應用程式資訊:

  1. Google Cast SDK 開發人員控制台的「Overview」(總覽) 頁面或「Applications」(應用程式) 頁面中,按一下「Application ID」(應用程式 ID),或針對要編輯的應用程式按一下「Edit」(編輯)
  2. 在「Name」(名稱) 欄位中,更新您在註冊應用程式時提供的名稱。
  3. 針對自訂接收器應用程式,請在「URL」欄位中更新您註冊的網頁接收器應用程式的位置。
  4. 針對樣式化接收器應用程式,請在「Skin URL」欄位中更新應用程式樣式工作表的位置。
  5. 勾選或取消勾選「支援轉發投放」核取方塊。

    轉送投放功能可讓網路接收器從未與接收器連上相同 Wi-Fi 網路的寄件者投放內容。如要停用接收器的轉發投放功能,請取消勾選這個方塊。

  6. 勾選或取消勾選「支援投放至純音訊裝置」核取方塊。

    為了讓您的應用程式探索音訊裝置的 Google Cast,請勾選這個方塊。 如要停用純音訊裝置支援功能,請取消勾選這個方塊。詳情請參閱「音訊裝置」一文。

  7. 在「寄件者詳細資料」部分中,為應用程式支援的每個平台提供以下內容:

    • Android

      • 應用程式套件的完整名稱,
    • iOS

      • Apple 需要的 iTunes ID軟體包 ID
      • 應用程式啟動 URI,使用 Google Home 應用程式用來啟動應用程式的 URI。如要進一步瞭解所需的 URI 格式,請參閱使用網址配置與應用程式通訊一文。
    • 網頁

      • 網站網址。
  8. 在「Listing Details」(清單詳細資料) 部分中,選擇是否要在 Google 資源 (例如 chromecast.com/apps) 上列出您的應用程式。

  9. 在「Category」下拉式選單中,選取最符合應用程式的類別。

    注意:您的應用程式必須支援本節所述的媒體類型,以及其他設定隱含的類型。舉例來說,如果您的應用程式支援 Google Cast 音訊,而且在此選取電視和電影,那麼您的應用程式必須支援純音訊裝置所述的音訊專屬裝置,以及影片播放方面的規定。

  10. 如要描述應用程式適用的國家/地區,請選取「所有國家/地區」或「僅在部分國家/地區」圓形按鈕;如果指定國家/地區,請在顯示的清單中勾選這些國家/地區對應的方塊。

  11. 在「標題」欄位中,為您的應用程式提供描述性的標題。

    最多只能使用 50 個字元。例如「YouTube」。

  12. 在「說明」欄位中輸入應用程式的說明。

    最多只能使用 80 個字元。例如:「在家工作最優質的 YouTube 頻道,

  13. 在「Graphics」區段中,按一下加號來上傳應用程式的圖示圖片。

    圖片尺寸必須為 512 X 512 像素,並使用透明背景。

  14. 如果您想為「Title」和「Description」欄位提供翻譯,請在下拉式選單中選取語言,按一下「Add」,然後在隨即顯示的對話方塊中輸入譯文;您也可以上傳該譯文專用的圖示圖片。

  15. 應用程式資訊更新完成後,請按一下「儲存」

發布應用程式

發布應用程式後,世界各地的所有投放裝置都能使用你的應用程式。也會在 Google 資源 (例如 chromecast.com/apps) 清單網站,建立您的應用程式資訊,讓使用者可以找到並下載您的應用程式。如果您在步驟 6 編輯應用程式資訊時,已經列出該應用程式的清單,那麼應用程式發布後,就會顯示在 chromecast.com/apps 中。

如何發布應用程式:

  1. Google Cast SDK 開發人員控制台 (從「Overview」頁面或「Applications」頁面) 中,找出您要發布的應用程式,然後按一下「Publish」

    如果您的應用程式資訊完整,畫面上會出現預覽畫面,其中顯示您在「編輯應用程式資訊」中輸入的應用程式資訊。如果不是,系統會顯示訊息,說明您需要提供的資訊。

  2. 按一下「編輯」即可返回並更新任何資訊。

  3. 如果您已準備好發布應用程式,請按一下「Publish」

統計資料

Google Cast SDK 開發人員控制台可讓您追蹤應用程式的效能。針對「應用程式」或「總覽」頁面中各個已發布的應用程式,按一下「統計資料」欄中的「查看」,即可查看效能資料。

如下所示:

  • 啟動應用程式的 Cast 接收器數量
  • 工作階段數
  • 每個工作階段的平均媒體播放時間 (分鐘)

如果統計資料中顯示「其他」平台,表示傳送者未指明平台,例如當舊的 iOS 寄件者尚未更新時。

裝置

根據預設,Google Cast 裝置 (例如 Chromecast 或 Android TV 裝置) 並未開發及測試。如要將裝置變成開發裝置,並在開發期間存取未發布的 Web Receiver 應用程式,您必須向裝置註冊該裝置。此外,註冊後,還能透過遠端瀏覽器視窗存取接收器,以進行偵錯 (請參閱「偵錯」)。

如何註冊 Google Cast 裝置:

  1. 設定 Google Cast 裝置,然後將其連接至與電腦相同的 Wi-Fi 網路。

    詳情請參閱 Cast 裝置設定操作說明。

  2. 在電腦上開啟支援 Cast 的網路瀏覽器。

  3. 登入 Google Cast SDK 開發人員控制台

  4. 在「總覽」頁面或「裝置」頁面中,按一下「新增裝置」

  5. 輸入裝置的序號。

  6. 輸入說明內容,然後按一下「確定」

    這個名稱只是裝置好記的名稱 (不需要與您在使用者設定期間提供的裝置名稱相符)。

  7. 等待十五分鐘再繼續操作。

    註冊完成後,裝置狀態會顯示為「Ready to Testing」。

  8. 重新啟動投放裝置:拔除裝置的電源或 USB 傳輸線,然後重新連線。

尋找裝置序號

如要尋找任何裝置的序號,您可以將投放開發人員控制台頁面投放到裝置:

  1. 按一下「投放」按鈕 (就像投放這個頁面時一樣)。

    提示會顯示「投放」分頁,並列出可用的裝置。

  2. 從下拉式選單中選取要取得序號的裝置。

    • 如果是顯示裝置,電視螢幕上會顯示序號,並會在電視上朗讀 (例如,清楚區別 0 和 O)。
    • 如果是音訊裝置,系統會在投放的揚聲器上朗讀序號。

Android TV 軟體序號

Android TV (ATV) 裝置有多個相關聯的序號。如要取得軟體 (投放) 序號,方法有兩種,例如將 Cast Developer Console 的頁面投放至 ATV 裝置,或是讓 ATV 裝置進入開發人員模式,然後查看軟體序號的 Cast 設定。

如要將 ATV 裝置設為開發人員模式,請依序前往「Settings」>「System」>「About」>「Android TV OS build」,然後按一下建構數次,直到裝置通知您已進入開發人員模式。如要在開發人員模式下尋找序號,視 ATV 型號而定,請依序前往「設定」>「裝置偏好設定」>「Chromecast 內建」或「設定」>「系統」>「投放」,即可看到軟體序號。

請注意,ATV 裝置恢復原廠設定時,軟體序號也會隨之變更。恢復原廠設定後,請按照上述步驟找出軟體序號,然後使用 Cast 開發人員控制台重新註冊裝置的新軟體序號。

帳戶問題

我想取消 Google Cast 開發人員控制台註冊

$5 美元的開發人員帳戶註冊費無法退款。

我無法再存取 Google Cast 開發人員控制台

如果您先前曾收到我們的電子郵件,指出您的開發人員帳戶屢次違反《服務條款》或《內容政策》而遭停權,請回覆這封電子郵件來提供進一步說明,

我的應用程式已從 Google Cast 中移除

移除的應用程式會計入您開發人員帳戶的良好記錄,因此您的警告會計入良好記錄。屢次或嚴重違反政策可能導致您的開發人員帳戶遭到終止。

移除後,使用者就無法查看或存取已移除的應用程式。如果您的開發人員憑證在 Google Cast 中仍維持良好記錄,且適用於應用程式的性質,您可以進行修正,然後發布符合規範的新應用程式執行個體。

請先修正違反政策的問題,再重新發布已移除的應用程式。

我想變更與我的帳戶相關聯的電子郵件地址

您無法變更與 Google Cast 開發人員帳戶相關聯的電子郵件地址。如果你是機構機構,建議使用團隊電子郵件地址,以免日後發生存取問題。

我有其他問題

請參閱 Cast SDK 支援頁面