安装指南 - hallychou/ALVR-QIYU GitHub Wiki

基本安装

PC 端：

安装 SteamVR，启动一次，然后关闭它。这是为了确保它为 ALVR 正确设置环境。
转到最新版本下载页面。在底部的“Assets”部分，下载 ALVR 安装程序。
运行安装程序。如果出现提示，请在 SmartScreen 弹出窗口中允许执行。您需要授予管理员权限才能安装 ALVR。为了获得最佳兼容性，请勿更改安装文件夹。
安装完成后，启动 ALVR。您会看到一个设置向导。按照设置设置防火墙规则和预设。

如果您在启动 ALVR 时遇到问题，请按照以下指南使用便携式版本

耳机侧：

在您的 PC 上安装 SideQuest 并在头戴显示设备上启用开发人员模式。您可以按照本指南进行操作。
将您的耳机连接到 Sidequest。如果您有 Oculus Quest 1/2，请在此处下载 ALVR 应用程序，如果您有 Oculus Go，请在此处下载

用法

在头戴式设备上启动 ALVR。当耳机屏幕打开时，单击客户端条目（在 PC 上）旁边的以开始流式传输。Trust
您可以在选项卡中更改 PC 上的设置。大多数设置需要重新启动 SteamVR 才能应用。使用右下角的 apposite 按钮。Settings

如有任何问题，请访问故障排除页面。高级安装

便携版

还有一个用于 PC 的便携式版本，需要更多的手动步骤才能使其工作。

安装 SteamVR 并启动一次。
从最新版本下载页面下载。alvr_server_windows.zip
解压缩到仅包含 ASCII 字符且具有编辑权限但没有管理员权限的路径。

夜间

如果您想尽早获得新功能或希望帮助进行测试，您可以安装 nightly 版本。

在此处下载最新的 nightly 服务器。从 Sidequest 下载最新的 nightly 客户端（Quest 版本、Go 版本）。

由于夜间发布可能不稳定，因此为了获得最大的兼容性，请始终为 PC 和头戴显示设备使用匹配的版本。它们每天更新一次。

麦克风流

要使用麦克风，您需要安装 VB-CABLE 驱动程序。将 “CABLE Output” 设置为默认麦克风。然后您可以在 ALVR 设置中启用麦克风，将“虚拟麦克风输入”保留为默认。

在单独的网络上连接耳机和 PC

在此处查看指南。

将 ALVR 与第三方驱动程序一起使用

默认情况下，ALVR 在启动前禁用其他 SteamVR 驱动程序。在这些驱动程序中，有用于全身跟踪的 Driver4VR。ALVR 禁用这些驱动程序以最大限度地提高与每个 PC 设置的兼容性。您可以通过手动注册 ALVR 驱动程序来禁用此行为。转到选项卡并单击。下次启动 ALVR 时，您将能够同时使用其他驱动程序。installation``Register ALVR driver

与 SteamVR 一起启动 ALVR

您可以跳过 ALVR 启动器，并与 SteamVR 一起自动打开 ALVR。打开 ALVR，转到选项卡并单击。installation``Register ALVR driver

使用与 Chrome 不同的浏览器

ALVR 需要基于 Chromium 的浏览器才能正确显示仪表板。Chrome 和 Edge 开箱即用，但 Edge 有一些错误使 ALVR 行为奇怪。如果您想使用其他基于 Chromium 的浏览器，如 Brave 或 Vivaldi，您必须添加一个指向浏览器可执行文件路径的环境变量（例如）。很遗憾，不支持 Firefox。ALCRO_BROWSER_PATH``C:\Program Files\Vivaldi\Application\vivaldi.exe

通过 USB 数据线连接耳机和 PC

在此处查看指南。Linux的

除非您使用的是 nightly 版本，否则请确保禁用所有音频流选项。

Arch Linux

Install 和 rust 工具链（如果没有）：https://wiki.archlinux.org/title/Rust#Arch_Linux_package。`rustup`
安装 alvrAUR（推荐）或 alvr-gitAUR
安装 SteamVR，启动一次，然后关闭它。
从 DE 的应用程序启动器运行或 ALVR。alvr_launcher

其他

使用 VAAPI/NVENC + DRM + Vulkan + x264/x265 支持安装 FFmpeg。您可以在 Ubuntu 下使用此 ppa：savoury1/ffmpeg5，或下载捆绑了 ffmpeg 的 ppa：savoury1/ffmpeg5。alvr_server_portable.tar.gz
安装 SteamVR，启动一次，然后关闭它。
从版本下载页面下载。alvr_server_linux(_portable).tar.gz
跑bin/alvr_launcher

如果您没有在系统范围内安装正确版本的 FFmpeg，一个常见问题是服务器崩溃或无法在头戴显示设备上显示图像，因为 SteamVR 加载了错误版本的 FFmpeg。

音频设置

如果您使用的是 PipeWire，请安装并pipewire-alsa``pipewire-pulse
pavucontrol和（以 PulseAudio 工具为例）pactl

游戏音频

必须在 v19+ 上
在 ALVR 控制面板中启用 Game Audio。
选择或作为设备。pipewire``pulse
连接耳机并等待流式传输开始。
在设置中，ALVR 正在录制的设备从“Monitor of ”（您的音频输出监视器）进行录制。您可能必须将 “Show：” 设置为 “All Streams” 才能显示它。pavucontrol
现在，任何音频都应该在耳机上播放。要在头戴式耳机流式传输时自动将 PC 扬声器静音，您可以使用以下脚本：
```
#!/bin/sh
case $ACTION in
        connect)
                pactl set-sink-mute @DEFAULT_SINK@ 1;;
        disconnect)
                pactl set-sink-mute @DEFAULT_SINK@ 0;;
esac
```
将此文本保存到文件中，使其可执行（），然后将 “On Connect Script” 和 “On Disconnect Script” 设置中的文件名（显示高级选项的“连接”选项卡）。chmod +x ...

麦克风

Run：或，对于 permanent setup，请将以下内容添加到：pactl load-module module-null-sink sink_name=VirtMain``context.modules``~/.config/pipewire/pipewire.conf

{   name = libpipewire-module-loopback
    args = {
        node.name = "VirtMain" node.description = "VirtMain" media.name = "VirtMain"
        audio.position = [ FL FR ]
        capture.props = {
            media.class = Audio/Sink
            node.name = VirtMain.capture
        }
    }
}

在 ALVR 控制面板中启用麦克风流。
连接耳机并等待流式传输开始。
将 ALVR Playback 设置为 “VirtMain” 时pavucontrol
将 “Monitor of VirtMain” 设置为您的麦克风。