起動引数

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

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

For information on how Resonite handles(or how to fix) Custom Protocol(url) launching through Steam, see: Custom protocol handler

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

• 指定なし - 自動検出
• -SteamVR - SteamVR
• -RiftTouch - Oculus Rift + Touch controllers
• -Screen - スクリーンモード（デスクトップモードとも呼ばれます）
• -Screen360 - スクリーンモード（360度投影付き）
• -StaticCamera - non-interactive Camera Mode
• -StaticCamera360 - non-interactive Camera Mode using 360 equirectangular rendering
• -MixedRealityCamera - non-interactive Camera Mode using Mixed Reality rendering
• -LegacySteamVRInput - Force Legacy Steam VR Input Handling. Used as a work-around for some Steam VR devices that have a missing or bad hand skeletal model, such as Virtual Desktop used with the Oculus Quest.
• -ForceSRAnipal - Force the SR Anipal SDK to initialize for HTC eye and lip tracking, even if Vive Pro Eye is not present.
• -LegacyScreen - Force Resonite to run in the old Desktop "debugging" mode.
• -EnableOWO Insert_ip_address_here - Enables the OWO Game haptic vest integration, requires you pass in the vest's ip address. Currently not functional, see related Github issue. - 自動検出
• -Screen - - スクリーンモード（デスクトップモードとも呼ばれます）
• -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のレガシー入力処理を強制します。Oculus QuestのVirtual Desktopなど、SteamVRデバイスの一部で手や指のスケルトンモデルが欠落または不具合がある場合の回避策として使用されます。
• -ForceSRAnipal - HTCの視線・リップトラッキング用のSRAnipal SDKを、Vive Pro Eyeが接続されていない場合でも強制的に初期化します。
• -ForceBabble - Forces the Babble driver to initialize for Project Babble face tracking, even if a Babble is not running.

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

• -Join Auto -
• -Join Auto - LAN上のアクティブセッションに自動的に参加してフォーカスします（最も多くのユーザーがいるワールドに切り替わります）
• -Join Insert_URL_or_IP:Port_here - 指定されたURI（Resonite-session | lnl）でセッションに参加します
• -Open Insert_URL_here - 起動時に指定されたURLのワールドを開きます（resrec）
• -Scratchspace Insert_port_here - Starts a new scratchspace world on a given port (legacy, will be likely removed)
• -AnnounceHomeOnLAN - ホームワールドと ユーザースペースがデフォルトでLANからアクセス可能になります
• -Bootstrap Insert_bootstrap_class_here - Run a custom bootstrap function in a class of given name
• -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ネットワーク上のみに公開され、インターネットからはアクセスできません
• -UseLocalCloud - Uses local cloud API servers - used mostly for debugging
• -UseStagingCloud - Uses Staging API servers - used mostly for debugging

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

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

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

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

These initialize the static camera with a drone script, using a specific movement preset.

You can also move the default Log files directory.

• -DataPath path/to/data/dir -
• -CameraBiggestGroup
• -CameraTimelapse
• -CameraStayBehind
• -CameraStayInFront
• -CachePath path/to/cache/dir -

And also these args usable for Drone Camera.

• -UseResoniteCamera - Will spawn Static Camera as the Resonite Camera with zoom controls, preview and other functions
• -LogsPath path/to/logs/dir - ログファイルを指定されたカスタムディレクトリに保存するようにリダイレクトします。

共通アバタービルダー

information

• -RepairDatabase - データベースに問題がある場合は、データベース修復が問題解決の助けになるかもしれません。
• -ResetDash - ダッシュメニューのレイアウトをデフォルトの設定にリセットします。

Incorrect use of these arguments is likely to result in unrecoverable data-loss. Do not use without first going through Sync errors

• -DeleteUnsyncedCloudRecords - Delete any local un-synced files/items from your computer and re-download the cloud copies.
• -ForceSyncConflictingCloudRecords - Force the conflicting local files/items to be uploaded to the cloud, overwriting existing copy.

データフォルダー

Resoniteには複数のデータフォルダーがあり、これらを制御するためのさまざまなコマンドライン引数があります。

