起動引数

suggestion

Resoniteのデスクトップ版ビルドでは、いくつかのコマンドライン引数がサポートされています。これらの引数のほとんどは、Resonite Launcherを使用して、より視覚的な方法で設定し、起動ごとに保存することができます。

These command line arguments, can be useful in setting up Standalone Experiences. これらのコマンドライン引数は、Standalone Experiencesの設定に役立ちます。

特定のハードウェアを強制使用する

• 指定なし - 自動検出
• -Screen - スクリーンモード（デスクトップモードとも呼ばれます）
• -Device SteamVR SteamVR
• -Device WindowsMR Windows Mixed Reality
• -Device Oculus Oculus Rift + Touchコントローラー
• -Device OculusQuest Oculus Quest + Touchコントローラー
• -Device Screen360 スクリーンモード（360度投影付き）
• -Device LegacyScreen Resonite を旧式のデスクトップ「デバッグ」モードで強制的に起動します。
• -Device StaticCamera 非インタラクティブカメラモード
• -Device StaticCamera360 360度正距円筒レンダリングを使用した非インタラクティブカメラモード
• -LegacySteamVRInput SteamVRのレガシー入力処理を強制します。Oculus QuestのVirtual Desktopなど、SteamVRデバイスの一部で手や指のスケルトンモデルが欠落または不具合がある場合の回避策として使用されます。
• -ForceSRAnipal HTCの視線・リップトラッキング用のSRAnipal SDKを、Vive Pro Eyeが接続されていない場合でも強制的に初期化します。
• -EnableOWO Insert_ip_address_here OWO Gameの触覚ベストとの統合機能を有効にします（ベストのIPアドレスを指定する必要があります）。現在のところ機能していません。詳細については関連するGitHubのIssueを参照してください。

セッションへ参加 / ワールドを開く

• -Join Auto - LAN上のアクティブセッションに自動的に参加してフォーカスします（最も多くのユーザーがいるワールドに切り替わります）
• -Join Insert_URL_or_IP:Port_here - 指定されたURI（Resonite-session | lnl）でセッションに参加します
• -Open Insert_URL_here - 起動時に指定されたURLのワールドを開きます（resrec）
• -Scratchspace Insert_port_here - 指定したポートで新しいスクラッチスペース（Scratchspace）ワールドを開始します（古い機能であり、今後削除される可能性が高いです）。
• -AnnounceHomeOnLAN - ホームワールドと ユーザースペースがデフォルトでLANからアクセス可能になります
• -Bootstrap Insert_bootstrap_class_here - 指定したクラス名内のカスタムブートストラップ関数を実行します。

ネットワーク

• -ForceLANOnly - すべてのワールドはデフォルトでLANネットワーク上のみに公開され、インターネットからはアクセスできません
• -CloudProfile - 使用するクラウドAPIサーバーを指定します（デバッグ目的で使用されます）。有効な値：Production, Staging, Local

ドローンカメラのプリセット

これらのオプションは、特定の動作プリセットを使ったドローンスクリプトにより、静的カメラを初期化します：

• -CameraBiggestGroup
• -CameraTimelapse
• -CameraStayBehind
• -CameraStayInFront

また、これらの引数はドローンカメラにも使用可能です。

• -UseResoniteCamera - ズーム操作、プレビュー表示などの機能を備えたResonite Cameraとして静的カメラを生成します。

共通アバタービルダー

• -ForceNoVoice - CommonAvatarBuilderが、アバターに音声機能を一切セットアップしなくなります（ローカルでのプレゼンテーションなどに役立ちます）。

データフォルダー

Resoniteには複数のデータフォルダーがあり、これらを制御するためのさまざまなコマンドライン引数があります。それらの引数を使用する前に、必ず Relocate Resonite Folders を読んで内容を理解してください。そうしないと、データが失われる可能性があります。

• -DataPath path/to/data/dir - データベースディレクトリへのパスを指定します。
• -CachePath path/to/cache/dir - キャッシュディレクトリへのパスを指定します。

ログフォルダー

