发布
发布

Meta Quest 开发者工具

更新时间: 2024年12月17日
在为 Meta Quest 头戴设备创建应用和体验时,工具对于调试和优化应用至关重要,用于确保应用能够满足用户期望和 Meta Horizon Store 的要求。本主题包含为 Meta Quest 头戴设备开发应用时推荐使用的工具信息。
首先,强烈建议所有开发者安装 Meta Quest 开发者中心 (MQDH)。MQDH(支持 WindowsmacOS)是一款一站式工具,用于管理头戴设备、文件、下载、应用分发,它包含性能分析仪、Perfetto、以及跳转至新闻和知识文章的链接。
其他推荐工具可大致分为三类:
  • Android 工具 - 在 Unreal 引擎OpenXR Mobile 开发中,这些工具在设置 Meta Quest 开发的环境时随 Android Studio 一起安装。在 Unity 开发中,它们在 Unity 安装后作为模块安装。它们往往是开发者在开发过程中必须使用的基础工具。
  • 性能监控和分析工具 - 这些工具使开发者能够更深入地检查其应用的各个方面。它们提供了许多指标和访问底层数据的途径,这些数据可用于优化性能和解决非常具体的问题。
  • 测试和自动化工具 - 这些工具在测试和调试应用时使用,有助于促进自动化测试。
以下表格所示为 Meta Quest 开发期间推荐使用的工具。

Meta Quest 开发者中心

Meta Quest 开发者中心(NativeUnityUnreal
Meta Quest 开发者中心 (MQDH) 提供了一系列针对常见任务的常用解决方案,如截屏、录制视频、将头戴设备显示屏投射到电脑、访问 Performance Analyzer 和 Perfetto,以及接收更新活动的通知。SDK、工具及其他产品可以从 MQDH 下载和更新。MQDH 还方便管理头戴设备、设备上的应用和文件以及编译版本上传。

Android 工具

工具描述
使用 Logcat 收集 VrApi 日志(NativeUnityUnreal
Logcat 显示操作系统和应用日志消息,例如可用于识别性能问题区域和确定崩溃原因的性能信息。
配置 Android 系统属性(NativeUnityUnreal
描述常见的 Android 系统级属性,以及如何使用它们来调试和测试运行中的头戴设备上的潜在变化。
对 Meta Quest 头戴设备使用 ADB(NativeUnityUnreal
Android Debug Bridge (ADB) 是 Meta Quest 开发的一般先决条件,在准备环境时安装。ADB 也是使用本主题中的许多工具所必需的。ADB 用于在电脑和 Meta Quest 头戴设备之间建立连接。它用于在头戴设备上安装编译版本和运行命令。

性能监控和分析工具

以下图表展示了使用下方表格中工具的建议性能优化工作流程:
Optimization Workflow
工具描述
Unreal Insights (Unreal) 使用入门
Unreal Insights 是一款性能分析和分析工具,可帮助您快速找到瓶颈、性能峰值和线程模式。
Unity Profiler 和 Unity Profile Analyzer (Unity) 使用入门
Unity Profiler 是专用于 Unity 应用的性能分析工具。Unity Profile Analyzer 从 Unity Profiler 跟踪所捕捉的一系列帧中提取数据,并对它们进行统计分析,为每个函数生成信息,例如这些提取帧中的时间信息和总调用次数,以及计数平均值。
使用 RenderDoc Meta Fork 进行图形调试和分析(NativeUnityUnreal
除了 RenderDoc 的正常图形调试功能外,RenderDoc Meta Fork 还可以访问 Meta Quest 头戴设备中的低级 GPU 分析数据,包括渲染阶段和单个绘制调用数据。对于 Vulkan 应用,API 验证和着色器统计数据也可用。
使用 OVR 指标工具监控性能(NativeUnityUnreal
OVR 指标工具可以在屏幕上实时叠加可配置的应用和头戴设备性能数据的图表,还可以导出收集到的性能指标的报告。其他功能包括远程头戴设备管理,以及一个适用于原生开发和 Unity 开发的工具包,该工具包允许将开发者数据集成到叠加图表和 CSV 报告中。
使用 MQDH 获取 Perfetto 跟踪数据(NativeUnityUnreal
Perfetto 是一款与引擎无关的性能跟踪工具,与内置引擎分析器相比具有一些主要优势,比如它包含了系统进程的广泛视图,以及与应用性能分析相同时间线上的其他指标。此外,它还能直接将调用到 OVRPlugin 的函数映射到操作系统,并从高层次深入了解各种 GPU 计数器和指标,从而更好地隔离性能问题。它还可以生成 GPU 渲染阶段跟踪。
使用 gpumeminfo 跟踪 GPU 内存信息(NativeUnityUnreal
gpumeminfo 工具用于跟踪进程的 GPU 内存使用情况。与 dumpsys meminfo 相比,它提供了更为深入的图形内存使用视图。
使用 Performance Analyzer 从 MQDH 中监控应用(NativeUnityUnreal
Performance Analyzer 是 MQDH 中的一个工具,它提供了易于配置的性能指标图表、可搜索的 Logcat 日志流以及启动 Perfetto 跟踪的能力。
使用 ovrgpuprofiler 进行 GPU 分析(NativeUnityUnreal
ovrgpuprofiler 工具能够访问实时的 GPU 管线指标和渲染阶段跟踪数据。其设计旨在以便捷、低阻力的方式访问实时的指标和 GPU 性能分析数据。

测试和自动化工具

工具描述
使用 Meta Quest 可脚本化测试服务来启用端到端测试(NativeUnityUnreal
Meta Quest 可脚本化测试服务会在 Meta Quest 头戴设备上禁用某些模态对话框、自动休眠和边界限制,以便更好地执行自动化测试。此外,该服务还可以减少甚至消除配置头戴设备以进行测试以及重置头戴设备以进行重复测试所需的手动步骤数。
使用 Meta XR 模拟工具加速 Unity OpenXR 开发的迭代进程(UnityUnrealNative
Meta XR 模拟工具是一个 Open XR 运行时,它能够在 API 层面上模拟 Meta VR 头戴设备及其功能。通过减少频繁佩戴和摘下头戴设备的需求,它使得应用的测试和调试变得更加容易,并且通过简化测试环境的设置来帮助提升自动化测试的规模。
使用 AutoDriver 记录输入(NativeUnityUnreal
AutoDriver 用于记录头戴设备、控制器以及手部追踪的输入信息,以及跟踪数据。这些数据可以回放,从而使应用能够在需要用户输入的自动化测试中重复使用这些数据。
对 VS Code 使用 Oculus 调试器(NativeUnreal
Oculus 调试器是一个 VS Code 扩展,旨在为 Meta Quest 应用提供实时调试功能。
Vulkan 验证层(NativeUnityUnreal
Vulkan 验证层用于检测 Vulkan 应用是否符合 Vulkan 规范。跟踪这些验证层至关重要,因为违反规范可能会导致从轻微性能不良到完全渲染损坏的各种行为。