注册

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

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

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

应用

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

注册应用

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

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

  1. 登录 Google Cast SDK Developer Console
  2. Overview 页面或 Applications 页面中,点击 Add New Application(添加新应用)。
  3. 选择您要使用的 Web 接收器应用类型:

    • 自定义接收器

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

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

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

    • 自定样式的媒体接收器

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. 点击保存

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

  6. 点击完成,返回到“申请”页面。

修改应用信息

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

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

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

    借助中继投放,您的 Web 接收器可以支持从与接收器不连接到同一 Wi-Fi 网络的发送器进行投射。若要为接收器停用中继投放,请取消选中此复选框。

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

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

  7. 发件人详细信息部分中,为您的应用支持的每个平台提供以下内容:

    • Android

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

      • Apple 要求的 iTunes IDBundle ID
      • 应用启动 URI(使用 Google Home 应用启动您的应用的 URI)。如需详细了解所需的 URI 格式,请参阅使用网址架构与应用通信
    • Web

      • 您应用的网站网址。
  8. 商品详情部分,选择是否要在 chromecast.com/apps. 等 Google 产品和服务上列出您的应用。

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

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

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

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

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

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

    不得超过 80 个字符。例如,“在家里的最佳屏幕上畅享你喜爱的 YouTube 频道。”

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

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

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

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

发布应用

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

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

  1. Google Cast SDK Developer Console概览页面或应用页面中,找到要发布的应用,点击发布

    如果您的应用信息已填写完毕,系统会显示一个预览屏幕,其中包含您在 Edit application information 中输入的应用信息。如果没有,系统会显示一条消息,列出您需要提供的信息。

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

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

统计信息

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

其中包含以下信息:

  • 启动了应用的 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. 请等待 15 分钟,然后再继续。

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

  8. 重启 Cast 设备:断开设备的电源线或 USB 线,然后重新插上。

查找设备序列号

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

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

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

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

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

Android TV 软件序列号

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

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

请注意,当 ATV 设备恢复出厂设置时,软件序列号会发生变化。恢复出厂设置后,请按照上述步骤找到软件序列号,然后在 Cast Developer Console 中重新注册设备的新软件序列号。

账号问题

我想取消自己的 Google Cast Developer Console 注册

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

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

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

我的应用已从 Google Cast 中移除

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

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

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

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

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

我还有一个问题

请参阅 Cast SDK 支持页面