• -LogsPath path/to/logs/dir - ログファイルを指定されたカスタムディレクトリに保存するようにリダイレクトします。

同期の問題

Resoniteの同期問題を解決するために予約されたコマンドライン引数がいくつかあります。これらの引数は、場合によってはデータ損失を引き起こす可能性があるため、同期問題が発生している場合を除いて使用しないでください。

同期の問題が発生している場合は、同期エラーを参照してください。そこには、利用可能なコマンドライン引数と、それらを使って同期問題を解決する方法についてのさまざまなガイドがあります。

データベース修復

If you're having database issues then Database repair may help to resolve them.

• -RepairDatabase

ポストプロセシング

• -ctaa - CTAA（Cinematic Temporal Anti-Aliasing：映画的時間的アンチエイリアス）を有効にします。
• -ctaaTemporalEdgePower Insert_Number_here - CTAAの TemporalEdgePower を指定した数値に設定します。
• -ctaaSharpnessEnabled Insert_True_or_False_here - CTAAのシャープネスを有効にするかどうかを設定します（true または false）。
• -ctaaAptiveSharpness Insert_Number_here - CTAAの ctaaAptiveSharpness の値を指定した数値に設定します。

その他

• -Watchdog Insert_filepath_here - Resoniteは指定されたファイルに定期的に現在時刻を書き込みます。この機能は、プロセスがフリーズした際に自動的に再起動するための監視に利用できます。
• -LoadAssembly Insert_path_here - 指定されたパスのCLRアセンブリをResoniteプロセスに読み込みます。
• -Kiosk - Resoniteをキオスクモードで実行します（ユーザースペースのアイテム（ロゴやワールドスイッチャーなど）を非表示にし、ゲストのテレポートをデフォルトで無効にします）。
• -NoUI - ユーザースペースのUIを非表示にします。
• -CubemapResolution Insert_resolution_here - 360度正距円筒レンダリングで使用されるキューブマップの解像度を強制的に指定します。
• -DoNotAutoLoadHome - 起動時にクラウドホームが自動で読み込まれることはありません（手動で読み込むことは可能です）。あるいは、Settings#Favorites でユーザーごとの設定として指定することもできます。
• -ResetDash - ダッシュメニューのレイアウトをデフォルトの設定にリセットします。
• -SkipIntroTutorial - 起動時にゲームのチュートリアルを始めないようにします。
• -Forceintrotutorial - 起動時にゲームのチュートリアルを強制的に開始します。
• -Invisible - ログイン時にオンラインステータスを非表示にします。
• -EngineConfig Insert_filepath_here - カスタムの起動設定ファイルを指定します。
• -BackgroundWorkers Insert_number_here - バックグラウンドワーカーのプロセス数を指定した数に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が不安定になる可能性があります。
• -PriorityWorkers Insert_number_here - 優先度付きワーカープロセスの数を指定した値に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が壊れる可能性があります。
• -ForceReticleAboveHorizon - デスクトップでの一人称視点時に、視点を水平線より下に向けられないようにします（デフォルトで有効）。
• -Verbose - エンジン初期化時の詳細なログを出力します。プラグイン開発者やデバッグ時に有用です。
• -GeneratePrecache - クラウドのレコードをnormal 通常のキャッシュ保存先に加え、 (Resonite install folder)/RuntimeData/PreCache にもキャッシュします。
• -ExportDatabaseAll Insert_path_here - ローカルデータベース内のすべての記録（ユーザー記録やグループ記録を含む）を指定したパスにエクスポートします。
• -ExportDatabaseMachine Insert_path_here - ローカルマシンが所有する記録（ローカルワールドや設定など）を指定したパスにエクスポートします。
• -ValidateTypes - Internally checks and logs if all loaded DataModel types pass DataModel validation tests.
• -NeverSaveSettings - Prevents settings from being saved and synced, useful for testing purposes and on prerelease builds.
• -NeverSaveDash - Prevents dashboard changes from being saved and synced, useful for testing purposes and on prerelease builds.
• -DisablePlatformInterfaces - Disables all platform interfaces. This includes things like Discord and Steam rich presence, but also includes platform interfaces such as the clipboard manager. This argument essentially stops Resonite from advertising itself to the host system completely.

