支持 Web 应用的投射

1. 概览

Google Cast 徽标

在此 Codelab 中,您将学习如何修改现有 Web 视频应用,以在支持 Google Cast 的设备上投射内容。

什么是 Google Cast?

Google Cast 可让用户将移动设备上的内容投射到电视上。然后,用户可以将其移动设备用作遥控器,来控制电视上的媒体播放。

借助 Google Cast SDK,您可以扩展应用以控制电视或音响系统。使用 Cast SDK,您可以基于 Google Cast 设计核对清单来添加必需的界面组件。

Google Cast 设计核对清单用于在所有支持的平台上实现简单、可预测的 Cast 用户体验。

构建目标

完成此 Codelab 后,您将拥有一个 Chrome 网络视频应用,能够将视频投放到 Google Cast 设备上。

学习内容

  • 如何将 Google Cast SDK 添加到示例视频应用中。
  • 如何添加“投射”按钮以选择 Google Cast 设备。
  • 如何连接到 Cast 设备并启动媒体接收器。
  • 如何投射视频。
  • 如何集成 Cast Connect

所需条件

  • 最新版本的 Google Chrome 浏览器。
  • HTTPS 托管服务,例如 Firebase Hostingngrok
  • 具有互联网访问权限的 ChromecastAndroid TV 等 Google Cast 设备。
  • 一台带 HDMI 输入端口的电视或显示器。
  • 需要使用 Chromecast(支持 Google TV)测试 Cast Connect 集成,但对于此 Codelab 的其余部分,这并非强制性要求。如果您还没有设置深层链接,请跳过本教程末尾的添加 Cast Connect 支持步骤。

体验

  • 您需要具备网络开发知识。
  • 您还需要有观看电视的经验 :)

您打算如何使用本教程?

仅阅读教程内容 阅读并完成练习

您如何评价自己在构建 Web 应用方面的经验水平?

新手水平 中等水平 熟练水平

您如何评价自己在观看电视方面的经验水平?

新手水平 中等水平 熟练水平

2. 获取示例代码

您可以将所有示例代码下载到您的计算机…

然后解压下载的 zip 文件。

3. 运行示例应用

Google Chrome 徽标

首先,我们来看看完成后的示例应用的外观。该应用是一个基础视频播放器。用户可以从列表中选择一个视频,然后在设备上本地播放该视频,或者将该视频投射到 Google Cast 设备上。

若要使用已完成的功能,需要托管该功能。

如果您没有可供使用的服务器,则可以使用 Firebase Hostingngrok

运行服务器

设置完您所选的服务后,请转到 app-done 并启动您的服务器。

在浏览器中,访问所托管示例的 https 网址。

  1. 您应该会看到视频应用出现。
  2. 点击“投放”按钮,然后选择您的 Google Cast 设备。
  3. 选择一个视频,点击播放按钮。
  4. 该视频便会开始在您的 Google Cast 设备上播放。

视频在投放设备上播放的图片

点击视频元素中的“暂停”按钮,即可暂停接收器上的视频。点击视频元素中的播放按钮,继续播放视频。

点击“投射”按钮,即可停止投射到 Google Cast 设备。

在我们停止服务器之前。

4. 准备起始项目

视频在投放设备上播放的图片

我们需要在您下载的入门级应用中添加 Google Cast 支持。以下是我们将在此 Codelab 中使用的一些 Google Cast 术语:

  • 发送设备应用是指在移动设备或笔记本电脑上运行的应用;
  • 接收设备应用是指在 Google Cast 设备上运行的应用。

现在,您可以使用自己喜爱的文本编辑器基于入门级项目进行构建了:

  1. 从下载的示例代码中选择 文件夹图标app-start 目录。
  2. 使用您的服务器运行应用并探索界面。

请注意,在完成此 Codelab 的过程中,您需要根据服务将示例重新托管在服务器上。

应用设计

该应用从远程网络服务器中提取视频列表,并提供列表供用户浏览。用户可以选择视频查看相关详情,也可以在移动设备上本地播放视频。

该应用包含一个主视图(在 index.html 中定义)和主控制器 CastVideos.js.

index.html

此 HTML 文件声明了 Web 应用的几乎所有界面。

有一部分视图包含 div#main_video,其中包含视频元素。与视频 div 相关,我们有 div#media_control,用于定义视频元素的所有控件。下方是 media_info,它显示了视图中视频的详细信息。最后,carousel div 会在 div 中显示视频列表。

