起動引数
More actions
Resoniteのデスクトップ版では、いくつかの起動引数を使用できます。現在Resoniteは公式にSteam経由で配布されているため、これらの引数は起動オプションで設定可能です。
Resonite が Steam 経由でのカスタムプロトコル（URL）起動をどのように処理しているか、またはその修正方法については、Custom protocol handler を参照してください。
カテゴリー別
特定のハードウェアを強制使用する
none- ハードウェアを自動検出します。-Screen- 強制的に スクリーンモードにします。-Device SteamVR- 強制的にSteamVRを使用します。-Device WindowsMR- 強制的にWindows Mixed Reality を使用します。-Device Oculus- 強制的にOculus Rift + Touchコントローラー を使用します。-Device OculusQuest- 強制的にOculus Quest + Touchコントローラー を使用します。-Device Screen360- 強制的にスクリーンモード（360度投影付き）を使用します。-Device StaticCamera- 強制的にResoniteを非インタラクティブカメラモードにします。-Device StaticCamera360- 強制的にResoniteを360度正距円筒レンダリング を使用した非インタラクティブカメラモードにします。-LegacySteamVRInput- SteamVRのレガシー入力処理を強制します。Oculus Questで使用されるVirtual Desktopなど、手の骨格モデルが欠落している、または不具合のある一部のSteamVRデバイスに対する回避策として使用されます。-ForceSRAnipal- HTCの視線・リップトラッキング用のSRAnipal SDKを、Vive Pro Eyeが接続されていない場合でも強制的に初期化します。-ForceBabble- Babbleドライバを強制的に初期化し、Babbleアプリケーションが実行されていない場合でもProject Babbleの顔追跡機能を使用可能にします。
セッションへ参加 / ワールドを開く
-Join Auto- 起動時にLAN上のアクティブなセッションに自動的に参加し、参加者が最も多いセッションにフォーカスします。-Join Insert_URL_or_IP:Port_here- 指定されたURI（Resonite-session | lnl）でセッションに参加します-Open Insert_resrec_URL_here- 起動時に指定された resrec URL で指定されているワールドを開きます。-Scratchspace Insert_port_here- 指定されたポートで新しいスクラッチスペース（Scratchspace）ワールドを起動します。注意: スクラッチスペースはレガシー機能です。この引数は将来的に削除される可能性があります。-AnnounceHomeOnLAN- ホームワールドと ユーザースペースがデフォルトでLANからアクセス可能な状態でResoniteを起動します。-Bootstrap Insert_bootstrap_class_here- 指定されたクラス内でカスタムブートストラップ関数を実行します。
ドローンカメラプリセット
これらのオプションは、ドローン用スクリプトを使用して静的カメラを初期化し、特定の移動プリセットを適用します。
-CameraBiggestGroup-CameraTimelapse-CameraStayBehind-CameraStayInFront
また、これらの引数はドローンカメラにも使用可能です。
-UseResoniteCamera- ズーム操作、プレビュー表示などの機能を備えたResonite Cameraとして静的カメラを生成します。
データ/ログフォルダ
Resoniteには複数のデータフォルダーがあり、これらを制御するためのさまざまなコマンドライン引数があります。それらの引数を使用する前に、必ず Relocate Resonite Folders を読んで内容を理解してください。そうしないと、データが失われる可能性があります。 You can also move the default Log files directory.
-DataPath path/to/data/dir- データベースディレクトリへのパスを指定します。-CachePath path/to/cache/dir- キャッシュディレクトリへのパスを指定します。-LogsPath path/to/logs/dir- ログファイルを指定されたカスタムディレクトリに保存するようにリダイレクトします。
復旧
-RepairDatabase- データベースに問題がある場合は、データベース修復が問題解決の助けになるかもしれません。-ResetDash- ダッシュメニューのレイアウトをデフォルトの設定にリセットします。
-DeleteUnsyncedCloudRecords- ローカル環境に同期されていないファイル/アイテムを削除し、クラウド上の最新コピーを再ダウンロードします。-ForceSyncConflictingCloudRecords- 競合するローカルファイル/アイテムを強制的にクラウドにアップロードし、既存のコピーを上書きします。
テスト/デバッグ
Resoniteには複数のデータフォルダーがあり、これらを制御するためのさまざまなコマンドライン引数があります。
-NeverSaveSettings- 設定の保存と同期を無効化します。テスト用途やリリース前ビルドの検証時に便利です。-NeverSaveDash- ダッシュボードの変更内容の保存と同期を無効化します。これもテストやプレリリース向けに役立ちます。-WatchdogInsert_filepath_here - Resoniteは指定されたファイルに定期的に現在時刻を書き込みます。この機能は、プロセスがフリーズした際に自動的に再起動するための監視に利用できます。-Verbose- エンジン初期化時の詳細なログを出力します。プラグイン開発者やデバッグ時に有用です。-CloudProfile- 使用するクラウドAPIサーバーを指定します（デバッグ目的で使用されます）。有効な値：Production/Staging/Local-BackgroundWorkersInsert_number_here- バックグラウンドワーカーのプロセス数を指定した数に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が不安定になる可能性があります。-PriorityWorkers Insert_number_here'' - 優先度付きワーカープロセスの数を指定した値に上書きします。注意：本当に必要な場合以外は使用しないでください。動作が壊れる可能性があります。-ValidateTypes- 読み込まれたすべての DataModel 型が検証テストに合格しているかを内部的にチェックし、ログに記録します。-EngineConfig path/to/config- カスタムの起動設定ファイルを指定します。-AttachRenderer- 実行中のレンダラーインスタンス（主にUnityエディタ内のRenderite）にアタッチします。これはデバッグおよびプロファイリング用途を想定しています。-Renderer path/to/executable- デフォルトのレンダラーではなく、このパスに指定した代替レンダラーを使用するようにResoniteを設定します
キオスク／展示／教室のオプション
これらの起動引数は、スタンドアローン体験の設定時にも役立つ場合があります。
-Kiosk- Resoniteをキオスクモードで実行します（ユーザースペースのアイテム（ロゴやワールドスイッチャーなど）を非表示にし、ゲストのテレポートをデフォルトで無効にします）。-NoUI- ユーザースペースのUIを非表示にします。-SkipIntroTutorial- 起動時にゲームのチュートリアルを始めないようにします。-Forceintrotutorial- 起動時にゲームのチュートリアルを強制的に開始します。-ForceLANOnly- デフォルトでは、すべてのセッションがLANネットワーク上のみで公開され、インターネットからはアクセスできないように設定されます。
プライバシー
-Invisible- ログイン時にオンラインステータスを非表示にします。-DisablePlatformInterfaces- すべてのプラットフォームインターフェースを無効にします。これには、DiscordやSteamのリッチプレゼンス、クリップボードマネージャーなども含まれます。この引数を使うことで、Resoniteがホストシステムに自身を通知しなくなります。
その他
-ForceNoVoice- CommonAvatarBuilderが、アバターに音声機能を一切セットアップしなくなります（ローカルでのプレゼンテーションなどに役立ちます）。-LoadAssemblyInsert_path_here - 指定されたCLRアセンブリをResoniteプロセスに読み込みます。主にModding（ゲーム改造）用途で使用されます。-CubemapResolutionInsert_resolution_here - 360度正距円筒レンダリングで使用されるキューブマップの解像度を強制的に指定します。-DoNotAutoLoadHome- 起動時にクラウドホームが自動で読み込まれることはありません（手動で読み込むことは可能です）。あるいは、Settings#Favorites でユーザーごとの設定として指定することもできます。-ForceReticleAboveHorizon- デスクトップでの一人称視点時に、視点を水平線より下に向けられないようにします（デフォルトで有効）。-GeneratePrecache- クラウドのレコードをnormal 通常のキャッシュ保存先に加え、(Resonite install folder)/RuntimeData/PreCacheにもキャッシュします。-ExportDatabaseAllInsert_path_here - ローカルデータベース内のすべての記録（ユーザー記録やグループ記録を含む）を指定したパスにエクスポートします。-ExportDatabaseMachineInsert_path_here - ローカルマシンが所有する記録（ローカルワールドや設定など）を指定したパスにエクスポートします。-ForceAprilFools- 日付が4月1日でなくても、強制的にエイプリルフールモードを起動させます。
起動引数の使用方法
以下は、コマンドライン引数を使ってResoniteを起動するための3つの方法です。
それぞれの例では、-Invisible 引数と -CachePath Insert_path_here 引数を組み合わせて使う方法を説明しています。ここでは、デフォルト以外のキャッシュ保存先として D:\Temporary files\ResoniteCache\ を指定する方法を例示しています。
どの方法を使うのが最適かは、普段Resoniteをどのように起動しているかによって異なります。ほとんどのユーザーにとっては、#Steamからの起動 に記載されている方法が最適でしょう。
Steamからの起動
- Steamを開きます
- Steam ライブラリ内の Resonite を右クリックします
- 「プロパティ」を選択し「起動オプション」を見ます。
- 上記の通りに正確にコマンドを入力します。
この設定を行った後、Steam経由でResoniteを起動すると、指定したカスタムコマンドライン引数が有効になります。
この方法で入力したコマンドは、Resonite.exeを直接起動するなど、通常とは異なる方法でResoniteを起動した場合には反映されません。
スタンドアロンビルドの場合
ショートカットを使用する
Resonite.exe ファイルを対象としたカスタムショートカットを使用して、起動コマンドを実行することが可能です。
ショートカットを作成するには：
- Resoniteのインストールフォルダを探し、Resonite.exeファイルを右クリックします。
- 表示されるコンテキストメニューから「ショートカットの作成」を選択します。
- 作成した「Resonite.exe - ショートカット」ファイルを、より便利な場所（例えばデスクトップなど）に移動します。
- ショートカットファイルを右クリックし、コンテキストメニューから「プロパティ」を選択します。
- ダイアログウィンドウが表示されますので、「ショートカット」タブを選択します。
- 「対象」テキストボックス内で、Resonite.exeのファイルパスの後にスペースを挿入し、続けてコマンドライン引数を追加します。
- 「適用」ボタンをクリックし、その後「OK」ボタンをクリックします。
この設定を有効にすると、ショートカットをダブルクリックしてResoniteを起動した場合、カスタムオプションが適用された状態で起動します。ただし、別の方法でResoniteを起動した場合はこれらの設定は反映されません。
例
ここでは、コマンドライン引数の設定例とそれによって可能になることをいくつか紹介します：
- Single world experience - コマンドライン引数を使って、単一のワールド体験専用のResoniteを構成できます。イベント会場や展示会などでの使用に便利です。
- Automatically join a session - コマンドライン引数を使って、起動時に自動で特定のセッションに参加するResoniteを作成できます。教室や会議などでの利用に適しています。