Unity エディター コマンドライン引数リファレンス
コマンドラインから Unity エディターのバージョンを起動するときに使用できる引数のリスト。
読み終わるまでの所要時間 59 分最終更新 6日前
Unity エディターとプレイヤーは、追加のコマンドライン引数を使用して起動動作のコントロール、設定、ワークフローの自動化を行うことができます。
これらの引数を使用するには、端末またはコマンドプロンプトから起動するときに Unity 実行ファイルのパスに追加します。例えば などです。
unity.exe -batchmode -quit -executeMethod MyClass.MyMethod詳細については、「コマンドライン インターフェースから Unity を実行する」を参照してください。
- 設定引数
- バッチ モードの引数
- ビルド引数
- Unity Accelerator キャッシュ サーバーの引数
- デバッグ引数
- グラフィックス API 引数
- ライセンス引数
- Metal 引数(macOS のみ)
- プロファイラー引数
- Unity エディター特殊コマンドライン引数
- Unity Hub 特殊コマンドライン引数
- 追加リソース
設定引数
Unity エディターを実行し、起動時に追加のコマンドや情報を使用して Unity アプリケーションをビルドできます。このページでは、Unity エディターと Unity Player インスタンスの起動と設定に使用できるコマンドライン引数を示します。
** コマンド | 説明 |
|---|---|
| 指定したパスに空のプロジェクトを作成します。 |
| 例 (Windows): 例 (macOS): 例 (Linux): |
| エディター起動時にインポーター一貫性チェックを実行します。デフォルトでは、Unity は**ノート:**一貫性チェック モードは、Unity Accelerator へのアップロードを無効にします。これは、インポーター出力が決定論的であることをテストするために使用されます。詳細については、 |
| Unity がアセットのインポートを比較するときにチェックするソースを設定します。以下の値から選択します。
|
| Unity が自動更新時に無視するアセンブリ名のスペース区切りリストをパラメーターとして指定します。 スペースで区切られたアセンブリ名のリストは任意です。例 1 のように、アセンブリ名を指定せずにコマンドラインオプションを渡すと、すべてのアセンブリが無視されます。 例 1 例 2 例 2 には 2 つのアセンブリ名があり、1 つはパス名です。例 2 では、 これを使用して、アセンブリのインポート時の不要な API アップデーターのオーバーヘッドを回避します。 この引数は、更新する必要のない Unity API にアクセスするアセンブリをインポートする場合に便利です。また、Unity API にまったくアクセスしないアセンブリをインポートする場合 (例えば、ソースコードの一部またはすべてを Unity の外部でビルドし、その結果のアセンブリを Unity プロジェクトにインポートする場合) にも役立ちます。 ノート:
|
| 起動時のグラフィックス処理単位(GPU)スキニングを使用不可にします。 |
| Unity がプロジェクトを開いた直後、かつ任意のアセットサーバーの更新が完了した後に、静的メソッドを実行します。これは、継続的インテグレーション、単位テストの実行、構築、データの準備などのタスクに使用できます。コマンドライン プロセスからエラーを返すには、Unity が戻りコード 1 で終了する例外をスローするか、戻りコードが 0 以外の パラメータを渡すには、コマンドラインに追加し、 |
| パス(または一連のパス)を指定してパッケージをエクスポートします。この例では、 |
| 指定のアセットパッケージをインポートします。Unity はインポートダイアログをまったくディスプレイしません。 |
| Unity JobQueue Job Worker Count の最大スレッド数を指定します。 |
| アセットガベージコレクターヘルパースレッドの数を指定します。デフォルト値は使用可能なコア数です。 |
| Unity がエディターのログファイルを書き込むファイルパスの場所を指定します。ログ ファイルのデフォルトの場所の詳細については、ログ ファイル リファレンスを参照してください。コンソールに出力するには、パス名に 例 (Windows): 例 (macOS): 例 (Linux): UPM 背景アプリケーションのログ ファイルの場所を指定するには、 |
| Unity Package Manager を無効にします。 |
| シーンまたはパッケージファイルへのパスからプロジェクトを開きます。または、 |
| Unity エディターのアクティベーション中に、ログインフォームにパスワードを入力します。 |
| 指定したパスでプロジェクトを開きます。絶対パスまたは現在の作業ディレクトリからの相対パスで指定できます。パス名にスペースが含まれている場合は、引用符で囲みます。 |
| 他のコマンドの実行が終了したら、Unity エディターを終了します。これにより、エラーメッセージを非表示にできますが、エディタのログファイルには表示されます。
|
| |
| リリース コード最適化モードをイネーブルにし、セッションの現在のデフォルト コード最適化モードをオーバーライドします。 |
| Android のみ | テクスチャをインポートしたりプロジェクトをビルドする前に、デフォルトのテクスチャ圧縮を希望の形式に設定します。これは、必要な形式でテクスチャを再度インポートする必要がないためです。使用可能な形式は、dxt、PVRTC、atc、etc2、および astc です。テクスチャ圧縮ターゲティングがイネーブルの場合、この引数は無視されます。 ノート:PVRTC 形式は非推奨です。代わりに ASTC または ETC 形式を使用してください。 |
| アセットのインポート時に Unity が適用する最大テクスチャチャサイズ (ピクセル単位) をオーバーライドします。この設定は、プロジェクト内のすべてのテクスチャに影響し、テクスチャインポート設定で個々のテクスチャに設定されたすべての Max Size がオーバーライドされます。値はテクスチャの高ささと幅のどちらか長い方の最制限を表す整数です。サイズ変更時にアスペクト比は常に維持されます。例えば、テクスチャが 2048x1024 ピクセルで |
| Unity がアセットをインポートするときに使用するテクスチャ圧縮設定をオーバーライドします。これは、ローカルでの開発時に、テクスチャのインポートやターゲットゲットの切り替えをスピード化するために特に便利です。詳細については、 |
| スタンドアロン プレイヤーのクラッシュ時に Unity によって表示されるダイアログを表示しないようにします。この引数は、自動化されたビルドまたはテストでプレイヤーを実行するときに、ダイアログプロンプトによって自動化が妨げられるのを防ぐのに役立ちます。 |
| Unity がエディターから独立して実行する UPM 背景アプリケーションのログファイルを書き込むパスとファイル名を指定します。同じコマンドで |
| Unity エディターのアクティベーション中に、ログインフォームにユーザー名を入力します。 |
| Version Controlモードを設定します。使用可能なモードは、注意: スペースを含む |
| このセッションのVersion Controlモードを設定します。使用可能なモードは、注意: スペースを含む |
| エディターを起動せずに、コマンドラインで Unity エディターのバージョン番号を出力します。 |
| すべての Editor.log メッセージの先頭に、現在のタイムスタンプとスレッド ID を付加します。 |
バッチモードの引数
以下の引数を使用して、Unity のバッチモードを設定します。バッチ モードでは、ユーザー入力なしでUnityが定義済みタスクを実行できるため、バッチ モードはテストなどの自動化されたタスクに役立ちます。
** コマンド | 説明 |
|---|---|
| Unity がバッチ モードで起動されたときに API Updater を実行するには、このコマンドライン オプションを使用します。 例: Unity をバッチ モードで起動するときにこのコマンドライン引数を省略すると、API アップデーターは実行されません。コンパイラーエラーが発生する可能性があります。 |
| Unity を バッチモード で実行します。バッチモードでは、Unity は人間によるインタラクションの必要なしにコマンドライン引数を実行します。また、ヒューマンインタラクションを必要とするダイアログ Windows (Save Scene ウィンドウなど) も非表示にします。コマンドライン引数を使用する場合は、常にバッチ モードで Unity を実行してください。バッチモードでは、自動化を中断せずに実行できます。 スクリプト コードの実行中に例外が発生した場合、アセット サーバーの更新が失敗した場合、またはその他の操作が失敗した場合、Unity は戻りコード 1 で即座に終了します。 バッチ モードでは、Unity は最小限のログ出力をコンソールに送信します。ただし、ログファイルには完全なログ情報が含まれています。同じプロジェクトをエディタで開いている間は、プロジェクトをバッチモードで開くことはできません。一度に実行できる Unity のインスタンスは 1 つだけです。 エディタまたはスタンドアロンプレイヤーがバッチモードで実行されているかどうかを確認するには、 application.isBatchMode 演算子を使用します。 |
| この引数を使用すると、コンパイルエラーが発生しても、Unity はアプリケーションの開始を継続します。 |
| これをバッチモードで実行すると、Unity はグラフィックスデバイスを初期化しません。その後、GPU のないマシンで自動化されたワークフローを実行できます。自動化されたワークフローは、ウィンドウにフォーカスがある場合にのみ機能します。フォーカスされていないと、シミュレートされた入力コマンドを送信できません。Enlighten リアルタイムグローバルイルミネーションではメタパスレンダリングに GPU が必要なため、ノート:出力ログはこのモードではオフになります。出力ログの作成をイネーブルにするには、コマンド |
ビルド引数
以下の引数を使用して、コマンドラインからさまざまなプラットフォーム用のプレイヤーをビルドします。コマンドラインからのプレイヤーのビルドの詳細については、コマンドラインからのビルド を参照してください。
** コマンド | 説明 |
|---|---|
| 指定したパスに保存したビルドプロファイルをアクティブなビルドプロファイル (例えば、ノート:
|
| |
| 64 ビットのスタンドアロン Linux プレイヤー(例えば、 |
| 64ビットLinuxヘッドレス シミュレーション プレイヤー(例えば、 |
| 64ビットのスタンドアロンmacOSプレイヤー(例えば |
| エディターを起動するアクティブなビルドターゲットを選択します。使用可能なオプションは、エディターで有効にしたビルドゲットによって異なります。これらのオプションは、API 列挙
|
| 32 ビットのスタンドアロン Windows プレイヤー (例えば、 |
| 64ビットのスタンドアロンWindowsプレイヤー(例えば |
| プロジェクトをロードする前に、スタンドアロンアロンプラットフォームのアクティブなビルドサブターゲットを選択します。
|
Unity Accelerator キャッシュ サーバーの引数
以下の引数を使用して、Unity Accelerator キャッシュ サーバーを Unity で使用するように設定します。これらの引数は、Editor Preferences に保存されている対応する設定をオーバーライドします。
** コマンド | 説明 |
|---|---|
| Unity Accelerator を有効にします。また、 |
| Unity Accelerator インスタンスのエンドポイント アドレスを指定します。 例: デフォルト ポートは |
| Unity Accelerator インスタンスの名前空間プレフィックスを設定します。この引数を名前空間名とともに使用して、キャッシュ サーバー上のデータを分割します。例えば、異なるプロジェクトや Unity バージョンのキャッシュ データを分離します。 例: スペースを含むプレフィックスは、二重引用符( 指定された名前は、メタデータ、アーティファクトファクトデータ、シェーダーキャッシュデータのタイプごとにデータを分ける、キャッシュ内の最大 3 つの名前空間のプレフィックスとして使用されます。 |
| Unity Accelerator インスタンスからのダウンロードを有効または使用不可にします。 |
| Unity Accelerator インスタンスへのアップロードを有効または使用不可にします。 例: |
| プロジェクトのロード中に Unity Accelerator インスタンスへの接続を待機する時間をミリ秒単位で指定します。この時間が経過すると、プロジェクトの初期更新が開始されます。 例: |
| Unity Accelerator の保留中のアップロードが完了するまで Unity を閉じないようにします。これは、Unity Accelerator をコマンドライン引数 |
| 個々のキャッシュサーバーのダウンロードバッチでアーティファクトの数を設定します。ダウンロードバッチは、個々のダウンロードを大きなバッチにグループ化してダウンロード操作の数を減らすために使用される最適化です。 例: デフォルト値は |
| Unity が Unity Accelerator インスタンスに新しいインポートのアップロードを開始したときに、以前にアップロードされていない既存のインポートをアップロードします。以前にアップロードされたインポートは再アップロードされません。 |
| Unity が Unity Accelerator インスタンスに新しいインポートのアップロードを開始したときに、アセットデータベースに既知の以前のすべてのリビジョンを含め、まだアップロードされていない既存のインポートをアップロードします。以前にアップロードされたインポートリビジョンは再アップロードされません。 |
| Unity がキャッシュサーバーへの新しいインポートのアップロードを開始したときに、以前にアップロードされていない既存のシェーダーキャッシュインポートをアップロードします。以前にアップロードされたシェーダーインポートは再アップロードされません。 |
デバッグ引数
** コマンド | 説明 |
|---|---|
| デバッガーリッスンソケットを無効にします。 |
| Unity は 1 つのシェーダーコンパイラーインスタンスのみを起動し、そのタイムアウトを 1 時間に強制します。シェーダーコンパイラーの問題のデバッグに役立ちます。 |
| デバッグ コード最適化モードをイネーブルにし、セッションの現在のデフォルト コード最適化モードをオーバーライドします。 |
| Code Coverage を有効にし、Coverage API へのアクセスを許可します。 |
| DX12検証レイヤーを有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。 |
| DX12 GPU ベースの検証を有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。 |
| Vulkan 検証レイヤーを有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。 |
| 詳細なデバッグを可能にします。すべての設定で、None (なし)、Script Only (スクリプトのみ)、Full (完全) を選択できます (例えば、 |
| エディターを閉じるときに、Unity エディターのメインログファイルに詳細なメモリとパフォーマンスのレポートを追加します。 |
| 起動前にマネージデバッガのアタッチ、設定、添付を待機させます。エディターのプロセス ID を表示するダイアログを生成します。マネージ デバッグの詳細は、『 Unity のデバッグ C# コード 』を参照してください。 |
| エディターを起動する前にネイティブがアタッチ、設定、添付するのを待機させます。エディターのプロセス ID を表示するダイアログを生成します。 |
グラフィックス API 引数
以下の引数を使用して、Unity エディターに特定のグラフィックス API の使用を強制します。
** コマンド | 説明 |
|---|---|
| |
| エディターにレンダリングに Direct3D 11 を使用させます。通常、グラフィックス API はプレイヤー設定に依存します (通常、デフォルトは D3D11)。 |
| エディターにレンダリングに Direct3D 12 を使用させます。通常、グラフィックス API はプレイヤー設定に依存します。 |
| GPU のインデックスを渡すことで、エディターに特定の GPU デバイスを使用させます。例えば、これを使用して、エディターに専用の GPU ではなく内蔵 GPU の使用を強制します。GPUインデックスと物理GPUのマッピングは、システムによってGPUが列挙される順序によって決まります。この列挙型は通常、GPU ドライバーまたは使用され例えば、Metal、Direct3D、Vulkan) によって行われます。通常、インデックス |
| エディターにレンダリングに OpenGL 3/4 コアプロファイルを使用させます。エディタは、使用可能な最良のバージョンの OpenGL と、OpenGL ドライバによって公開されたすべての OpenGL 拡張を使用しようとします。プラットフォームがサポートされていない場合は、Direct3D が使用されます。 |
| に |
| エディタでレンダリングに OpenGL for 埋め込まれたシステムを使用するようにします。エディタは、使用可能な最良の OpenGL ES バージョンと、OpenGL ドライバによって公開されたすべての OpenGL ES 拡張の使用を試みます。 |
| |
| エディターに古い機能 OpenGL バック終了を使用させます。 |
| エディターにレンダリングに Vulkan を使用させます。通常、グラフィックス API はプレイヤー設定に依存します。 |
ライセンス引数
以下の引数を使用して、Unity ライセンスを処理したり、異なるライセンスオプションで Unity エディターを実行したりできます。
** コマンド | 説明 |
|---|---|
| Unity ライセンスを手動でアクティブ化する 3 ステップ プロセスのステップ 1。詳細については、手動ライセンス アクティベーションを参照してください。 |
| Unity ライセンスを手動でアクティブ化する 3 ステップ プロセスのステップ 3。詳細については、手動ライセンス アクティベーションを参照してください。 |
| 現在アクティブなシリアルベースまたは名前付きユーザーライセンスを返却します。フローティング ライセンスの返却に |
| 有料の Unity ライセンスをアクティブ化する。シリアルベース ライセンスをアクティブ化する、または指定ユーザー ライセンスとそのシリアル キーを同時にアクティブ化するには、ノート: |
Metal 引数(macOS のみ)
以下の引数を使用して、Apple デバイスでの Metal グラフィックス API の使用を設定します。
** コマンド | Details: |
|---|---|
| Metal を使用する場合は、エディタに低消費電力デバイスを使用します。 |
| デフォルトのグラフィックス API として Metal をエディタで使用する (macOS のみ)。 |
| Metal キャプチャをエディター内から取得できるようにします。 |
プロファイラー引数
以下の引数を使用して、Unity のプロファイラーの使用を設定します。
** コマンド | 説明 |
|---|---|
| CPU プロファイラーのディーププロファイリングオプションを有効にします。 |
| プレイヤーまたはエディタの開始をプロファイルする。プレイヤーでこの引数を使用すると、ビルドプロファイルで自動接続プロファイラーオプションを有効にしてプレイヤーをビルドするのと同じエフェクトが得られます。 この引数をエディターで使用すると、エディターの開始時に プロファイラー ウィンドウのプロファイラー情報の収集と表示が開始されます。 |
| この引数は、起動時にプロファイル データを .Raw ファイルにストリームするように Unity プロファイラーを設定します。プレイヤーとエディターの両方で動作します。 |
| この引数は、起動時に .Raw ファイルにストリーミングするときにプロファイラーがプロファイルでキャプチャするフレーム数を設定します。プレイヤーでのみ動作します。 |
| デフォルトでは、Unity プロファイラーの |
Unity エディターの特別なコマンドライン引数
これらは、特殊な状況で、または Unity サポートから指示されたときにのみ使用してください。
** コマンド | 説明 |
|---|---|
| より新しいバージョンの Unity で作成した互換性のないアセットを、ダウングレードして現在のバージョンの Unity で使用する場合に使用します。 これを有効にすると、ダウングレードを必要とするプロジェクトを開こうとすると、Unity はこのダウングレードの確認を求めるダイアログを表示します。 ノート:この手順はサポートされていないためリスクが高く、最後の手段としてのみ使用してください。 |
| グローバルイルミネーション (GI) キャッシュフォルダーのカスタムの場所を設定します。値は絶対パスでなければならず、スペースが含まれている場合は引用符で囲む必要があります。 |
| この手順では、 |
Unity Hub の特別なコマンドライン引数
これらは、特殊な状況で、または Unity サポートから指示されたときにのみ使用してください。これらの引数は、デフォルトで Unity Hub を使用しないバージョンの Unity エディターで使用されます。
** コマンド | 説明 |
|---|---|
| HubインテグレーションでUnityエディターを起動します。 |
| UnityエディターとUnity Hub間の通信とインタラクションを可能にします。 |
| Unity Hubセッションの一意の識別子を指定します。 |
サポートされているすべてのバージョンの Unity エディターでは、これらの引数はすでにデフォルトで設定されています。