Oculus VR 客户端 (Android)

NVIDIA CloudXR SDK 包含一个示例 Oculus VR 客户端，旨在与支持 Oculus VR SDK 的 VR 头显配合使用。该客户端解码并渲染从 CloudXR 服务器流式传输的内容，并收集来自 VR 头显的运动和控制器数据，然后将其发送到 CloudXR 服务器。

VR 头显必须能够解码 4K HEVC 视频 @ 60fps。提供的示例客户端已在 Oculus Quest Pro 和 Oculus Quest 3 设备上进行过测试，运行频率为 72 Hz。

构建 Oculus VR 客户端

  1. 请确保您已具备Android 示例客户端系统要求中的所有必要条件。

  2. 将您下载的 OVR 移动 SDK zip 文件复制到 {sdk-root-folder}\Sample\Android\OculusVR\app\libs 文件夹中，并将文件重命名为 ovr_sdk.zip。

  3. 将 Google Oboe SDK .AAR 文件 (oboe-1.5.0.aar) 复制到 {sdk-root-folder}\Sample\Android\OculusVR\app\libs 文件夹中。

  4. 将 CloudXR SDK 客户端包（即 CloudXR.aar 文件）从 {sdk-root-folder}\Client\Lib\Android 文件夹复制到 {sdk-root-folder}\Sample\Android\OculusVR\app\libs 文件夹中。

  5. 运行 Android Studio。

  6. 完成以下任务之一

    • 在欢迎屏幕上选择打开现有的 Android Studio 项目。

    • 点击文件 > 打开。

  7. 导航到 {sdk-root-folder}\Sample\Android 并打开 OculusVR 项目/文件夹。

  8. 选择 构建 > 制作项目。

此过程应在 {sdk-root-folder}\Sample\Android\OculusVR\app\build\outputs\apk\debug 目录中生成一个 .apk 文件，该文件可用于调试或手动安装。您还可以通过直接从 Android Studio 运行来自动生成调试签名的 .apk 文件。有关更多信息，请参阅运行 Oculus VR 客户端。

注意

要从命令行构建，请从 OculusVR 文件夹运行 gradlew build。

安装 Oculus VR 客户端

注意

如果您想从命令行手动安装，则此部分是必需的。如果您通过 Android Studio 运行，它将处理安装，因此您可以跳到运行 Oculus VR 客户端。但是，如果您尚未在设备上设置调试，则以下前几个步骤可能相关。

  1. 将 Oculus VR 设备置于开发者模式，并允许设备上以调试模式进行 USB 连接。

  2. 使用 USB 电缆将 Oculus VR 设备连接到开发系统。

  3. 如果设备上提示允许连接，请选择允许。

  4. 在命令提示符窗口中，导航到包含通过构建示例应用程序创建的 .apk 文件的文件夹。

  5. 使用 ADB 从发布 .apk 文件安装应用程序。

    adb.exe install -r <APK name>.apk

    注意

    默认情况下，ADB.exe 程序由 Android Studio 安装在 C:\Users\{username}\AppData\Local\Android\Sdk\platform-tools 中

    安装完成后，ADB 会响应 Success 消息。

运行 Oculus VR 客户端

注意

有关命令行/启动选项以及所有可用选项的完整列表的更多信息，请参阅命令行选项，有关启动应用程序的各种方法，请参阅如何在 Android 上启动。

  1. 在服务器系统上启动 SteamVR。

  2. 在 Oculus 设备上启动 CloudXR Client 应用程序。

    可以通过以下方式之一完成此过程

    1. 如果通过 ADB 安装并带有启动选项文件，请从设备上的 VR 启动

    1. 打开主菜单。

    2. 选择库 > 未知来源。

    3. 选择 CloudXR Client 应用程序。

    1. 如果在 Android Studio 中构建，请直接部署/运行。

      您还可以在配置中设置启动选项。同样，有关如何从 Android Studio 设置启动选项的更多信息，请参阅命令行选项和如何在 Android 上启动。

注意

如果出现提示，请授予设备上请求的任何权限。

  1. 在服务器上启动将流式传输到客户端的 OpenVR 应用程序。

    可以通过以下方式之一完成此过程

    • 在服务器上，直接启动应用程序即可。

    • 在带有控制器的 VR 客户端上，单击左侧控制器上的菜单以调出 SteamVR 启动器，并从该面板中选择应用程序。

    注意

    • 仅在客户端连接到服务器之后才启动 OpenVR 应用程序，除非客户端已在服务器上预先配置。否则，应用程序将报告没有连接的头显。（这是因为当客户端首次连接时，它会向服务器报告其规格，例如分辨率和刷新率，此时服务器会创建一个虚拟头显设备。）

    • 如果应用程序立即退出，请确保您已禁用所有 Oculus 实验性功能，例如在 VR 中显示我的桌面。