Web 接收器概览

网络接收器应用

网络接收器应用是在网络接收器设备(如 Chromecast)上运行的 HTML5/JavaScript 应用。网络接收器应用执行以下功能:

  • 提供用于在电视上显示应用内容的界面。
  • 处理来自发送者应用的消息,以控制 Web 接收器设备上的内容。
  • 处理来自发送者的特定于应用的自定义消息。

网络接收器提供其他功能

Web 接收器 SDK

Web Receiver SDK 还带有内置的媒体播放器,提供流畅的播放体验。它还允许您自定义播放器界面,并让您的网络接收器能够拦截和替换消息以及执行自定义业务逻辑的方法。

您可以通过以下方式实现 Web 接收器应用:

  • 使用样式化的媒体网页接收器:这是一款预构建的网络接收器应用,可为音频和视频内容提供媒体播放器界面。它为 Web 接收器应用提供默认界面,但您可以使用 CSS 文件在界面中自定义多个元素。
  • 开发自定义 Web 接收器:您必须构建自定义 HTML5 应用,才能托管该应用在 TV 上显示的内容。如果您的应用需要显示音频/视频媒体以外的内容,或者样式化媒体接收器不支持您的应用所需的媒体类型,您可能需要创建自定义接收器。

如果您选择不实现网络接收器,您的应用可以使用默认媒体网络接收器

选择网络接收器

Web 接收器 SDK 提供了不同类型的接收器,以满足您的业务需求。如需了解不同功能的比较情况,请参阅接收器应用类型指南

样式化媒体网络接收器

Styled Media Web Receiver 是由 Google 托管的预构建 Web 接收器应用,专为流式传输音频和视频内容而设计。您可以使用 CSS 文件根据自己的颜色和品牌资产设置界面样式。

要使用样式化媒体 Web 接收器,请在注册新应用时选择样式化媒体 Web 接收器,并视需要提供 CSS 文件的网址,该文件定义 Web 接收器应用界面的自定义外观。

如需详细了解允许您自定义样式化媒体网络接收器应用的界面的 CSS 样式,请参阅样式化媒体接收器指南。

自定义网络接收器

如果应用提供图库、需要 DRM 或自定义业务逻辑等内容,则您需要构建自定义 Web 接收器应用。自定义 Web 接收器是托管在您自己的服务器上的 HTML5 应用,必须使用 JavaScript Web 接收器 API 实现。

如需详细了解如何使用 Web Receiver API 构建 Web 接收器应用,请参阅自定义 Web 接收器指南。

默认媒体网络接收器

第三个选项是“默认媒体 Web 接收器”。这是一款由 Google 托管的预构建 Web 接收器应用,专为流式传输音频和视频内容而设计。它不要求您在 Google Cast SDK Developer Console 中注册,但无法自定义默认媒体 Web 接收器中的任何界面

您可以使用默认应用 ID 使用默认媒体 Web 接收器,而不是向开发者控制台注册来接收应用 ID:

  • 对于 Android 应用:CastMediaControlIntent.DEFAULT_MEDIA_RECEIVER_APPLICATION_ID
  • 对于 Web 应用:chrome.cast.media.DEFAULT_MEDIA_RECEIVER_APP_ID
  • 对于 iOS 应用:
    • <=v4.0.0 kGCKMediaDefaultReceiverApplicationID
    • >=v4.0.2 kGCKDefaultMediaReceiverApplicationID

在发送器应用中,在 Cast 设备上启动“默认媒体网页接收器”应用,然后使用该应用将该网址加载到您的媒体。