在 Android XR Engine Hub 中捕获和分析性能跟踪记录

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
了解 XR 设备类型 →
扩展现实头戴设备
有线扩展现实眼镜
了解 XR 设备类型 →

借助 Android XR Engine Hub，您可以直接从连接的 Android XR 设备捕获高频系统和应用性能跟踪记录。跟踪记录完成后，Android XR Engine Hub 会自动执行以下操作：

  • 将 .perfetto 跟踪文件保存到您的工作站，并在 Perfetto Web 界面中打开该文件，其中包含预配置的视口参数（visStart 和 visEnd）。
  • 在工作站本地将原始 .perfetto 捕获内容缩减为 CPU 和 GPU 利用率、帧时间统计信息和丢帧的简明文本摘要。
  • 将精简的跟踪记录摘要发送到 Gemini（使用您的 API 密钥配置时），以诊断帧速率瓶颈，并直接在中心内提供切实可行的优化建议。

配置 Gemini API 密钥

AI 赋能的跟踪记录分析使用自带密钥 (BYOK) 工作流和 Google AI Studio API 密钥。如果您不配置 API 密钥，仍然可以记录跟踪记录并在 Perfetto Web 界面中检查这些跟踪记录，但自动 Gemini 诊断不会运行。

如需配置 Gemini API 密钥，请执行以下操作：

  1. 从 Google AI Studio 获取 Gemini API 密钥。
  2. 打开 Android XR Engine Hub，然后选择左侧导航边栏中的设置（或点击性能页面上的在“设置”中添加 Gemini API 密钥）。
  3. 在 Gemini API 密钥字段中，粘贴您的 API 密钥。

  4. 点击保存。

    您可以随时更新密钥，也可以清除 Gemini API 密钥字段，然后点击保存，从工作站中移除已保存的密钥。

记录和分析性能跟踪记录

请按照以下步骤从已连接的 Android XR 设备捕获性能轨迹，并查看分析结果：

  1. 使用 USB-C 数据线将 Android XR 设备连接到工作站，然后从 Android XR Engine Hub 顶部的设备下拉菜单中选择该设备。

  2. 在设备上启动要分析的 XR 应用或场景。

  3. 在 Android XR Engine Hub 的左侧导航边栏中，选择性能。

  4. 在 XR 设备跟踪卡片中，点击开始录制，然后在设备上重现互动或性能问题。

    在 Android XR Engine Hub 中捕获性能跟踪记录并查看 Gemini 分析

  5. 完成后，点击 Stop Recording，或等待跟踪在达到 30 秒的时间限制时自动停止。

录制完成后，Android XR Engine Hub 会处理捕获的内容，并以三种方式提供结果：

  • Perfetto Web 界面：默认浏览器会在 Perfetto Web 界面中打开捕获的跟踪记录，以便您检查详细的时间轴轨道、着色器编译和线程调度。
  • 性能分析结果：如果您已配置 Gemini API 密钥，则在评估本地跟踪记录摘要时，性能分析结果窗格会显示正在使用 Gemini 分析跟踪记录，然后呈现一份结构化报告，其中会突出显示关键瓶颈、丢帧和建议的修复措施。 点击窗格右上角的复制图标，将 Markdown 报告复制到剪贴板。
  • 本地跟踪文件：点击 XR 设备跟踪卡片中的跟踪，打开包含已保存 .perfetto 文件的本地输出文件夹。