注册

如果您使用的是样式化媒体接收器或构建自定义接收器,则必须注册应用。注册应用后,您会收到一个应用 ID,发送器应用会使用此 ID 来执行 API 调用,以实现启动 Web 接收器应用等目的。

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

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

应用

注册应用后,您可以在发布应用之前对其进行测试,以确保其可在已注册的 Cast 设备上正常运行。发布应用后,所有 Cast 设备便可使用该应用。

注册应用

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

如需注册 Cast 应用,请按以下步骤操作:

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

    • 自定义接收器

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

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

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

    • 样式化媒体接收器

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. 点击保存

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

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

修改应用信息

在发布应用之前,您必须提供一些其他信息。您还可以更新您在注册过程中提供的应用相关信息。

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

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

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

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

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

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

    • Android

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

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

      • 应用的网站网址。
  8. 详细信息部分,选择是否要在 Google 产品和服务(例如 chromecast.com/apps)上展示您的应用。

  9. 类别下拉菜单中,选择与您的应用最相符的类别。

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

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

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

    字符数不得超过 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 网络。

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

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

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

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

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

  6. 输入设备的序列号。

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

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

  8. 请等待 15 分钟,然后继续操作。

    注册完成后,设备的状态将显示为“准备好进行测试”。

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

查找设备序列号

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

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

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

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

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

Android TV 软件序列号

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

如需将 ATV 设备置于开发者模式,请依次前往设置 > 系统 > 关于 > Android TV 操作系统 build,然后点击 build 几次,直到设备通知您已处于开发者模式。如需在开发者模式下查找序列号,请依次前往 Settings > Device Preferences > 内置 ChromecastSettings > System > Cast(具体取决于您的 ATV 型号),您会看到软件序列号显示出来。

请注意,当 ATV 设备恢复出厂设置后,软件序列号将会更改。恢复出厂设置后,请按照上述步骤查找软件序列号,然后在 Cast 开发者控制台中重新注册设备的新软件序列号。

账号问题

我想取消 Google Cast Developer Console 注册

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

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

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

我的应用已从 Google Cast 下架

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

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

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

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

您无法更改与 Google Cast 开发者账号关联的电子邮件地址。如果您是某个组织的员工,我们建议您使用团队电子邮件地址,以免日后出现访问问题。

我还有一个问题

请参阅 Cast SDK 支持页面