VR/zh

Monado

Monado 是一个开源的 OpenXR 运行时。它使用内置驱动程序支持各种硬件，使其可以运行任何 OpenXR 程序，并且在 OpenComposite 的帮助下，还可以运行大多数 OpenVR 应用程序。

可以使用其 NixOS 选项 services.monado.enable 配置 Monado：

❄︎ /etc/nixos/configuration.nix

services.monado = {
  enable = true;
  defaultRuntime = true; # Register as default OpenXR runtime
};

为了配置 Monado，您可能需要添加其他环境变量：

❄︎ /etc/nixos/configuration.nix

systemd.user.services.monado.environment = {
  STEAMVR_LH_ENABLE = "1";
  XRT_COMPOSITOR_COMPUTE = "1";
};

配置完成后，Monado 可以在 systemd 用户会话中启动和停止。

例如，以下命令将启动 Monado，然后打印其日志输出：

$ systemctl --user start monado.service
$ journalctl --user --follow --unit monado.service

手部追踪

您可能会注意到，由于缺少手部追踪数据，运行 monado-services 会失败。有两种方法可以解决这个问题：完全禁用手部追踪，或下载手部追踪数据。

要禁用手部追踪，请修改环境变量以包含 WMR_HANDTRACKING = "0";，使其如下所示。

❄︎ /etc/nixos/configuration.nix

systemd.user.services.monado.environment = {
  STEAMVR_LH_ENABLE = "1";
  XRT_COMPOSITOR_COMPUTE = "1";
  WMR_HANDTRACKING = "0";
};

要使手部追踪功能正常工作，您需要启用 git-lfs。启用 git-lfs 的标准方法是通过以下配置

❄︎ /etc/nixos/configuration.nix

programs.git = {
  enable = true;
  lfs.enable = true;
};

确保 git-lfs 功能启用后，运行以下命令并重新启动 monado-service

$ mkdir -p ~/.local/share/monado
$ cd ~/.local/share/monado
$ git clone https://gitlab.freedesktop.org/monado/utilities/hand-tracking-models

For further information about available environment variables and tweaks, read the Linux VR Adventures wiki and the Monado documentation about environment variables

OpenComposite

OpenComposite is a compatibility layer for running OpenVR applications on an OpenXR runtime like Monado. It is comparable to tools like DXVK or vkd3d, but for translating OpenVR calls to OpenXR.

为了在 SteamVR 以外的任何平台上运行 OpenVR 游戏，您需要配置 ~/.config/openvr/openvrpaths.vrpath 中定义的 OpenVR 运行时路径。一个可靠的方法是使用 Home Manager 创建此文件。

⚠︎

Warning: 旧版本的 Proton 将始终查询当前的 OpenVR 和 OpenXR 运行时。如果您使用 OpenComposite，并且它无法初始化 OpenXR 环境，Proton 将无法启动。解决方法是删除 ~/.config/openvr/openvrpaths.vrpath 文件，然后重试启动游戏。

如果此文件未设置为只读，SteamVR 将添加其运行时路径，因此可以使用 Home Manager。

启用 OpenComposite 的示例配置可能如下所示：

❄︎ ~/.config/home-manager/home.nix

# For Monado:
xdg.configFile."openxr/1/active_runtime.json".source = "${pkgs.monado}/share/openxr/1/openxr_monado.json";

# For WiVRn v0.22 and below:
xdg.configFile."openxr/1/active_runtime.json".source = "${pkgs.wivrn}/share/openxr/1/openxr_wivrn.json";

xdg.configFile."openvr/openvrpaths.vrpath".text = ''
  {
    "config" :
    [
      "${config.xdg.dataHome}/Steam/config"
    ],
    "external_drivers" : null,
    "jsonid" : "vrpathreg",
    "log" :
    [
      "${config.xdg.dataHome}/Steam/logs"
    ],
    "runtime" :
    [
      "${pkgs.opencomposite}/lib/opencomposite"
    ],
    "version" : 1
  }
'';

如果您计划在 Steam 上玩任何 OpenVR 游戏或通过 Proton 游玩 OpenXR 游戏，则必须以这种方式使用 OpenComposite。在大多数情况下，您还必须允许 Steam 运行时访问您的 OpenXR 运行时的 Socket 路径，方法是使用以下 Steam 上 XR 应用程序的启动选项：env PRESSURE_VESSEL_FILESYSTEMS_RW=$XDG_RUNTIME_DIR/monado_comp_ipc %command%。此示例适用于 Monado，其他 XR 运行时可能有所不同。

WiVRn

WiVRn 是一款基于 Monado 构建的 OpenXR 流媒体应用程序。它能够将独立的 VR 头戴设备无线连接到 Linux 计算机。如果您的头戴设备不是无线的，请查阅 Monado。 WiVRn 模块的示例用法：