• -NeverSaveSettings -
• 起動引数を使用して、データフォルダーを他の場所に移動することができます。
• -NeverSaveDash - ダッシュボードの変更内容の保存と同期を無効化します。これもテストやプレリリース向けに役立ちます。
• -Watchdog Insert_filepath_here - Resoniteは指定されたファイルに定期的に現在時刻を書き込みます。この機能は、プロセスがフリーズした際に自動的に再起動するための監視に利用できます。
• -Verbose - エンジン初期化時の詳細なログを出力します。プラグイン開発者やデバッグ時に有用です。
• -CloudProfile - 使用するクラウドAPIサーバーを指定します（デバッグ目的で使用されます）。有効な値：Production, Staging, Local Production / Staging / Local
• -BackgroundWorkersInsert_number_here - バックグラウンドワーカーのプロセス数を指定した数に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が不安定になる可能性があります。
• -PriorityWorkers Insert_number_here - 優先度付きワーカープロセスの数を指定した値に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が壊れる可能性があります。
• -ValidateTypes - 読み込まれたすべての DataModel 型が検証テストに合格しているかを内部的にチェックし、ログに記録します。
• -EngineConfig path/to/config - カスタムの起動設定ファイルを指定します。
• -AttachRenderer - will attach to existing instance of a running renderer (mainly Renderite in Unity Editor). This is intended for debugging & profiling purposes.
• -Renderer path/to/executable - Will make Resonite use alternate renderer at this path, instead of the default one

ログフォルダー

• -LogsPath C:\specified\directory - ログファイルを指定されたカスタムディレクトリに保存するようにリダイレクトします。
• -Kiosk - Resoniteをキオスクモードで実行します（ユーザースペースのアイテム（ロゴやワールドスイッチャーなど）を非表示にし、ゲストのテレポートをデフォルトで無効にします）。
• -NoUI - ユーザースペースのUIを非表示にします。
• -SkipIntroTutorial - 起動時にゲームのチュートリアルを始めないようにします。
• -Forceintrotutorial - 起動時にゲームのチュートリアルを強制的に開始します。
• -ForceLANOnly - すべてのワールドはデフォルトでLANネットワーク上のみに公開され、インターネットからはアクセスできません

同期の問題

• -Invisible - * 同期の問題が発生している場合は、同期エラーを参照してください。そこには、起動引数を使用して同期の問題を解決するためのさまざまなガイドがあります。
• -DisablePlatformInterfaces - すべてのプラットフォームインターフェースを無効にします。これには、DiscordやSteamのリッチプレゼンス、クリップボードマネージャーなども含まれます。この引数を使うことで、Resoniteがホストシステムに自身を通知しなくなります。

データベース修復

• -ForceNoVoice - * データベースの問題が発生している場合は、データベース修復を参照してください。そこには、起動引数を使用して問題を解決するためのガイドがあります。
• -LoadAssembly Insert_path_here - 指定されたパスのCLRアセンブリをResoniteプロセスに読み込みます。
• -CubemapResolution Insert_resolution_here - 360度正距円筒レンダリングで使用されるキューブマップの解像度を強制的に指定します。
• -DoNotAutoLoadHome - 起動時にクラウドホームが自動で読み込まれることはありません（手動で読み込むことは可能です）。あるいは、Settings#Favorites でユーザーごとの設定として指定することもできます。
• -ForceReticleAboveHorizon - デスクトップでの一人称視点時に、視点を水平線より下に向けられないようにします（デフォルトで有効）。
• -GeneratePrecache - クラウドのレコードをnormal 通常のキャッシュ保存先に加え、 (Resonite install folder)/RuntimeData/PreCache にもキャッシュします。
• -ExportDatabaseAll Insert_path_here - ローカルデータベース内のすべての記録（ユーザー記録やグループ記録を含む）を指定したパスにエクスポートします。
• -ExportDatabaseMachine Insert_path_here - ローカルマシンが所有する記録（ローカルワールドや設定など）を指定したパスにエクスポートします。
• -ForceAprilFools - Forces the game to activate April Fools mode, even if the date is not April 1st.

How to use command line arguments

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

それぞれの例では、-Invisible 引数と -CachePath Insert_path_here 引数を組み合わせて使う方法を説明しています。ここでは、デフォルト以外のキャッシュ保存先として D:\Temporary files\ResoniteCache\ を指定する方法を例示しています。

どの方法を使うのが最適かは、普段Resoniteをどのように起動しているかによって異なります。ほとんどのユーザーにとっては、#Steamからの起動 に記載されている方法が最適でしょう。

Steamからの起動

1. Steamを開きます
2. Steam ライブラリ内の Resonite を右クリックします
3. 「プロパティ」を選択し「起動オプション」を見ます。
4. 上記の通りに正確にコマンドを入力します。

この設定を行った後、Steam経由でResoniteを起動すると、指定したカスタムコマンドライン引数が有効になります。

この方法で入力したコマンドは、Resonite.exeを直接起動するなど、通常とは異なる方法でResoniteを起動した場合には反映されません。

スタンドアロンビルドの場合

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.

例

ここでは、コマンドライン引数の設定例とそれによって可能になることをいくつか紹介します：

• Single world experience - コマンドライン引数を使って、単一のワールド体験専用のResoniteを構成できます。イベント会場や展示会などでの使用に便利です。
• Automatically join a session - コマンドライン引数を使って、起動時に自動で特定のセッションに参加するResoniteを作成できます。教室や会議などでの利用に適しています。