命令行参数

Command Line Arguments（命令行参数）

同义词： Launch Options（启动选项）, Startup Flags, CLI Arguments

提示： 已经有想要使用的命令行参数了？可以直接跳转到底部的 使用指南 查看设置方法。

Resonite 的桌面版本支持多种命令行参数。由于 Resonite 目前主要通过 Steam 分发，你可以在 Steam 的启动选项中进行设置。这些参数对于配置 独立体验（Standalone Experiences） 也非常有用。

硬件强制设置

• (无)：自动检测硬件。
• -Screen：强制进入 屏幕模式（Screen mode）。
• -Device SteamVR：强制使用 SteamVR。
• -Device WindowsMR：强制使用 Windows Mixed Reality。
• -Device Oculus：强制使用 Oculus Rift 和 Touch 控制器。
• -Device OculusQuest：强制使用 Oculus Quest 和 Touch 控制器（串流模式）。
• -Device Screen360：强制进入带 360° 投影的屏幕模式。
• -Device StaticCamera：强制以非交互式相机模式运行。
• -Device StaticCamera360：强制以非交互式相机模式运行，并使用 360° 等距柱状投影渲染。
• -LegacySteamVRInput：强制使用旧版 SteamVR 输入处理。适用于某些手部骨骼模型缺失或错误的设备（如配合 Quest 使用的 Virtual Desktop）。
• -ForceSRAnipal：强制初始化 SRAnipal SDK（用于 HTC 眼动和嘴部追踪），即使未检测到 Vive Pro Eye。
• -ForceBabble：强制初始化 Babble 驱动程序（用于 Project Babble 面部追踪）。

加入会话与打开世界

• -Join Auto：启动时自动加入并跟随局域网（LAN）上的活跃会话，优先选择人数最多的会话。
• -Join [URL或IP:端口]：启动时加入指定 URI 的会话（支持 resonite-session 或 lnl 协议）。
• -Open [resrec链接]：启动时直接打开指定的 resrec URL 世界。
• -Scratchspace [端口]：在指定端口启动一个新的草稿空间（遗留功能，未来可能会移除）。
• -AnnounceHomeOnLAN：启动时默认允许局域网访问家空间和 用户空间（Userspace）。
• -Bootstrap [类名]：运行指定类中的自定义 引导（Bootstrap） 函数。

网络与数据路径

网络设置

• -ForceLANOnly：确保所有会话默认仅在局域网发布，不可通过互联网访问。
• -CloudProfile [Production/Staging/Local]：指定用于调试的云端 API 服务器（生产/测试/本地）。

数据与日志文件夹

⚠️ 在使用以下参数前，请务必阅读并理解 迁移 Resonite 文件夹 指南，以免数据丢失。

• -DataPath [路径]：指定数据库目录路径。
• -CachePath [路径]：指定缓存目录路径。
• -LogsPath [路径]：将日志文件重定向到自定义目录。

相机与后处理

无人机相机预设

使用特定移动预设初始化静态相机脚本：

• -CameraBiggestGroup：追踪最大人群。
• -CameraTimelapse：延时摄影模式。
• -CameraStayBehind / -CameraStayInFront：保持在后方 / 保持在前方。
• -UseResoniteCamera：将静态相机作为带有缩放控制和预览功能的“Resonite Camera”生成。

后处理 (CTAA)

• -ctaa：启用电影级时间抗锯齿（Cinematic Temporal Anti-Aliasing）。
• -ctaaSharpnessEnabled [True/False]：设置是否启用 CTAA 锐化。

同步与数据库修复

这些参数保留用于解决同步错误，不当使用可能导致数据丢失。建议参考 Sync Errors（同步错误） 指南使用。

• -RepairDatabase：尝试修复数据库问题。

杂项设置 (Misc)

• -Invisible：登录时强制在线状态为“隐身”。
• -Kiosk：以 展厅模式（Kiosk mode） 运行。隐藏 logo、世界切换器等用户空间元素，默认禁用访客传送。
• -NoUI：隐藏用户空间（Userspace）UI。
• -DoNotAutoLoadHome：启动时不自动加载云端家空间。
• -ResetDash：将仪表盘布局重置为默认配置。
• -SkipIntroTutorial：跳过新手教学。
• -Watchdog [文件路径]：定期向文件写入时间。如果程序卡死，可用于外部监控重启。
• -DisablePlatformInterfaces：禁用所有平台接口（如 Discord/Steam 状态显示、剪贴板管理等），完全停止与宿主系统的交互。

使用指南

Steam 用户

1. 右键点击 Steam 库中的 Resonite。
2. 选择“属性”。
3. 在“通用”选项卡下的“启动选项”输入框中填入参数。
4. 例如：-Invisible -CachePath "D:\ResoniteCache"

自定义协议 (Steam 专用)

Resonite 安装后会注册自定义协议 Resonite:。你可以通过网页链接直接打开世界：

• Resonite:?world=[URL]：打开指定 URL 的世界或会话。
• 如果平台限制点击协议链接，可使用：https://api.resonite.com/open/world/[ID]