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

有关可用环境变量和调整的更多信息，请参阅 Linux VR Adventures wiki 和 Monado 文档关于环境变量的部分

OpenComposite

OpenComposite 是一个兼容层，用于在 Monado 等 OpenXR 运行时上运行 OpenVR 应用程序。它与 DXVK 或 vkd3d 等工具类似，但用于将 OpenVR 调用转换为 OpenXR。

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

⚠︎

Warning: {{{1}}}

如果此文件未设置为只读，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: {{{1}}}

❄︎ /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: {{{1}}}

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

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

⚠︎

Warning: {{{1}}}

作为 NixOS 内核补丁进行应用

为了解决 CAP_SYS_NICE 要求，我们可以使用以下 NixOS 配置片段应用内核补丁：

❄︎ /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=";
    };
  }
];

也可以只修补 amdgpu 并将其构建为树外模块（out-of-tree module），如 Pacthing a single In-tree Kernel Module 中所述

Patching bubblewrap to allow capabilities

By modifying the bubblewrap binary used for running Steam, you can allow processes in that FHS environment to acquire capabilities. This removes the need for patching the kernel directly.

⚠︎

Warning: {{{1}}}

❄︎ /etc/nixos/configuration.nix

programs.steam = let
  patchedBwrap = pkgs.bubblewrap.overrideAttrs (o: {
    patches = (o.patches or []) ++ [
      ./bwrap.patch
    ];
  });
in {
  enable = true;
  package = pkgs.steam.override {
    buildFHSEnv = (args: ((pkgs.buildFHSEnv.override {
      bubblewrap = patchedBwrap;
    }) (args // {
      extraBwrapArgs = (args.extraBwrapArgs or []) ++ [ "--cap-add ALL" ];
    })));
  };
};

≡︎ /etc/nixos/bwrap.patch

diff --git a/bubblewrap.c b/bubblewrap.c
index 8322ea0..4e20262 100644
--- a/bubblewrap.c
+++ b/bubblewrap.c
@@ -868,13 +868,6 @@ acquire_privs (void)
       /* Keep only the required capabilities for setup */
       set_required_caps ();
     }
-  else if (real_uid != 0 && has_caps ())
-    {
-      /* We have some capabilities in the non-setuid case, which should not happen.
-         Probably caused by the binary being setcap instead of setuid which we
-         don't support anymore */
-      die ("Unexpected capabilities but not setuid, old file caps config?");
-    }
   else if (real_uid == 0)
     {
       /* If our uid is 0, default to inheriting all caps; the caller

as an additional change, you may also need to replace Steam's own bwrap binary with a symbolic link to this modified bwrap binary, found at ~/.local/share/Steam/ubuntu12_32/steam-runtime/usr/libexec/steam-runtime-tools-0/srt-bwrap.

Steam will periodically replace this modification with its own binary when steam-runtime updates, so you may need to re-apply this change if it breaks.

wlx-overlay-s

wlx-overlay-s 是一个轻量级的 OpenXR/OpenVR 覆盖层，适用于 Wayland 和 X11 桌面。它原生兼容 SteamVR 以及 Monado/WiVRn。

SteamVR 自动启动

在 SteamVR（或任何 OpenVR 合成器）中启动 wlx-overlay-s 时，它会注册一个自动启动清单。目前，此清单将引用 wlx-overlay-s 的 Nix 存储路径，该路径可能会在重建 NixOS/Nix 配置文件后被垃圾回收。一种解决方法是定期运行以下命令来更新清单的存储路径：

# 运行 wlx-overlay-s 并替换任何正在运行的实例
$ wlx-overlay-s --replace

{{{1}}}

另见

• Linux VR Adventures Wiki