注册

如果您使用的是样式化媒体接收器或正在构建自定义接收器,则必须注册应用。注册应用后,您将收到一个应用 ID,发送端应用会使用该 ID 执行 API 调用,例如启动 Web 接收器应用。

如果您使用默认媒体接收器,则无需注册应用。默认媒体接收器不允许您为媒体播放器界面提供任何样式,并使用提供的常量作为应用 ID。

此外,您还必须注册 Google Cast 设备,以便该设备在您发布 Web 接收器应用之前可以访问该应用。发布接收器应用后,所有 Google Cast 设备都可以使用该应用。

应用

注册应用后,您可以在发布应用之前,在已注册的 Cast 设备上测试该应用。发布应用后,所有 Cast 设备都可以使用该应用。

注册应用

您必须注册样式化媒体接收器或自定义接收器,才能接收与发送器应用中的 API 调用搭配使用的应用 ID。

如需注册您的 Cast 应用,请执行以下操作:

  1. 登录 Google Cast SDK 开发者控制台。
  2. 在概览页面或应用页面中,点击添加新应用。
  3. 选择您要使用的 Web 接收器应用类型:

    • 自定义接收器

      如果您的应用需要样式化媒体接收器未提供的界面组件或互动模式,请选择此选项。如果您的内容类型未列为样式化媒体接收器支持的媒体类型之一,您可能还需要选择自定义接收器。

      请注意,此选项要求您为 Web 接收器应用构建完整的 Web 应用。

      如需了解详情,请参阅自定义接收器应用。

    • 样式化媒体接收器

      如果您的应用使用某种受支持的媒体类型流式传输视频或音频内容,并且您希望在电视上提供使用默认媒体播放器界面或在默认媒体播放器界面之上使用一组自定义样式的界面,请选择此选项。

      您提供的自定义样式可让您定义播放器界面各种元素(例如启动画面和进度条)的外观,只需提供 CSS 文件即可,无需构建接收器应用。

      如需了解详情,请参阅样式化媒体接收器。

  4. 填写 Web 接收器应用的详细信息:

    1. 在名称字段中,输入应用名称。

      这是 Web 接收器加载时或处于空闲状态时(如果您使用的是样式化媒体接收器)显示的应用名称。如果您使用的是自定义接收器,则此字段的值是应用状态的默认值(如果未使用 setApplicationState 方法设置)。

    2. 指定 Web 接收器应用的外观:

      • 对于自定义接收器,请在网址字段中指定应用网址。

        输入 Google Cast 设备在加载 Web 接收器应用时应请求的网址。在开发期间,该网址可以使用 HTTP,但在应用发布后,该网址必须使用 HTTPS。该网址可能指向 HTML 网页或可通过网络浏览器访问的其他文件类型。Web 接收器可以位于内部(NAT 注册)IP 地址上,但不能位于 localhost 上,因为 localhost 很少是顶级域名。虽然 Web 接收器应用在发布时必须通过 SSL (HTTPS) 提供,但 Web 接收器应用上加载的内容可以通过 HTTP 提供。

      • 对于样式化媒体接收器,请在皮肤网址字段中指定样式表的网址。

        提供一个 HTTPS 网址,指向您自己网站上的 CSS 文件。如需使用默认样式,请将该字段留空。如果您想提供或更新自定义样式,可以随时在稍后进行修改。

      • 勾选或取消选中支持中继投放复选框。

        中继投放功能可让 Web 接收器支持从与接收器未连接到同一 Wi-Fi 网络的发送器进行投放。如需为接收器停用中继投放,请取消选中此复选框。

      • 勾选或取消勾选支持投放到纯音频设备复选框。

        如需允许您的应用发现 Google Cast for Audio 设备,请选中此复选框。如需停用对纯音频设备的支持,请取消选中此复选框。如需了解详情,请参阅音频设备。

  5. 点击保存。

    系统会显示您的注册详细信息,包括应用 ID、名称、类型和状态。记下应用 ID,因为您需要在应用的 Cast API 调用中提供该 ID。

  6. 点击完成,返回“应用”页面。

