此页面由 Cloud Translation API 翻译。

命令和控制 (CaC) 工具

命令和控制 (CaC) 工具是可供开发者测试和调试 Web 接收器应用的功能性网页发送者。

开发者可以使用 CaC 工具执行以下操作：

启动 Web 接收器应用

使用 CaC 工具启动 Web 接收器有两种方法：

如需启动新的投放会话，请按以下步骤操作：
1. 打开 CaC 工具，输入您的 Web 接收器应用 ID，然后点击设置应用 ID 按钮。
2. 点击“投放”按钮，然后选择一台设备，即可在支持 Cast 的远程设备上启动网络接收器。
如需加入现有的投放会话，请执行以下操作：
1. 使用以下代码获取正在运行的 Cast 会话 ID：
  
  在网络接收器端，使用以下方法在 Chrome 远程调试程序控制台中获取会话 ID：
```
cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
```
  或者，如需从已连接的 Web 发送者处获取会话 ID，请使用以下方法：
```
cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
```
2. 在 CaC 工具中输入会话 ID，然后点击恢复按钮。

当 CaC 工具连接到 Web 接收器应用时，“投射”按钮就会出现填满的帧形状。Web Receiver 应用 ID 和会话 ID 也会显示在该工具的顶部。

从发送者应用或 CaC 工具加载媒体。

如需在网络接收器上启动媒体播放，请将发送器应用投射到支持 Cast 的同一设备上，并从发送器应用向网络接收器发送加载请求。

CaC 工具还提供了多种向 Web 接收器应用发送加载请求的方法：

当用户通过 Google 助理启动媒体播放时，Google 助理会使用命令和控制 (CaC) 消息将用户凭据和实体发送到您的网络接收器。

CaC 工具通过 credentials 和 entity 模拟语音投射并发送加载请求。

CaC 工具还可以使用 Content ID 或 Content Url 模拟您的应用发送加载请求。

当媒体播放开始时，CaC 工具会从您的 Web 接收器应用接收媒体状态消息，并将其显示在媒体状态标签页中。

如果您想使用自己的 Load Request 对象测试接收器，请使用加载媒体标签页下的自定义加载请求字段。首先，从选择请求类型单选按钮中选择请求类型，然后复制粘贴或构建您自己的 JSON 对象。

CaC 工具还可以模拟 Google 助理向您的 Web 接收器应用发送的语音指令。您可以测试应用支持的媒体命令是否正常工作。您必须按照适当的错误类型和错误原因处理不受支持的媒体命令。

如果您的 Web 接收器应用启用了投射调试日志记录器，CaC 工具会捕获日志消息并控制 Web 接收器调试叠加层。

使用以下按钮控制 Web 接收器和记录消息：

Web 接收器应用 ID
- 清除缓存和停止 Web 接收器 - 重新加载 Web Receiver 应用并停止投射
Web 接收器调试叠加层
- Show - 切换网络接收器上的调试叠加层
- Clear - 清除 Web Receiver 调试叠加层上的日志消息
日志消息控件
- 插入消息 - 将日志或分隔线插入日志区域
- 下载日志 - 保存日志消息
- 清除日志 - 清除日志区域中的日志消息
日志消息
- 自定义标记 - 点击相应复选框可过滤日志消息

以下标记可能会显示在自定义标记下。这些内容由 CaC 工具添加，用于显示和过滤与调试会话相关的重要日志或消息：

如需测试 Cast Connect，请在建立会话之前执行以下步骤：

输入与支持 Cast Connect 的接收器相关联的接收器应用 ID，然后点击设置应用 ID。
点击 Show Android TV Options 按钮。
选中 androidReceiverCompatible 复选框。如果您的接收器不需要设置 Launch Credentials，或者您想要测试如果未设置它会发生什么情况，则可以就此停止，继续执行第 5 步。
（可选）输入 Launch Credentials 并点击设置启动凭据按钮，以便为 Cast Connect 会话设置启动凭据。
点击标题中的“投射”图标或通过 Chrome 浏览器中的“投射”菜单启动投射会话。

您的 Android TV 应用现在应该在设备上启动。