注册

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

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

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

应用

通过注册应用,您可以在发布应用之前针对已注册的 Cast 设备对其进行测试。应用发布后,将可供所有投放设备使用。

注册应用

您必须注册样式化媒体接收器自定义接收器,才能从发送器应用接收用于 API 调用的应用 ID。

要注册 Cast 应用,请执行以下操作:

  1. 登录 Google Cast SDK 开发者控制台
  2. Overview 页面或 Applications 页面,点击 Add New Application
  3. 选择您将使用的 Web 接收器应用类型:

    • 自定义接收器

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

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

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

    • 自定样式的媒体接收器

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

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

      如需了解详情,请参阅自定样式的媒体接收器

  4. 填写 Web Receiver 应用的详细信息:

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

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

    2. 指定 Web Receiver 应用的外观:

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

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

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

        提供指向位于您自己网站上的 CSS 文件的 HTTPS 网址。要使用默认样式,请将此字段留空。如果您想提供或更新自定义样式,日后可以随时修改此值。

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

        借助中继投放功能,网络接收器可支持来自与接收器连接到不同 Wi-Fi 网络的发送端进行投射。如需为接收器停用中继投放功能,请取消选中此框。

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

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

  5. 点击保存

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

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

修改应用信息

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

要修改应用信息,请按以下步骤操作:

  1. Google Cast SDK 开发者控制台概览页面或应用页面中,点击应用 ID 或点击您要修改的应用的修改
  2. Name 字段中,更新您在注册应用时提供的名称。
  3. 对于自定义接收器应用,请在网址字段中,更新您已注册的网络接收器应用的位置。
  4. 对于样式化接收器应用,在皮肤网址字段中,更新应用的样式表的位置。
  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. 类别下拉菜单中,选择最能描述您的应用的类别。

    注意:您的应用必须支持本文所述的媒体类型以及其他设置暗含的媒体类型。例如,如果您的应用支持 Google Cast 音频版,并且您在此处选择了“电视节目和电影”,那么该应用必须支持纯音频设备(如音频设备中所述)以及视频播放配置。

  10. 如需说明您的应用面向哪些国家/地区提供,请选择所有国家/地区仅限在选定的国家/地区单选按钮;如果要指定国家/地区,请在随即显示的列表中选中这些国家/地区对应的复选框。

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

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

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

    不得超过 80 个字符。例如,“在家中最好的屏幕上欣赏你喜爱的 YouTube 频道。”

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

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

  14. Add Your Own Translations 下,如果您要为 TitleDescription 字段提供翻译,请从下拉菜单中选择语言,点击 Add,然后在显示的对话框中输入译文;您还可以上传特定于该翻译的图标的图片。

  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 网络。

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

  2. 在计算机上,打开支持 Cast 的网络浏览器。

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

  4. 查找

  5. 在“Overview”(概览)页面或“Devices”(设备)页面,点击 Add New Device(添加新设备)。

  6. 输入设备的序列号。

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

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

  8. 等待十五分钟后再继续。

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

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

查找设备序列号

如需查找任何设备的序列号,您可以将 Cast Developer Console 页面投射到相应设备:

  1. 点击“投射”按钮(就像您在投射此网页一样)。

    提示会显示“投射”标签页并列出可用设备。

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

    • 对于显示设备,序列号显示在电视屏幕上,并在电视音响上大声读出(以帮助消除 0 和 O 的歧义)。
    • 对于音频设备,系统会在投放到的音响设备上大声读出序列号。

Android TV 软件序列号

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

如需将 ATV 设备置于开发者模式,请依次转到设置 > 系统 > 关于 > Android TV OS build,然后点击相应 build 多次,直到设备通知您处于开发者模式。如需在开发者模式下找到序列号一次,请依次转到设置 > 设备偏好设置 > 内置 Chromecast设置 > 系统 > Cast(具体取决于您的 ATV 型号),然后便会看到软件序列号。

请注意,将 ATV 设备恢复出厂设置后,软件序列号将会更改。恢复出厂设置后,请按照上述步骤找到软件序列号,并在 Cast Developer Console 中重新注册设备的新软件序列号。

账号问题

我想取消 Google Cast Developer Console 注册

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

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

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

我的应用已从 Google Cast 中移除

遭到移除的应用将被视为警示,会对您的开发者帐号的良好信誉造成不利影响。多次或严重违反政策可能会导致您的开发者帐号被终止。

移除意味着用户将无法查看或访问已移除的应用。如果您的开发者凭据在 Google Cast 中仍然保有良好信誉,且您的应用符合要求,那么您可以进行更正并发布符合政策的新应用实例。

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

我想更改与我的账号关联的电子邮件地址

您无法更改与 Google Cast 开发者帐号关联的电子邮件地址。如果您供职于组织,我们建议您使用团队电子邮件地址,以免将来出现访问权限问题。

我还有一个问题

请参阅 Cast SDK 支持页面