修改应用信息

在发布应用之前,您必须提供一些额外信息。您还可以更新注册期间提供的应用相关信息。

如需修改应用信息,请执行以下操作:

  1. 在 Google Cast SDK 开发者控制台中,从概览页面或应用页面中,点击应用 ID,或点击要修改的应用对应的修改。
  2. 在名称字段中,更新您在注册应用时提供的名称。
  3. 对于自定义接收器应用,请在网址字段中更新您已注册的 Web 接收器应用的位置。
  4. 对于样式化接收器应用,请在皮肤网址字段中更新应用的样式表的位置。
  5. 勾选或取消选中支持中继投放复选框。

    借助中继投放,Web 接收器可以支持从发送器进行投放,而无需连接到与接收器相同的 Wi-Fi 网络。如需为接收器停用中继投放,请取消选中此复选框。

  6. 选中或取消选中支持投放到纯音频设备复选框。

    如需允许您的应用发现 Google Cast for Audio 设备,请选中此复选框。 如需停用对纯音频设备的支持,请取消选中此复选框。如需了解详情,请参阅音频设备。

  7. 在发送者详细信息部分中,为应用支持的每个平台提供以下信息:

    • Android:

      • 应用软件包的完全限定名称。
    • iOS:

      • Apple 要求的 iTunes ID 和软件包 ID。
      • 应用启动 URI,使用 Google Home 应用启动您的应用时所用的 URI。如需详细了解所需的 URI 格式,请参阅使用网址协议与应用通信。
    • Web:

      • 应用的网站网址。
  8. 在清单详情部分中,选择是否在 Google 产品和服务(例如 chromecast.com/apps)中列出您的应用。

  9. 从类别下拉菜单中,选择最能描述您的应用的类别。

    注意:您的应用必须支持此处所述的媒体类型以及其他设置所暗示的媒体类型。例如,如果您的应用支持 Google Cast 音频,并且您在此处选择“电视和电影”,则您的应用必须支持音频设备中所述的纯音频设备,以及视频播放的相关规定。

  10. 如需描述您的应用在哪些国家/地区提供,请选择所有国家/地区或仅在所选国家/地区单选按钮;如果指定国家/地区,请在显示的列表中勾选这些国家/地区的复选框。

  11. 在标题字段中,为应用提供一个描述性标题。

    字符数不得超过 50 个。例如“YouTube”。

  12. 在说明字段中,输入应用的说明。

    最多只能使用 80 个字符。例如,“在家中最好的屏幕上畅享您喜爱的 YouTube 频道。”

  13. 在图形部分中,点击加号以上传应用的图标图片。

    图片必须为 512 X 512 像素,并且可以具有透明背景。

  14. 在添加您自己的翻译下,如果您想为标题和说明字段提供翻译,请从下拉菜单中选择语言,点击添加,然后在显示的对话框中输入翻译后的文本;您还可以为该翻译上传特定的图标图片。

  15. 更新完应用信息后,点击保存。

发布您的应用

发布应用后,全球所有 Cast 设备都可以使用该应用。它还会在 Google 产品和服务(例如 chromecast.com/apps 列表网站)上为您的应用创建商品详情,用户可以在其中发现和下载您的应用。如果您在上述第 6 步中修改应用信息时选择列出应用,则应用发布后会显示在 chromecast.com/apps 中。

如需发布应用,请执行以下操作:

  1. 在 Google Cast SDK 开发者控制台中,从概览页面或应用页面中,针对要发布的应用点击发布。

    如果您的应用信息完整,系统会显示一个预览界面,其中包含您在修改应用信息中输入的应用信息。如果未提供,系统会显示一条消息,说明您需要提供的信息。

  2. 您可以点击修改,返回并更新任何信息。

  3. 如果您已准备好发布应用,请点击发布。

统计信息

Google Cast SDK 开发者控制台会跟踪应用的性能。对于“应用”或“概览”页面中的每个已发布应用,您都可以通过点击统计信息列中的查看来查看性能数据。

