支持 Google Cast 的 Android TV

Android 5.0 发布后,Android TV 支持 Google Cast。 本文档介绍了在 Android TV 上进行设置和测试所需执行的操作 使用起来非常方便您现有的 Cast 应用可在以下设备上运行: 无需额外操作即可使用 Android TV。如果您要开发 Cast 应用 参阅 Google Cast 文档 并开发您的 Cast 应用,使其能够在 Chromecast 设备上运行,然后再 Android TV 开发和测试。

针对开发进行设置

  1. 设置 Android TV 设备: <ph type="x-smartling-placeholder">
      </ph>
    1. 将 Android TV 设备连接到本地网络。
    2. 登录您的 Google 账号。
  2. 设置设备行中,选择关于
  3. 向下滚动到 Build 并点击多次,直到出现一个对话框 以及“您现在处于开发者模式”这条消息。
  4. 如果进行 USB 调试: <ph type="x-smartling-placeholder">
      </ph>
    1. 安装 USB 线,但不要连接 USB 线的主端 至您的计算机。
    2. 偏好设置行中,依次选择开发者选项USB 调试,然后选择开启
  5. 返回主屏幕。您必须执行此操作才能应用 刚刚选中的对象除非您恢复出厂设置,否则这些设置会一直保留。
  6. Google Cast SDK Developer Console设备注册中所述。

调试

如需在 Android TV 设备上测试和调试 Web 接收器应用,请执行以下操作: 以下:

  1. 在 Android TV 设备上注册 Android TV 设备和应用, Google Cast SDK 开发者控制台。 请参阅注册,详细了解 来注册设备和应用。
  2. 启动发送器应用并投屏到 Android TV 设备。
  3. 按照说明,通过 ADB 连接到您的 Android TV 设备 使用 Android 调试桥
  4. 在开发机器上,打开 Chrome 浏览器窗口并导航到 chrome://inspect
  5. 点击 Inspect 链接,将网络接收器纳入调试程序。
  6. 在 Chrome 远程调试程序控制台中,启用调试日志记录,方法是在 以下:

    cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
    

如需了解详情,请参阅调试

Android TV 兼容性准则

让 Cast 应用与 Android TV 兼容只需很小的成本 额外工作。下面列出了一些建议和避免的 以确保您的应用与 Android TV 兼容:

  • 请注意,用户代理字符串中同时包含“Android”和“CrKey”; 有些网站可能会重定向到专门面向移动设备的网站,因为它们 “Android”标签。不要以为“Android”始终位于用户代理字符串中 表示移动用户。
  • Android 的媒体堆栈可能会使用透明的 GZIP 来提取数据。请确保 您的媒体数据可以响应 Accept-Encoding: gzip
  • Android TV HTML5 媒体事件的触发时间可能与 Chromecast,这样可能会发现在 Chromecast 上已隐藏的问题。
  • 更新媒体时,请使用由 <audio>/<video> 触发的媒体相关事件 元素,如 timeupdatepausewaiting。 避免使用与网络相关的事件,例如 progresssuspendstalled,因为它们往往取决于平台。
  • 在配置 Web Receiver 网站的 HTTPS 证书时,请务必 包括中间 CA 证书。请参阅 Qualsys SSL 测试页 验证:您网站的可信认证路径是否包含 CA 标记为“额外下载”的证书,那么可能无法在基于 Android 的设备上加载 平台。
  • Chromecast 在 720p 图形平面上显示“网络接收器”页面 其他投放平台(包括 Android TV)所显示的网页的分辨率最高可达 1080p。 确保您的 Web 接收器页面在不同分辨率下正常缩放。

使用 Android 调试桥

Android TV 平台适用于多种消费类电子产品 电视、机顶盒、游戏机等 它们的配置可能有所不同。如果您在访问 Android TV 系统资源,您可以 使用 Android 调试桥 (ADB) 获取设备序列号 注册和调试应用。请参阅 Android 调试桥了解详情。 信息。

通过 Wi-Fi 使用 ADB

如需使用 Wi-Fi 连接通过 ADB 连接到设备,请执行以下操作:

  1. 在 Android TV 设备上,按照相关说明启用开发者选项 针对开发进行设置
  2. 确保您的计算机与 Android 设备连接到同一网络 电视设备。
  3. 打开终端并输入以下内容:

    adb connect Android TV device IP address:4321
    
  4. 在计算机上,打开一个终端并输入 ADB 命令。您可以验证 且 Android TV 设备正在通信 然后使用以下命令:

    adb logcat

通过 USB 线使用 ADB

如需使用 USB 线连接通过 ADB 连接到您的设备,请执行以下操作:

  1. 按照说明设置 Android TV 设备以用于开发工作 针对开发进行设置
  2. 将 USB 线的主端连接到计算机。
  3. 要允许 USB 调试吗?对话框中,选择始终允许 然后选择确定
  4. 在计算机上,打开一个终端并输入 ADB 命令。您可以验证 且 Android TV 设备正在通信 然后使用以下命令:

    adb logcat

通过 TCP/IP 使用 ADB

无需 USB 线即可通过 TCP/IP 使用 ADB,但必须先获取 Android 电视设备的 IP 地址。由开发者问题的设备会监听 ADB 端口连接 可以自动连接,无需初始化端口即可连接。标准 零售 Android TV 设备不会自动监听 ADB 连接;用于 您必须先用 USB 线连接到 ADB,然后初始化 端口。

  1. 按照说明设置 Android TV 设备以用于开发工作 针对开发进行设置
  2. 在 Android TV 的设备行中,选择网络 >Wi-Fi、 然后选择连接的网络。
  3. 选择状态信息并记下 IP 地址
  4. 如果您的设备是标准的零售 Android TV 设备,请执行以下操作:

    1. 请按照 通过 USB 数据线使用 ADB
    2. 请确保您的计算机与 Android 设备连接到同一网络 电视设备。
    3. 在计算机的终端中,通过以下命令初始化 TCP/IP 端口: 输入以下内容:

      adb tcpip 5555
    4. 拔掉 USB 线,然后在终端中输入以下内容:

      adb connect Android TV device IP address:5555
      
  5. 如果您的设备是开发者出问题的 Android TV,请执行以下操作:

    1. 确保您的计算机与 Android 设备连接到同一网络 电视设备。
    2. 打开终端并输入以下内容:

      adb connect Android TV device IP address:4321
      
  6. 在 Android TV 的要允许 USB 调试吗?对话框中,选择始终允许 允许从这台计算机进行,然后选择确定。您可以验证 并且 Android TV 设备正在通过 Network:

    adb logcat