⚠︎

Warning: 从 WiVRn 0.23 版本开始，WiVRn 会自行管理 opencomposite 路径。仅在使用低于 v0.23 的版本时使用上述 opencomposite 配置。

❄︎ /etc/nixos/configuration.nix

services.wivrn = {
  enable = true;
  openFirewall = true;

  # Write information to /etc/xdg/openxr/1/active_runtime.json, VR applications
  # will automatically read this and work with WiVRn (Note: This does not currently
  # apply for games run in Valve's Proton)
    defaultRuntime = true;

  # Run WiVRn as a systemd service on startup
  autoStart = true;

  # Config for WiVRn (https://github.com/WiVRn/WiVRn/blob/master/docs/configuration.md)
  config = {
    enable = true;
    json = {
      # 1.0x foveation scaling
      scale = 1.0;
      # 100 Mb/s
      bitrate = 100000000;
      encoders = [
        {
          encoder = "vaapi";
          codec = "h265";
          # 1.0 x 1.0 scaling
          width = 1.0;
          height = 1.0;
          offset_x = 0.0;
          offset_y = 0.0;
        }
      ];
    };
  };
};

与 Monado 一样，您还须添加 WiVRn 的启动参数以允许访问 Socket：PRESSURE_VESSEL_FILESYSTEMS_RW=$XDG_RUNTIME_DIR/wivrn/comp_ipc %command%

Envision

Envision 是用于 FOSS VR 程序栈的编排器（Orchestrator）。它负责构建和配置 Monado、WiVRn、OpenComposite 以及 FOSS VR 程序栈的其他实用程序，例如 Lighthouse 驱动程序、OpenHMD、Survive 和 WMR。您可以使用 Envision 模块启用它：

❄︎ /etc/nixos/configuration.nix

programs.envision = {
  enable = true;
  openFirewall = true; # This is set true by default
};

SteamVR

SteamVR 是一个专有的 OpenVR 运行时，兼容 OpenXR。它是 Steam 的一部分，除了启用 Steam 之外，在 NixOS 上无需进行任何其他设置。

通过 Steam 安装 SteamVR 并插入兼容 SteamVR 的耳机后，SteamVR 应该就可以正常工作。

在初始设置时，SteamVR 会请求提升权限，以便为其某个二进制文件设置文件能力（file capability）。这是使异步再投影技术正常工作所必需的。客户端需要拥有 CAP_SYS_NICE 授权来获取高优先级环境，这是异步再投影技术的必要条件。

Note: Steam 在基于 bubblewrap 的 FHS 环境中运行。此环境在用户命名空间中运行 Steam，这阻止它使用任何能力（capabilities）或为二进制文件 setuid。这意味着除非修补内核以完全消除这些限制，否则异步再投影技术无法在 NixOS 上使用。请参阅此 Nixpkgs 问题

修补 AMDGPU 以允许高优先级队列

通过应用 此补丁，AMDGPU 内核驱动程序将忽略进程权限并允许任何应用程序创建高优先级环境（high priority contexts）。

⚠︎

Warning: This removes intentional restrictions from the kernel, and it could cause scheduling issues. While it has not been reported that it does cause issues, this should be considered an unsupported configuration.

作为 NixOS 内核补丁进行应用

To workaround the CAP_SYS_NICE requirement, we can apply a kernel patch using the following NixOS configuration snippet:

❄︎ /etc/nixos/configuration.nix

boot.kernelPatches = [
  {
    name = "amdgpu-ignore-ctx-privileges";
    patch = pkgs.fetchpatch {
      name = "cap_sys_nice_begone.patch";
      url = "https://github.com/Frogging-Family/community-patches/raw/master/linux61-tkg/cap_sys_nice_begone.mypatch";
      hash = "sha256-Y3a0+x2xvHsfLax/uwycdJf3xLxvVfkfDVqjkxNaYEo=";
    };
  }
];

It is also possible to just patch amdgpu and build it as an out-of-tree module, as described in Linux_kernel#Patching_a_single_In-tree_kernel_module

wlx-overlay-s

wlx-overlay-s is a lightweight OpenXR/OpenVR overlay for Wayland and X11 desktops. It works with SteamVR as well as Monado/WiVRn natively.

SteamVR 自动启动

When launching wlx-overlay-s in SteamVR (or any OpenVR compositor) it will register an autostart manifest. Currently, this manifest will reference a Nix store path of wlx-overlay-s, which might get garbage collected after rebuilds of your NixOS/Nix profile. A workaround is to regularly run the following command to update the manifest's store path:

# Run wlx-overlay-s and replace any running instance
$ wlx-overlay-s --replace

另见

• Linux VR Adventures Wiki