系统会显示以下信息:

  • 启动了应用的 Cast 接收器数量
  • 启动的会话数
  • 每次会话的平均媒体播放时长(分钟)

如果统计信息中显示其他平台,则表示发送端尚未指明其平台;例如,如果较旧的 iOS 发送端尚未更新。

设备

默认情况下,Google Cast 设备(例如 Chromecast 或 Android TV 设备)未启用开发和测试功能。如需将设备转换为开发设备,并在开发期间访问未发布的 Web 接收器应用,您必须向应用注册该设备。注册后,您还可以从远程浏览器窗口访问接收器以进行调试(请参阅调试)。

如需注册 Google Cast 设备,请执行以下操作:

  1. 设置 Google Cast 设备,并将其连接到计算机所连接的同一 Wi-Fi 网络。

    如需了解详情,请参阅 Cast 设备设置说明。

  2. 在电脑上,打开支持 Cast 的网络浏览器。

  3. 登录 Google Cast SDK 开发者控制台。

  4. 找到您要注册的设备的序列号。

  5. 在“概览”页面或“设备”页面中,点击添加新设备。

  6. 输入设备的序列号。

  7. 输入说明,然后点击确定。

    这只是设备的易记名称(无需与您在用户设置期间为设备指定的名称一致)。

  8. 等待 15 分钟,然后再继续。

    注册完成后,设备的状态将显示为“可供测试”。

  9. 重启 Cast 设备:断开设备的电源或 USB 线,然后重新连接。

查找设备序列号

如需查找任何设备的序列号,您可以将 Cast 开发者控制台页面投射到该设备:

  1. 点击“投放”按钮(就像您要投放此页面一样)。

    系统会显示投放标签页提示,并列出可用设备。

  2. 从下拉菜单中,选择您要获取其序列号的设备。

    • 对于显示设备,序列号会显示在电视屏幕上,并通过电视扬声器大声朗读(以帮助区分 0 和 O)。
    • 对于音频设备,序列号会在正在投放内容的音箱上大声朗读出来。

Android TV 软件序列号

Android TV (ATV) 设备有多个关联的序列号。软件 (Cast) 序列号可以通过以下两种方式获取:如上所述,将 Cast 开发者控制台页面投射到 ATV 设备;或者将 ATV 设备置于开发者模式,然后在 Cast 设置中查找软件序列号。

如需将 ATV 设备置于开发者模式,请依次前往设置 > 系统 > 关于 > Android TV 操作系统版本,然后多次点击该版本,直到设备通知您已进入开发者模式。进入开发者模式后,如需查找序列号,请依次前往设置 > 设备偏好设置 > Google Cast 或设置 > 系统 > Cast(具体取决于您的 ATV 型号),您会看到显示的软件序列号。

请注意,当 ATV 设备恢复出厂设置时,软件序列号会发生变化。恢复出厂设置后,请按照上述步骤查找软件序列号,并在 Cast 开发者管理中心重新注册设备的新软件序列号。

账号问题

我想取消 Google Cast 开发者管理中心注册

5 美元的开发者账号注册费不予退还。

我无法再访问 Google Cast 开发者控制台

如果您之前收到过我们的电子邮件,其中指出您的开发者账号因多次违反我们的服务条款或内容政策而被中止,请回复该电子邮件,以便我们进一步说明。

我的应用已从 Google Cast 移除

应用被下架会对您的开发者账号信誉造成不利影响。多次或严重违反政策可能会导致您的开发者账号被终止。

移除意味着用户将无法查看或访问已移除的应用。如果您的开发者凭据在 Google Cast 中仍然状态正常,并且您的应用符合可重新发布的条件,那么您可以进行更正并发布符合政策的新版应用。

在违反政策的问题得到解决之前,请勿重新发布下架的应用。

我想更改与账号关联的邮箱

您无法更改与 Google Cast 开发者账号关联的邮箱。如果您为某个组织工作,我们建议您使用团队邮箱,以免日后出现访问权限问题。

我还有一个问题

请参阅 Cast SDK 支持页面。