Resoniteカスタムプロトコルハンドラー（Steam専用）

Resonite registers a custom protocol handler with your computer on installation. You can use this to create links which will open Resonite to a set location or world when they are clicked. These arguments are given to the Resonite launcher, which will make sure Resonite is launched and running and forward them to the running instance.

• Resonite:?world=Insert_URL_here - Open a world or session at given URL
  • For example Resonite:?world=resrec:///U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1 - Will Open "The Directory" by ProbablePrime
  • And for Sessions Resonite:?world=Resonite-session://eea1442e-0ff2-4d6a-ad16-2dac9ea786fc will join session eea1442e-0ff2-4d6a-ad16-2dac9ea786fc

The URL of a world can be accessed by opening the inspector for a world orb and navigating to the WorldOrb component or by using the Session menu's "Copy Record URL" button:

The URL field can be selected by double clicking into the field. The URL text can be copied to the Windows clipboard via Ctrl+C.

When linking to a world on a platform that restricts the clickability protocol handlers, you can use the redirect junction located at https://api.resonite.com/open/ instead. They will redirect to use the above Resonite: protocol handler.

• https://api.resonite.com/open/world/Insert_ID_here - Open a world at given URL
  • For example https://api.resonite.com/open/world/U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1 - Will Open "The Directory" by ProbablePrime

• https://api.resonite.com/open/session/Insert_ID_here - Open a session at given URL
  • For example https://api.resonite.com/open/session/S-eea1442e-0ff2-4d6a-ad16-2dac9ea786fc will join session S-eea1442e-0ff2-4d6a-ad16-2dac9ea786fc

Unityスタンドアロンプレイヤーの起動引数

The Unity Standalone Player command line arguments can be useful for setting a specific resolution, or the windowed mode.

• -screen-fullscreen 0 - Launch Resonite in a window.
• -screen-fullscreen 1 - Launch Resonite in full-screen.
• -screen-width - Sets the horizontal resolution.
• -screen-height - Sets the vertical resolution.

Example: If you use -screen-fullscreen 0 -screen-width 1280 -screen-height 720 Resonite will launch in a 1280x720 window.

起動引数の使用方法

以下は、コマンドライン引数を使ってResoniteを起動するための3つの方法です。

Each example explains how to combine the -Invisible and -CachePath Insert_path_here commands. Here the examples show how to specify a non-default cache location at D:\Temporary files\ResoniteCache\.

Choosing the best method to use depends on how you normally launch Resonite. For most users, the setup described in #Launching from Steam is likely the best choice.

Launching from Steam

1. Open Steam
2. Right click on Resonite in your library
3. Select "Properties" and then "Set Launch Options".
4. Enter the command you need to use, exactly as it appears above and Run Resonite.

Now, if Resonite is launched via Steam, the custom command line arguments will take effect.

Commands entered via this method will not take effect if Resonite is launched any other way, such as directly launching the Resonite.exe.

Use a shortcut

It is possible to use launch commands via a custom shortcut targeting the Resonite.exe file.

To create a shortcut:

1. Find the Resonite install folder and right-click on the Resonite.exe.
2. In the context menu click 'Create Shortcut'
3. Move the 'Resonite.exe - Shortcut' file to somewhere more convenient (such as the Desktop).
4. Right-click on the shortcut file and click 'Properties' in the context menu.
5. This opens a dialog window. Select the 'Shortcut' tab.
6. In the 'Target' text box add a space after the Resonite.exe filepath and then add your command line arguments.
7. Click 'Apply' and 'OK'.

Now, if Resonite is launched by double clicking on the shortcut it will launch using the custom options. These will not be applied if a different method is used to start Resonite.

Examples

Here we're providing some example Command Line Argument setups and describing what they can do:

• Single world experience - Use command line arguments to setup a single world experience version of Resonite. Useful for conventions and exhibitions.
• Automatically join a session - Use command line arguments to create a copy of Resonite that automatically joins a session on launch. Useful for classrooms, meetings etc.