Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

{{DISPLAYTITLE:起動引数}}<languages />

{{Note|すでに使いたいコマンドライン引数をお持ちですか？ どう使えばいいのか迷っていますか？ それなら [[#起動引数の使用方法|使い方はこちら！]] にスキップしてご覧ください。|suggestion}}

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

これらのコマンドライン引数は、[[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'''''  [https://owogame.com/ OWO Gameの触覚ベスト]との統合機能を有効にします（ベストのIPアドレスを指定する必要があります）。現在のところ機能していません。詳細については関連する[https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/186 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''' - ホームワールドと[[Userspace | ユーザースペース]]がデフォルトでLANからアクセス可能になります
* '''-Bootstrap ''Insert_bootstrap_class_here''''' - 指定したクラス名内のカスタム[[Bootstrapping|ブートストラップ]]関数を実行します。

== ネットワーク ==

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

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

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

* '''-CameraBiggestGroup'''
* '''-CameraTimelapse'''
* '''-CameraStayBehind'''
* '''-CameraStayInFront'''

また、これらの引数はドローンカメラにも使用可能です。
* '''-UseResoniteCamera''' - ズーム操作、プレビュー表示などの機能を備えたResonite Cameraとして静的カメラを生成します。

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

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

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

== ログフォルダー ==

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

== 同期の問題 ==

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

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

== データベース修復 ==
データベースに問題がある場合は、[[Special:MyLanguage/Database repair|データベース修復]]が問題解決の助けになるかもしれません。
* -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を[[Kiosk Mode|キオスクモード]]で実行します（[[Userspace|ユーザースペース]]のアイテム（ロゴやワールドスイッチャーなど）を非表示にし、ゲストのテレポートをデフォルトで無効にします）。
* '''-NoUI''' - [[Userspace|ユーザースペース]]のUIを非表示にします。
* '''-CubemapResolution ''Insert_resolution_here''''' - 360度正距円筒レンダリングで使用されるキューブマップの解像度を強制的に指定します。
* '''-DoNotAutoLoadHome''' - 起動時にクラウドホームが自動で読み込まれることはありません（手動で読み込むことは可能です）。あるいは、[[Settings#Favorites]] でユーザーごとの設定として指定することもできます。
* '''-ResetDash''' - ダッシュメニューのレイアウトをデフォルトの設定にリセットします。
* '''-SkipIntroTutorial''' -  起動時にゲームのチュートリアルを始めないようにします。
* '''-Forceintrotutorial''' -  起動時にゲームのチュートリアルを強制的に開始します。
* '''-Invisible''' -  ログイン時にオンラインステータスを非表示にします。
* '''-EngineConfig ''Insert_filepath_here''''' -  カスタムの[[Startup Config File|起動設定ファイル]]を指定します。
* '''-BackgroundWorkers ''Insert_number_here''''' - バックグラウンドワーカーのプロセス数を指定した数に上書きします。'''注意'''：本当に必要な場合以外は使用しないでください。動作が不安定になる可能性があります。
* '''-PriorityWorkers ''Insert_number_here''''' - 優先度付きワーカープロセスの数を指定した値に上書きします。'''注意'''：本当に必要な場合以外は使用しないでください。動作が壊れる可能性があります。
* '''-ForceReticleAboveHorizon''' - デスクトップでの一人称視点時に、視点を水平線より下に向けられないようにします（デフォルトで有効）。
* '''-Verbose''' - エンジン初期化時の詳細なログを出力します。プラグイン開発者やデバッグ時に有用です。
* '''-GeneratePrecache''' - クラウドのレコードを[[Resonite_Data_Folders#Cache|normal 通常のキャッシュ保存先]]に加え、 <code>(Resonite install folder)/RuntimeData/PreCache</code> にもキャッシュします。
* '''-ExportDatabaseAll ''Insert_path_here''''' - ローカルデータベース内のすべての記録（ユーザー記録やグループ記録を含む）を指定したパスにエクスポートします。
* '''-ExportDatabaseMachine ''Insert_path_here''''' - ローカルマシンが所有する記録（ローカルワールドや設定など）を指定したパスにエクスポートします。
* '''-ValidateTypes''' - 読み込まれたすべての DataModel 型が検証テストに合格しているかを内部的にチェックし、ログに記録します。
* '''-NeverSaveSettings''' - 設定の保存および同期を無効化します。テストやプレリリースビルドに有用です。
* '''-NeverSaveDash''' - ダッシュボードの変更内容の保存と同期を無効化します。これもテストやプレリリース向けに役立ちます。
* '''-DisablePlatformInterfaces''' - すべてのプラットフォームインターフェースを無効にします。これには、DiscordやSteamのリッチプレゼンス、クリップボードマネージャーなども含まれます。この引数を使うことで、Resoniteがホストシステムに自身を通知しなくなります。

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

Resoniteはインストール時に、コンピュータに独自のプロトコルハンドラを登録します。これを使うことで、リンクをクリックするだけで特定の場所やワールドをResoniteで開くことができます。これらの引数はResoniteのランチャーに渡され、Resoniteが起動中であることを確認したうえで、起動中のインスタンスに引数が転送されます。

* '''Resonite:?world=''Insert_URL_here''''' - 指定されたURLのワールドまたはセッションを開きます。
** 例：'''Resonite:?world=resrec:///U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1''' - ProbablePrimeによる「The Directory」というワールドが開かれます。
** セッションの場合の例：'''Resonite:?world=Resonite-session://eea1442e-0ff2-4d6a-ad16-2dac9ea786fc''' - セッション eea1442e-0ff2-4d6a-ad16-2dac9ea786fc に参加します。
ワールドのURLは、ワールドオーブのインスペクタを開いて WorldOrb コンポーネントに移動することで確認できます。または、セッションメニューの「レコードURLをコピー」ボタンを使うことでも取得可能です。

[[File:CopyRecordUrlButton.png|600px|セッションタブのダッシュボードと、レコードURLをコピーボタンがハイライトされた設定画面]]

URLフィールドはダブルクリックで選択でき、Ctrl+CでWindowsのクリップボードにコピーできます。

クリック可能なプロトコルリンクが制限されているプラットフォームでは、代わりに以下のリダイレクト用URLが使用できます：'''<nowiki>https://api.resonite.com/open/</nowiki>''' これらは自動的に Resonite: プロトコルにリダイレクトされます。

* '''<nowiki>https://api.resonite.com/open/world/</nowiki>''Insert_ID_here''''' - 指定されたURLのワールドを開きます。
** 例：'''https://api.resonite.com/open/world/U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1''' - ProbablePrimeの「The Directory」を開きます。

* '''<nowiki>https://api.resonite.com/open/session/</nowiki>''Insert_ID_here''''' - 指定されたURLのセッションに接続します。
** 例：'''https://api.resonite.com/open/session/S-eea1442e-0ff2-4d6a-ad16-2dac9ea786fc''' - セッション S-eea1442e-0ff2-4d6a-ad16-2dac9ea786fc に参加します。

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

[https://docs.unity3d.com/Manual/CommandLineArguments.html Unityスタンドアロンプレイヤーのコマンドライン引数]は、特定の解像度やウィンドウモードを設定するのに便利です。
* '''-screen-fullscreen 0''' - Resoniteをウィンドウモードで起動します。
* '''-screen-fullscreen 1''' - Resoniteをフルスクリーンモードで起動します。
* '''-screen-width''' - 横方向の解像度を設定します。
* '''-screen-height''' - 縦方向の解像度を設定します。
例：<code>-screen-fullscreen 0 -screen-width 1280 -screen-height 720</code> を使用すると、Resoniteは1280x720サイズのウィンドウモードで起動します。

== 起動引数の使用方法 ==

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

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

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

=== Steamからの起動 ===
<span lang="en" dir="ltr" class="mw-content-ltr">{{SteamCommandLineArguments}}</span>

=== スタンドアロンビルドの場合 ===
<span lang="en" dir="ltr" class="mw-content-ltr">{{StandaloneCommandLineArguments}}</span>

==例 ==
ここでは、コマンドライン引数の設定例とそれによって可能になることをいくつか紹介します：
* [[Command Line Arguments/Single world experience|Single world experience]] - コマンドライン引数を使って、単一のワールド体験専用のResoniteを構成できます。イベント会場や展示会などでの使用に便利です。
* [[Command Line Arguments/Automatically join a session|Automatically join a session]] - コマンドライン引数を使って、起動時に自動で特定のセッションに参加するResoniteを作成できます。教室や会議などでの利用に適しています。