index.html 文件还会引导 Cast SDK,并指示 CastVideos 函数进行加载。

将填充这些元素的大多数内容都在 CastVideos.js 中定义、注入和控制。我们来看看这个原因。

CastVideos.js

此脚本用于管理 Cast Video Web 应用的所有逻辑。在 CastVideos.js 中定义的视频列表及其关联的元数据包含在名为 mediaJSON 的对象中。

主要涉及几个部分,主要包括本地和远程的视频视频播放。总而言之,这是一个相当简洁的 Web 应用。

CastPlayer 是管理整个应用、设置播放器、选择媒体以及将事件绑定到 PlayerHandler 以播放媒体的主类。CastPlayer.prototype.initializeCastPlayer 是设置所有 Cast 功能的方法。CastPlayer.prototype.switchPlayer 会在本地玩家和远程玩家之间切换状态。CastPlayer.prototype.setupLocalPlayerCastPlayer.prototype.setupRemotePlayer 用于初始化本地和远程播放器。

PlayerHandler 是负责管理媒体播放的类。还有许多其他方法负责管理媒体和播放的细节。

常见问题解答

5. 添加“投放”按钮

支持 Cast 的应用的图片

支持 Cast 的应用会在视频元素中显示“投放”按钮。点击“投射”按钮会显示用户可以选择的 Cast 设备列表。如果用户正在发送设备上本地播放内容,则选择 Cast 设备即会在相应 Cast 设备上开始播放或继续播放。在 Cast 会话期间,用户随时可以点击“投射”按钮,停止将应用投射到 Cast 设备。在应用的任何屏幕中,用户都必须能够连接到 Cast 设备或断开与该应用的连接,如 Google Cast 设计核对清单中所述。

配置

起始项目需要的依赖项和设置与完成后的示例应用相同,但这次要托管 app-start 的内容。

在浏览器中,访问您托管的示例的 https 网址。

请注意,在进行更改时,您需要根据服务将示例重新托管在服务器上。

初始化

Cast 框架有一个全局单例对象 CastContext,用于协调框架的所有 activity。此对象必须在应用生命周期的早期阶段初始化(通常从分配给 window['__onGCastApiAvailable'] 的回调调用,该回调会在 Cast SDK 加载完毕且可供使用时调用)。在这种情况下,CastContext 会在 CastPlayer.prototype.initializeCastPlayer 中调用,后者是从上述回调调用。

初始化 CastContext 时必须提供 options JSON 对象。此类包含会影响框架行为的选项。其中最重要的是接收器应用 ID,此 ID 用于过滤可用 Cast 设备列表,以便仅显示能够运行指定应用的设备,以及在 Cast 会话启动时启动接收器应用。

您在开发自己的支持 Cast 的应用时,必须注册为 Cast 开发者,然后为您的应用获取应用 ID。在此 Codelab 中,我们将使用一个示例应用 ID。

将以下代码添加到 body 部分末尾的 index.html 中:

<script type="text/javascript" src="https://www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>

将以下代码添加到 index.html 以初始化 CastVideos 应用,以及初始化 CastContext

<script src="CastVideos.js"></script>
<script type="text/javascript">
var castPlayer = new CastPlayer();
window['__onGCastApiAvailable'] = function(isAvailable) {
  if (isAvailable) {
    castPlayer.initializeCastPlayer();
  }
};
</script>

现在,我们需要在 CastVideos.js 中添加一个新方法,该方法对应于我们刚刚在 index.html 中调用的方法。我们来添加一个名为 initializeCastPlayer 的新方法,该方法可在 CastContext 上设置选项,并初始化新的 RemotePlayerRemotePlayerControllers

/**
 * This method sets up the CastContext, and a few other members
 * that are necessary to play and control videos on a Cast
 * device.
 */
CastPlayer.prototype.initializeCastPlayer = function() {

    var options = {};

    // Set the receiver application ID to your own (created in
    // the Google Cast Developer Console), or optionally
    // use the chrome.cast.media.DEFAULT_MEDIA_RECEIVER_APP_ID
    options.receiverApplicationId = 'C0868879';

    // Auto join policy can be one of the following three:
    // ORIGIN_SCOPED - Auto connect from same appId and page origin
    // TAB_AND_ORIGIN_SCOPED - Auto connect from same appId, page origin, and tab
    // PAGE_SCOPED - No auto connect
    options.autoJoinPolicy = chrome.cast.AutoJoinPolicy.ORIGIN_SCOPED;

    cast.framework.CastContext.getInstance().setOptions(options);

    this.remotePlayer = new cast.framework.RemotePlayer();
    this.remotePlayerController = new cast.framework.RemotePlayerController(this.remotePlayer);
    this.remotePlayerController.addEventListener(
        cast.framework.RemotePlayerEventType.IS_CONNECTED_CHANGED,
        this.switchPlayer.bind(this)
    );
};

