註冊

如果您使用樣式化媒體接收器或建構自訂接收器,則必須註冊應用程式。註冊應用程式後,您就會收到應用程式 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 應用程式建構完整的網頁應用程式,才能使用這個選項。

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

    • 樣式化媒體接收器

      如果應用程式使用支援的媒體類型串流播放影片或音訊內容,且您希望在電視上提供使用預設媒體播放器 UI 的使用者介面,或是在預設媒體播放器 UI 頂端的一組自訂樣式組合,請選取此選項。

      您可提供的自訂樣式,可讓您透過提供 CSS 檔案來定義播放器 UI 的各項元素 (例如啟動畫面和進度列) 的外觀。您不需要建構接收器應用程式。

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

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

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

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

    2. 指定網路接收端應用程式的外觀:

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

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

      • 如果是樣式媒體接收器,請在「Skin URL」欄位中指定樣式表的網址。

        提供指向您自家網站上 CSS 檔案的 HTTPS 網址。如要使用預設樣式,請將該欄位留空。日後如要提供或更新自訂樣式,隨時可以編輯。

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

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

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

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

  5. 點選「儲存」

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

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

編輯應用程式資訊

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

如要編輯申請資訊,請按照下列步驟操作:

  1. Google Cast SDK 開發人員控制台的「總覽」或「應用程式」頁面中,按一下「應用程式 ID」,或是找出要編輯的應用程式,然後點選「編輯」
  2. 在「Name」欄位中,更新您在註冊應用程式時提供的名稱。
  3. 如果是自訂接收器應用程式,請在「URL」欄位中更新已註冊的網路接收端應用程式的位置。
  4. 如果是樣式接收器應用程式,請在「Skin URL」欄位中更新應用程式樣式表的位置。
  5. 勾選或取消勾選「支援轉送投放功能」核取方塊。

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

  6. 勾選或取消勾選「支援將內容投放到僅播放音訊的裝置」核取方塊。

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

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

    • Android

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

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

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

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

    注意:您的應用程式必須支援本文說明的媒體類型,以及其他設定隱含的媒體類型。舉例來說,如果您的應用程式支援 Google Cast 音訊廣告,而您在這裡選擇了「電視與電影」,則應用程式必須支援僅提供音訊的裝置,如「音訊裝置」所述,以及影片播放相關條文。

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

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

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

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

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

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

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

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

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

發布應用程式

發布應用程式可讓全球所有 Cast 裝置使用您的應用程式。系統也會在 Google 資源 (例如 chromecast.com/apps) 清單網站建立您的應用程式資訊,讓使用者可以找到並下載您的應用程式。如果您在上述步驟 6 選擇在編輯應用程式資訊時選擇列出您的應用程式,應用程式在發布後就會出現在 chromecast.com/apps

如何發布應用程式:

  1. Google Cast SDK 開發人員控制台中,找到要發布的應用程式,並在「總覽」或「應用程式」頁面按一下「發布」

    如果您的應用程式資訊完整,系統會顯示您在「Edit application information」(編輯應用程式資訊) 中輸入的應用程式資訊。如未提供,系統會顯示一則訊息,說明您需要提供的資訊。

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

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

統計資料

Google Cast SDK 開發人員控制台可追蹤應用程式效能。針對「Applications」或「Overview」頁面中的已發布應用程式,按一下「Stats」欄中的「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 裝置進入開發人員模式,請依序前往「設定」>「系統」>「關於」>「Android TV OS 版本」,然後連續點選幾次,直到裝置通知您處於開發人員模式。如要在開發人員模式中找到序號,請根據您的 ATV 型號依序前往「設定」>「裝置偏好設定」>「內建 Chromecast」,或依序點選「設定」>「系統」>「投放」,即可看到軟體序號。

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

帳戶問題

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

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

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

如果您之前收到我們寄出的電子郵件,指出您的開發人員帳戶因違反《服務條款》或《內容政策》而遭到停權,請回覆該封電子郵件,以便進一步釐清問題。

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

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

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

除非修正違反政策的問題,否則請勿重新發布遭下架的應用程式。

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

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

我有其他問題

請參閱 Cast SDK 支援頁面