註冊

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

如果您使用預設媒體接收器,則不必註冊應用程式。預設媒體接收器不允許為媒體播放器 UI 提供任何樣式,而是使用所提供的常數做為應用程式 ID。

此外,您必須註冊 Google Cast 裝置,才能讓該裝置在發布之前存取您的 Web Receiver 應用程式。發布接收器應用程式後,所有 Google Cast 裝置皆可使用該應用程式。

應用程式

註冊應用程式後,就能在發布應用程式前,在已註冊的投放裝置上進行測試。一旦發布應用程式,所有投放裝置都可使用。

註冊應用程式

您必須註冊樣式化媒體接收器自訂接收器,才能接收與傳送方應用程式 API 呼叫搭配使用的應用程式 ID。

如何註冊 Cast 應用程式:

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

    • 自訂接收器

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

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

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

    • 樣式化媒體接收器

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

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

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

  4. 填寫 Web Receiver 應用程式的詳細資料:

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

      這是在載入網路接收器時顯示的應用程式名稱;如果您使用樣式化媒體接收器,則會處於閒置狀態。如果您使用自訂接收器,這個欄位的值會是應用程式狀態的預設值 (如果未使用 setApplicationState 方法進行設定)。

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

      • 如果是「自訂接收器」,請在「URL」欄位中指定應用程式網址。

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

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

        提供指向您自有網站的 CSS 檔案的 HTTPS 網址。如要使用預設樣式,請將此欄位留白。您之後隨時可以提供或更新自訂樣式。

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

        透過 Relay 投放功能,網路接收器支援從未連線到與接收器相同 Wi-Fi 網路的寄件者投放內容。如要停用接收器的轉送投放功能,請取消勾選這個方塊。

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

        如要允許應用程式尋找適用於音訊裝置的 Google Cast,請勾選此方塊。如要停用音訊裝置的支援,請取消勾選這個方塊。詳情請參閱「音訊裝置」。

  5. 點按「儲存」

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

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

編輯應用程式資訊

發布應用程式之前,您必須提供一些額外資訊。您也可以在註冊期間更新有關應用程式的資訊。

如何編輯申請資訊:

  1. Google Cast SDK Developer Console 的「Overview」(總覽) 或「Applications」(應用程式) 頁面中,按一下「Application ID」(應用程式 ID),或是找到您要編輯的應用程式,按一下「Edit」(編輯)
  2. 在「Name」欄位中,更新您在註冊應用程式時提供的名稱。
  3. 如果是自訂接收器應用程式,請在「URL」欄位中,更新您所註冊的 Web Receiver 應用程式位置。
  4. 如果是樣式化接收器應用程式,請在「Skin URL」欄位中更新應用程式樣式表的位置。
  5. 勾選或取消勾選「支援轉送投放」核取方塊。

    如果傳送者未連線到與接收器相同的 Wi-Fi 網路,網路接收端即可透過轉送投放功能,支援投放內容。如要停用接收器的轉送投放功能,請取消勾選這個方塊。

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

    如要允許應用程式尋找適用於音訊裝置的 Google Cast,請勾選這個方塊。 如要停用音訊裝置支援功能,請取消勾選這個方塊。詳情請參閱「音訊裝置」。

  7. 在「Sender Details」部分,為應用程式支援的每個平台提供下列資訊:

    • Android

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

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

      • 應用程式的網站網址。
  8. 在「Listing Details」部分,選擇是否要在 chromecast.com/apps. 等 Google 資源上列出您的應用程式。

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

    注意:您的應用程式必須支援本文所述的媒體類型,以及其他設定隱含的媒體類型。舉例來說,如果您的應用程式支援 Google Cast 的音訊功能,而您在這裡選取 [電視與電影],則應用程式必須如音訊裝置中所述,支援純音訊裝置,以及有關影片播放的規定。

  10. 如要說明應用程式的供應國家/地區,請選取「All countries」或「Only in selected countries」圓形按鈕。如果指定了國家/地區,請在隨即顯示的清單中勾選這些國家/地區的方塊。

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

    長度不得超過 50 個半形字元。例如「YouTube」。

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

    不得超過 80 個半形字元。例如 「在家中最棒的螢幕觀看喜愛的 YouTube 頻道」。

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

    圖片必須是 512 X 512 像素,且可以使用透明背景。

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

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

發布應用程式

發布應用程式後,全世界所有投放裝置都能使用您的應用程式。此外,這項作業也會在 Google 資源 (例如 chromecast.com/apps 清單網站) 上建立應用程式清單,讓使用者可在此找到並下載您的應用程式。如果您在步驟 6 中編輯應用程式資訊後選擇列出應用程式,則應用程式在發布後會顯示在 chromecast.com/apps 中。

如要發布應用程式:

  1. Google Cast SDK Developer Console 的「Overview」(總覽) 或「Applications」(應用程式) 頁面中,針對要發布的應用程式按一下「Publish」(發布)

    如果您的應用程式資訊完整,系統會顯示預覽畫面,其中包含您在編輯應用程式資訊中輸入的應用程式資訊。如果沒有,系統會顯示訊息,說明您需要提供的資訊。

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

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

統計資料

Google Cast SDK 開發人員控制台追蹤應用程式效能。在「Applications」或「Overview」頁面中,您可以點選「Statistics」資料欄中的「View」,查看各個已發布應用程式的效能資料。

報告會顯示以下資訊:

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

如果統計資料中出現「Other」平台,表示傳送者尚未指出其平台;例如,較舊的 iOS 傳送者尚未更新。

裝置

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

如何註冊 Google Cast 裝置:

  1. 設定 Google Cast 裝置,並連線至與電腦相同的 Wi-Fi 網路。

    詳情請參閱「投放裝置設定」操作說明。

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

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

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

  5. 輸入裝置的序號。

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

    這只是裝置的簡單易懂名稱,不需和您在使用者設定期間為裝置取的名稱相同。

  7. 請等待 15 分鐘再繼續操作。

    註冊完成後,裝置的「狀態」會顯示為「已可測試」。

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

尋找裝置序號

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

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

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

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

    • 如果是顯示裝置,電視螢幕會顯示序號,並且透過電視喇叭大聲朗讀 (協助區分 0 和 O)。
    • 如果是音訊裝置,系統會在要投放的揚聲器上大聲讀出序號。

Android TV 軟體序號

Android TV (ATV) 裝置有多個相關聯的序號。如要取得軟體 (Cast) 序號,方法包括將 Cast 開發人員控制台頁面投放至 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 支援頁面