最后,我们需要为 RemotePlayerRemotePlayerController 创建变量:

var CastPlayer = function() {
  //...
  /* Cast player variables */
  /** @type {cast.framework.RemotePlayer} */
  this.remotePlayer = null;
  /** @type {cast.framework.RemotePlayerController} */
  this.remotePlayerController = null;
  //...
};

投放按钮

现在,CastContext 已初始化,接下来需要添加“投射”按钮,以便用户选择 Cast 设备。Cast SDK 提供了一个名为 google-cast-launcher 且 ID 为“castbutton"”的“投放”按钮组件。只需在 media_control 部分添加一个 button,即可将其添加到应用的视频元素中。

按钮元素应如下所示:

<google-cast-launcher id="castbutton"></google-cast-launcher>

将以下代码添加到 media_control 部分的 index.html 中:

<div id="media_control">
  <div id="play"></div>
  <div id="pause"></div>
  <div id="progress_bg"></div>
  <div id="progress"></div>
  <div id="progress_indicator"></div>
  <div id="fullscreen_expand"></div>
  <div id="fullscreen_collapse"></div>
  <google-cast-launcher id="castbutton"></google-cast-launcher>
  <div id="audio_bg"></div>
  <div id="audio_bg_track"></div>
  <div id="audio_indicator"></div>
  <div id="audio_bg_level"></div>
  <div id="audio_on"></div>
  <div id="audio_off"></div>
  <div id="duration">00:00:00</div>
</div>

现在,在 Chrome 浏览器中刷新页面。您应该会在视频元素中看到“投放”按钮,点击该按钮后,系统会列出您本地网络中的投放设备。设备发现由 Chrome 浏览器自动管理。选择您的投放设备,然后示例接收设备应用便会在投放设备上加载。

我们尚未添加任何媒体播放支持,因此您尚无法在 Cast 设备上播放视频。点击“投放”按钮,即可停止投放。

6. 投射视频内容

包含 Cast 设备选择菜单且支持 Cast 的应用的图片

我们将扩展示例应用,以便还可以在 Cast 设备上远程播放视频。为此,我们需要监听 Cast 框架生成的各种事件。

投射媒体

概括而言,如果您想在投放设备上播放媒体内容,就需要执行以下操作:

  1. 从 Cast SDK 创建用于模拟媒体项的 MediaInfo JSON 对象。
  2. 用户连接到 Cast 设备以启动接收器应用。
  3. MediaInfo 对象加载到接收设备中,然后播放内容。
  4. 跟踪媒体状态。
  5. 根据用户互动情况向接收设备发送播放命令。

第 1 步相当于将一个对象映射到另一个对象;MediaInfo 是 Cast SDK 能够理解的东西,mediaJSON 是应用对媒体项的封装;我们可以轻松将 mediaJSON 映射到 MediaInfo。我们已经在上一部分中完成了第 2 步。使用 Cast SDK 可以轻松地执行第 3 步。

示例应用 CastPlayer 已在 switchPlayer 方法中区分本地播放和远程播放:

if (cast && cast.framework) {
  if (this.remotePlayer.isConnected) {
    //...

在此 Codelab 中,您无需准确了解所有示例播放器逻辑的运作方式。但请务必注意,您必须修改应用的媒体播放器,才能同时了解本地播放和远程播放。

目前,本地播放器始终处于本地播放状态,因为它还不知道任何关于投射状态的信息。我们需要根据 Cast 框架中发生的状态转换来更新界面。例如,如果我们开始投射,则需要停止本地播放并停用一些控件。同样,如果我们在此视图控制器中停止投射,则需要转换为本地播放。为处理此情况,我们需要监听 Cast 框架生成的各种事件。

投射会话管理

对于 Cast 框架,Cast 会话结合了连接到设备、启动(或加入现有会话)、连接到接收器应用以及初始化媒体控制渠道(如果适用)的步骤。媒体控制渠道是指 Cast 框架从接收器发送和接收媒体播放相关消息的方式。

当用户从“投放”按钮选择设备时,投放会话将自动启动;如果用户断开连接,系统将自动停止投放会话。Cast 框架会自动处理由于网络问题而重新连接到接收器会话的操作。

Cast 会话由 CastSession 管理,后者可通过 cast.framework.CastContext.getInstance().getCurrentSession() 进行访问。EventListener 回调可用于监控会话事件,例如创建、暂停、恢复和终止。

在当前应用中,所有会话和状态管理都通过 setupRemotePlayer 方法为我们处理。将以下代码添加到 CastVideos.js 中,以开始在应用中配置该功能:

/**
 * Set the PlayerHandler target to use the remote player
 */
CastPlayer.prototype.setupRemotePlayer = function () {
    var castSession = cast.framework.CastContext.getInstance().getCurrentSession();

    this.playerHandler.setTarget(playerTarget);

    // Setup remote player volume right on setup
    // The remote player may have had a volume set from previous playback
    if (this.remotePlayer.isMuted) {
        this.playerHandler.mute();
    }
    var currentVolume = this.remotePlayer.volumeLevel * FULL_VOLUME_HEIGHT;
    var p = document.getElementById('audio_bg_level');
    p.style.height = currentVolume + 'px';
    p.style.marginTop = -currentVolume + 'px';

    this.hideFullscreenButton();

    this.playerHandler.play();
};

我们仍需绑定回调中的所有事件,并处理传入的所有事件。这一点相当简单,我们现在来进行处理:

/**
 * Set the PlayerHandler target to use the remote player
 */
CastPlayer.prototype.setupRemotePlayer = function () {
    var castSession = cast.framework.CastContext.getInstance().getCurrentSession();

    // Add event listeners for player changes which may occur outside sender app
    this.remotePlayerController.addEventListener(
        cast.framework.RemotePlayerEventType.IS_PAUSED_CHANGED,
        function() {
            if (this.remotePlayer.isPaused) {
                this.playerHandler.pause();
            } else {
                this.playerHandler.play();
            }
        }.bind(this)
    );

    this.remotePlayerController.addEventListener(
        cast.framework.RemotePlayerEventType.IS_MUTED_CHANGED,
        function() {
            if (this.remotePlayer.isMuted) {
                this.playerHandler.mute();
            } else {
                this.playerHandler.unMute();
            }
        }.bind(this)
    );

    this.remotePlayerController.addEventListener(
        cast.framework.RemotePlayerEventType.VOLUME_LEVEL_CHANGED,
        function() {
            var newVolume = this.remotePlayer.volumeLevel * FULL_VOLUME_HEIGHT;
            var p = document.getElementById('audio_bg_level');
            p.style.height = newVolume + 'px';
            p.style.marginTop = -newVolume + 'px';
        }.bind(this)
    );

    // This object will implement PlayerHandler callbacks with
    // remotePlayerController, and makes necessary UI updates specific
    // to remote playback
    var playerTarget = {};

    playerTarget.play = function () {
        if (this.remotePlayer.isPaused) {
            this.remotePlayerController.playOrPause();
        }

        var vi = document.getElementById('video_image');
        vi.style.display = 'block';
        var localPlayer = document.getElementById('video_element');
        localPlayer.style.display = 'none';
    }.bind(this);

    playerTarget.pause = function () {
        if (!this.remotePlayer.isPaused) {
            this.remotePlayerController.playOrPause();
        }
    }.bind(this);

    playerTarget.stop = function () {
         this.remotePlayerController.stop();
    }.bind(this);

    playerTarget.getCurrentMediaTime = function() {
        return this.remotePlayer.currentTime;
    }.bind(this);

    playerTarget.getMediaDuration = function() {
        return this.remotePlayer.duration;
    }.bind(this);

    playerTarget.updateDisplayMessage = function () {
        document.getElementById('playerstate').style.display = 'block';
        document.getElementById('playerstatebg').style.display = 'block';
        document.getElementById('video_image_overlay').style.display = 'block';
        document.getElementById('playerstate').innerHTML =
            this.mediaContents[ this.currentMediaIndex]['title'] + ' ' +
            this.playerState + ' on ' + castSession.getCastDevice().friendlyName;
    }.bind(this);

    playerTarget.setVolume = function (volumeSliderPosition) {
        // Add resistance to avoid loud volume
        var currentVolume = this.remotePlayer.volumeLevel;
        var p = document.getElementById('audio_bg_level');
        if (volumeSliderPosition < FULL_VOLUME_HEIGHT) {
            var vScale =  this.currentVolume * FULL_VOLUME_HEIGHT;
            if (volumeSliderPosition > vScale) {
                volumeSliderPosition = vScale + (pos - vScale) / 2;
            }
            p.style.height = volumeSliderPosition + 'px';
            p.style.marginTop = -volumeSliderPosition + 'px';
            currentVolume = volumeSliderPosition / FULL_VOLUME_HEIGHT;
        } else {
            currentVolume = 1;
        }
        this.remotePlayer.volumeLevel = currentVolume;
        this.remotePlayerController.setVolumeLevel();
    }.bind(this);

    playerTarget.mute = function () {
        if (!this.remotePlayer.isMuted) {
            this.remotePlayerController.muteOrUnmute();
        }
    }.bind(this);

    playerTarget.unMute = function () {
        if (this.remotePlayer.isMuted) {
            this.remotePlayerController.muteOrUnmute();
        }
    }.bind(this);

    playerTarget.isMuted = function() {
        return this.remotePlayer.isMuted;
    }.bind(this);

    playerTarget.seekTo = function (time) {
        this.remotePlayer.currentTime = time;
        this.remotePlayerController.seek();
    }.bind(this);

    this.playerHandler.setTarget(playerTarget);

    // Setup remote player volume right on setup
    // The remote player may have had a volume set from previous playback
    if (this.remotePlayer.isMuted) {
        this.playerHandler.mute();
    }
    var currentVolume = this.remotePlayer.volumeLevel * FULL_VOLUME_HEIGHT;
    var p = document.getElementById('audio_bg_level');
    p.style.height = currentVolume + 'px';
    p.style.marginTop = -currentVolume + 'px';

    this.hideFullscreenButton();

    this.playerHandler.play();
};

加载媒体

在 Cast SDK 中,RemotePlayerRemotePlayerController 提供了一组便捷 API,用于管理接收器上的远程媒体播放。对于支持媒体播放的 CastSession,SDK 将自动创建 RemotePlayerRemotePlayerController 实例。若要访问它们,您可以分别创建 cast.framework.RemotePlayercast.framework.RemotePlayerController 实例,如本 Codelab 前面所述。

接下来,我们需要在接收器上加载当前选定的视频,方法是构建一个 MediaInfo 对象,以便 SDK 处理和传入该请求。为此,请将以下代码添加到 setupRemotePlayer 中:

/**
 * Set the PlayerHandler target to use the remote player
 */
CastPlayer.prototype.setupRemotePlayer = function () {
    //...

    playerTarget.load = function (mediaIndex) {
        console.log('Loading...' + this.mediaContents[mediaIndex]['title']);
        var mediaInfo = new chrome.cast.media.MediaInfo(
            this.mediaContents[mediaIndex]['sources'][0], 'video/mp4');

        mediaInfo.metadata = new chrome.cast.media.GenericMediaMetadata();
        mediaInfo.metadata.metadataType = chrome.cast.media.MetadataType.GENERIC;
        mediaInfo.metadata.title = this.mediaContents[mediaIndex]['title'];
        mediaInfo.metadata.images = [
            {'url': MEDIA_SOURCE_ROOT + this.mediaContents[mediaIndex]['thumb']}];

        var request = new chrome.cast.media.LoadRequest(mediaInfo);
        castSession.loadMedia(request).then(
            this.playerHandler.loaded.bind(this.playerHandler),
            function (errorCode) {
                this.playerState = PLAYER_STATE.ERROR;
                console.log('Remote media load error: ' +
                    CastPlayer.getErrorMessage(errorCode));
            }.bind(this));
    }.bind(this);

    //...
};

现在,请添加一种用于在本地播放和远程播放之间切换的方法:

/**
 * This is a method for switching between the local and remote
 * players. If the local player is selected, setupLocalPlayer()
 * is run. If there is a cast device connected we run
 * setupRemotePlayer().
 */
CastPlayer.prototype.switchPlayer = function() {
    this.stopProgressTimer();
    this.resetVolumeSlider();
    this.playerHandler.stop();
    this.playerState = PLAYER_STATE.IDLE;
    if (cast && cast.framework) {
        if (this.remotePlayer.isConnected) {
            this.setupRemotePlayer();
            return;
        }
    }
    this.setupLocalPlayer();
};

最后,添加一种方法来处理任何 Cast 错误消息:

/**
 * Makes human-readable message from chrome.cast.Error
 * @param {chrome.cast.Error} error
 * @return {string} error message
 */
CastPlayer.getErrorMessage = function(error) {
  switch (error.code) {
    case chrome.cast.ErrorCode.API_NOT_INITIALIZED:
      return 'The API is not initialized.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.CANCEL:
      return 'The operation was canceled by the user' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.CHANNEL_ERROR:
      return 'A channel to the receiver is not available.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.EXTENSION_MISSING:
      return 'The Cast extension is not available.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.INVALID_PARAMETER:
      return 'The parameters to the operation were not valid.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.RECEIVER_UNAVAILABLE:
      return 'No receiver was compatible with the session request.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.SESSION_ERROR:
      return 'A session could not be created, or a session was invalid.' +
        (error.description ? ' :' + error.description : '');
    case chrome.cast.ErrorCode.TIMEOUT:
      return 'The operation timed out.' +
        (error.description ? ' :' + error.description : '');
  }
};

现在,运行应用。请连接到你的投放设备,然后开始播放视频。您应该会看到视频在接收设备上播放。

7. 添加 Cast Connect 支持

Cast Connect 库允许现有的发送者应用通过 Cast 协议与 Android TV 应用通信。Cast Connect 基于 Cast 基础架构构建,您的 Android TV 应用可作为接收器。

依赖项

  • Chrome 浏览器 M87 或更高版本

设置兼容的 Android 接收器

为了启动 Android TV 应用(也称为 Android Receiver),您需要在 CastOptions 对象中将 androidReceiverCompatible 标志设置为 true。

将以下代码添加到 initializeCastPlayer 函数的 CastVideos.js 中:

var options = {};
...
options.androidReceiverCompatible = true;

cast.framework.CastContext.getInstance().setOptions(options);

设置启动凭据

在发送者端,您可以指定 CredentialsData 来代表会话的参与者。credentials 是一个可由用户定义的字符串,前提是您的 ATV 应用可以理解。CredentialsData 仅在启动或加入时传递给您的 Android TV 应用。如果您在连接时重新设置它,则不会将其传递到 Android TV 应用。

要设置发布凭据,需要在设置启动选项后随时定义 CredentialsData

将以下代码添加到 initializeCastPlayer 函数的 CastVideos.js 类中:

cast.framework.CastContext.getInstance().setOptions(options);
...
let credentialsData = new chrome.cast.CredentialsData("{\"userId\": \"abc\"}");
cast.framework.CastContext.getInstance().setLaunchCredentialsData(credentialsData);
...

设置加载请求凭据

如果您的 Web Receiver 应用和 Android TV 应用以不同方式处理 credentials,您可能需要为它们分别定义凭据。为解决此问题,请在 CastVideos.jssetupRemotePlayer 函数中的 playerTarget.load 下添加以下代码:

...
var request = new chrome.cast.media.LoadRequest(mediaInfo);
request.credentials = 'user-credentials';
request.atvCredentials = 'atv-user-credentials';
...

现在,SDK 会自动处理要用于当前会话的凭据,具体取决于您的发送器投射到的接收器应用。

测试 Cast Connect

在 Chromecast(支持 Google TV)上安装 Android TV APK 的步骤:

  1. 找到 Android TV 设备的 IP 地址。此设置通常位于设置 > 网络和互联网 >(您的设备连接到的网络名称)下。右侧会显示该网络的详细信息和您设备的 IP。
  2. 使用设备的 IP 地址通过 adb 通过终端连接到该设备:
$ adb connect <device_ip_address>:5555
  1. 从终端窗口中转到您在此 Codelab 开始时下载的 Codelab 示例的顶级文件夹。例如:
$ cd Desktop/chrome_codelab_src
  1. 运行以下命令,将此文件夹中的 .apk 文件安装到 Android TV 中:
$ adb -s <device_ip_address>:5555 install android-tv-app.apk
  1. 现在,您应该可以在 Android TV 设备上的您的应用菜单中按投射视频的名称来查看应用。
  2. 运行更新后的网页发送者代码,然后使用投射图标或从 Chrome 浏览器的下拉菜单中选择 Cast..,与您的 Android TV 设备建立投射会话。这应该会在 Android 接收器上启动 Android TV 应用,并允许您使用 Android TV 遥控器控制播放。

8. 恭喜

现在,您已了解如何在 Chrome Web 应用中使用 Cast SDK 微件让视频应用支持 Cast。

如需了解详情,请参阅 Web 发送者开发者指南。