ドキュメント

Unity Engine

Unity Engine

Unity エディター コマンドライン引数リファレンス

コマンドラインから Unity エディターのバージョンを起動するときに使用できる引数のリスト。
読み終わるまでの所要時間 59 分最終更新 6日前

Unity エディターとプレイヤーは、追加のコマンドライン引数を使用して起動動作のコントロール、設定、ワークフローの自動化を行うことができます。
これらの引数を使用するには、端末またはコマンドプロンプトから起動するときに Unity 実行ファイルのパスに追加します。例えば
unity.exe -batchmode -quit -executeMethod MyClass.MyMethod
などです。
詳細については、「コマンドライン インターフェースから Unity を実行する」を参照してください。

設定引数

Unity エディターを実行し、起動時に追加のコマンドや情報を使用して Unity アプリケーションをビルドできます。このページでは、Unity エディターと Unity Player インスタンスの起動と設定に使用できるコマンドライン引数を示します。

** コマンド

説明

-createProject <pathname>
指定したパスに空のプロジェクトを作成します。
-cloneFromTemplate <template-path>
-cloneFromTemplate
を
-createProject
と組み合わせて使用すると、
-createProject
で指定したパスに、
-cloneFromTemplate
で指定したテンプレートアーカイブまたはディレクトリを使用して新しいプロジェクトを作成できます。

例 (Windows):
-createProject "C:\Projects\MyProject" -cloneFromTemplate "C:\Path\To\Templates\com.unity.template.urp-blank-17.1.0.tgz"

例 (macOS):
-createProject "/Users/username/Projects/MyProject" -cloneFromTemplate "/Users/username/Library/Application Support/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"

例 (Linux):
-createProject "/home/username/Projects/MyProject" -cloneFromTemplate "/home/username/.config/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"
-consistencyCheck
エディター起動時にインポーター一貫性チェックを実行します。デフォルトでは、Unity は
local
チェックを実行し、すべてのアセットをローカルに再インポートします。また、インポートが前回のインポートと異なるかどうかも確認します。

**ノート:**一貫性チェック モードは、Unity Accelerator へのアップロードを無効にします。これは、インポーター出力が決定論的であることをテストするために使用されます。詳細については、
-consistencyCheckSourceMode
の説明を参照してください。
-consistencyCheckSourceMode string
Unity がアセットのインポートを比較するときにチェックするソースを設定します。以下の値から選択します。
  • local
    : すべてのアセットをローカルに再インポートし、インポートが前回のインポートと異なるかどうかを確認します。
  • cacheserver
    : Unity Accelerator を有効にした場合、このオプションはキャッシュサーバーからアセットのメタデータを取得し、ローカルの結果がキャッシュサーバー上の結果と一致するかどうかを比較します。このオプションは、キャッシュサーバーに存在するアセットのみを再インポートします。一貫性チェックに成功すると、元のインポート結果が保持されます。結果が一貫していて、すでにキャッシュされているため、アップロードは必要ありません。チェックに失敗すると、失敗したインポートの詳細を示すエディターログメッセージがログに記録されます。一貫性のない結果は、キャッシュポイズニングを防ぐためにアップロードされません。
詳細については、「 インポーターの整合性の確認 」を参照してください。
-disable-assembly-updater <assembly1 assembly2>
Unity が自動更新時に無視するアセンブリ名のスペース区切りリストをパラメーターとして指定します。

スペースで区切られたアセンブリ名のリストは任意です。例 1 のように、アセンブリ名を指定せずにコマンドラインオプションを渡すと、すべてのアセンブリが無視されます。

例 1
unity.exe -disable-assembly-updater


例 2
unity.exe -disable-assembly-updater A1.dll subfolder/A2.dll


例 2 には 2 つのアセンブリ名があり、1 つはパス名です。例 2 では、
A1.dll
がどのフォルダーに格納されているかにかかわらず、
subfolder
フォルダーに格納されている場合にのみ
A2.dll
を無視します。

-disable-assembly-updater
コマンドライン パラメーターにアセンブリをリストする場合 (またはアセンブリを指定しない場合)、Unity は以下のメッセージを Editor.log に記録します。

[Assembly Updater] warning: Ignoring assembly [assembly_path] as requested by command line parameter.”).


これを使用して、アセンブリのインポート時の不要な API アップデーターのオーバーヘッドを回避します。

この引数は、更新する必要のない Unity API にアクセスするアセンブリをインポートする場合に便利です。また、Unity API にまったくアクセスしないアセンブリをインポートする場合 (例えば、ソースコードの一部またはすべてを Unity の外部でビルドし、その結果のアセンブリを Unity プロジェクトにインポートする場合) にも役立ちます。

ノート:
  • 更新が必要なアセンブリの更新を使用不可にすると、コンパイル時、ランタイム、またはその両方で追跡困難なエラーが発生する可能性があります。
  • この引数は、API Updater の AssemblyUpdater コンポーネントだけを無効にします。API アップデーターの ScriptUpdater コンポーネントは、
    -accept-apiupdate
    引数を指定せずにバッチモードでエディターを実行しない限り、パッケージを含むプロジェクトのコードに対して実行されます。詳細については、バッチ モードの引数 を参照してください。
-disable-gpu-skinning
起動時のグラフィックス処理単位(GPU)スキニングを使用不可にします。
-executeMethod <ClassName.MethodName>
または
-executeMethod <NamespaceName.ClassName.MethodName>
Unity がプロジェクトを開いた直後、かつ任意のアセットサーバーの更新が完了した後に、静的メソッドを実行します。これは、継続的インテグレーション、単位テストの実行、構築、データの準備などのタスクに使用できます。
-activeBuildProfile
が指定されている場合、Unity は
-executeMethod
を実行する前にプロファイルのスクリプト定義でスクリプトをコンパイルします。

コマンドライン プロセスからエラーを返すには、Unity が戻りコード 1 で終了する例外をスローするか、戻りコードが 0 以外の
EditorApplication.Exit
を呼び出します。

パラメータを渡すには、コマンドラインに追加し、
System.Environment.GetCommandLineArgs
を使用して関数内で取得します。
-executeMethod
を使用するには、含まれるスクリプトを Editor フォルダーに配置する必要があります。実行するメソッドは静的として定義する必要があります。
-exportPackage <exportAssetPath1 exportAssetPath2 ExportAssetPath3 exportFileName>
パス(または一連のパス)を指定してパッケージをエクスポートします。この例では、
exportAssetPath
はUnityプロジェクトからエクスポートするフォルダー(Unityプロジェクトのルートからの相対パス)で、
exportFileName
はパッケージ名です。このオプションは、一度にフォルダ全体をエクスポートするだけです。通常、このコマンドは
-projectPath
引数とともに使用する必要があります。
-importPackage <pathname>
指定のアセットパッケージをインポートします。Unity はインポートダイアログをまったくディスプレイしません。
-job-worker-count <N>
Unity JobQueue Job Worker Count の最大スレッド数を指定します。
-gc-helper-count <N>
アセットガベージコレクターヘルパースレッドの数を指定します。デフォルト値は使用可能なコア数です。
-logFile <pathname>
Unity がエディターのログファイルを書き込むファイルパスの場所を指定します。ログ ファイルのデフォルトの場所の詳細については、ログ ファイル リファレンスを参照してください。コンソールに出力するには、パス名に
-
を指定します。Windows では、
-logFile
を使用して出力を
stdout
に送信できます。デフォルトではコンソールではありません。パスにスペースが含まれている場合は、二重引用符で囲みます。コマンドインターフェースによっては、パスにスペースが含まれていない場合でも、パスを引用符で囲む必要がある場合があります。

例 (Windows):
"C:\Program Files\Unity\Hub\Editor\<Version>\Editor\Unity.exe" -projectPath "C:\Projects\MyGame" -logFile "C:\Logs\Editor.log"

例 (macOS):
"/Applications/Unity/Hub/Editor/<Version>/Unity.app/Contents/MacOS/Unity" -projectPath "/Users/me/Projects/MyGame" -logFile "/Users/me/Logs/Editor.log"

例 (Linux):
"/opt/Unity/Hub/Editor/<Version>/Editor/Unity" -projectPath "/home/me/Projects/MyGame" -logFile "/home/me/logs/Editor.log"


UPM 背景アプリケーションのログ ファイルの場所を指定するには、
-upmLogFile
の説明を参照してください。
-noUpm
Unity Package Manager を無効にします。
-openfile <path>
シーンまたはパッケージファイルへのパスからプロジェクトを開きます。または、
-projectPath
引数を使用できます。
-password <password>
Unity エディターのアクティベーション中に、ログインフォームにパスワードを入力します。
-projectPath <pathname>
指定したパスでプロジェクトを開きます。絶対パスまたは現在の作業ディレクトリからの相対パスで指定できます。パス名にスペースが含まれている場合は、引用符で囲みます。
-quit
他のコマンドの実行が終了したら、Unity エディターを終了します。これにより、エラーメッセージを非表示にできますが、エディタのログファイルには表示されます。
-quit
引数には以下の制限事項があります。
  • エディターが Accelerator Cache Server に接続されている場合は、保留中のキャッシュのアップロードが完了する前に Unity が終了しないように、追加の引数
    -cacheServerWaitForUploadCompletion
    が必要です。
  • エディターが
    -runTests
    引数を使用してテストを実行している場合、
    -quit
    を実行すると、進行中のテストが完了する前にエディターが即座に終了します。
  • エディターが非同期コードを実行している場合、
    -quit
    によってアプリケーションがハングし、応答しなくなる可能性があります。
-quitTimeout
-quit
引数を使用すると、エディターは保留中の非同期タスクがデフォルトのタイムアウト 300 秒で終了するのを待ちます。このパラメーターを使用して、異なるタイムアウトを秒単位で設定します。
-releaseCodeOptimization
リリース コード最適化モードをイネーブルにし、セッションの現在のデフォルト コード最適化モードをオーバーライドします。
Android のみテクスチャをインポートしたりプロジェクトをビルドする前に、デフォルトのテクスチャ圧縮を希望の形式に設定します。これは、必要な形式でテクスチャを再度インポートする必要がないためです。使用可能な形式は、dxt、PVRTC、atc、etc2、および astc です。テクスチャ圧縮ターゲティングがイネーブルの場合、この引数は無視されます。
ノート:PVRTC 形式は非推奨です。代わりに ASTC または ETC 形式を使用してください。
-overrideMaxTextureSize
アセットのインポート時に Unity が適用する最大テクスチャチャサイズ (ピクセル単位) をオーバーライドします。この設定は、プロジェクト内のすべてのテクスチャに影響し、テクスチャインポート設定で個々のテクスチャに設定されたすべての Max Size がオーバーライドされます。値はテクスチャの高ささと幅のどちらか長い方の最制限を表す整数です。サイズ変更時にアスペクト比は常に維持されます。例えば、テクスチャが 2048x1024 ピクセルで
-overrideMaxTextureSize
が 512 に設定されている場合、Unity は 512x256 ピクセルのサイズでテクスチャをインポートします。詳細については、
EditorUserBuildSettings.overrideMaxTextureSize
を参照してください。
-overrideTextureCompression
Unity がアセットをインポートするときに使用するテクスチャ圧縮設定をオーバーライドします。これは、ローカルでの開発時に、テクスチャのインポートやターゲットゲットの切り替えをスピード化するために特に便利です。詳細については、
EditorUserBuildSettings.overrideTextureCompression
を参照してください。
-silent-crashes
スタンドアロン プレイヤーのクラッシュ時に Unity によって表示されるダイアログを表示しないようにします。この引数は、自動化されたビルドまたはテストでプレイヤーを実行するときに、ダイアログプロンプトによって自動化が妨げられるのを防ぐのに役立ちます。
-upmLogFile <pathname>
Unity がエディターから独立して実行する UPM 背景アプリケーションのログファイルを書き込むパスとファイル名を指定します。同じコマンドで
-upmLogFile
と
-logFile
を指定できます。両方の引数を含めると、2 つのログファイルに独立したパスを指定できます。
-username <username>
Unity エディターのアクティベーション中に、ログインフォームにユーザー名を入力します。
-vcsMode <mode>
Version Controlモードを設定します。使用可能なモードは、
"Visible Meta Files"
、
"Hidden Meta Files"
、
Perforce
、および
PlasticSCM
です。追加のフラグを使用して、特定の Version Control モードの設定フィールドを埋めることができます。これらのフラグは、プロバイダー.GetActiveConfigFields メソッドに基づいています。例えば、
-vcPerforceUsername
、
-vcPerforcePassword
、
-vcPerforceWorkspace
、および
-vcPerforceServer
を使用して、Perforce のユーザ名、ワークスペース、およびサーバーフィールドを設定できます。

注意: スペースを含む
<mode>
引数は、二重引用符 (") で囲む必要があります。
-vcsModeSession <mode>
このセッションのVersion Controlモードを設定します。使用可能なモードは、
"Visible Meta Files"
、
"Hidden Meta Files"
、
Perforce
、および
PlasticSCM
です。追加のフラグを使用して、特定の Version Control モードの設定フィールドを埋めることができます。これらのフラグは、プロバイダー.GetActiveConfigFields メソッドに基づいています。例えば、
-vcPerforceUsername
、
-vcPerforcePassword
、
-vcPerforceWorkspace
、および
-vcPerforceServer
を使用して、Perforce のユーザ名、ワークスペース、およびサーバーフィールドを設定できます。

注意: スペースを含む
<mode>
引数は、二重引用符 (") で囲む必要があります。
-version
エディターを起動せずに、コマンドラインで Unity エディターのバージョン番号を出力します。
-timestamps
すべての Editor.log メッセージの先頭に、現在のタイムスタンプとスレッド ID を付加します。

バッチモードの引数

以下の引数を使用して、Unity のバッチモードを設定します。バッチ モードでは、ユーザー入力なしでUnityが定義済みタスクを実行できるため、バッチ モードはテストなどの自動化されたタスクに役立ちます。
重要
Unity の個別の商用利用条件の対象でない限り、バッチモードで Unity を使用する場合は、該当する追加条件を含め、Unity のサービス条件が適用されます。詳細については、最新バージョンの Unity サービス規約 と Unity エディターソフトウェア規約を含むその他の規約 を参照してください。

** コマンド

説明

-accept-apiupdate
Unity がバッチ モードで起動されたときに API Updater を実行するには、このコマンドライン オプションを使用します。

例:
unity.exe -accept-apiupdate -batchmode [other params]


Unity をバッチ モードで起動するときにこのコマンドライン引数を省略すると、API アップデーターは実行されません。コンパイラーエラーが発生する可能性があります。
-batchmode
Unity を バッチモード で実行します。バッチモードでは、Unity は人間によるインタラクションの必要なしにコマンドライン引数を実行します。また、ヒューマンインタラクションを必要とするダイアログ Windows (Save Scene ウィンドウなど) も非表示にします。コマンドライン引数を使用する場合は、常にバッチ モードで Unity を実行してください。バッチモードでは、自動化を中断せずに実行できます。

スクリプト コードの実行中に例外が発生した場合、アセット サーバーの更新が失敗した場合、またはその他の操作が失敗した場合、Unity は戻りコード 1 で即座に終了します。

バッチ モードでは、Unity は最小限のログ出力をコンソールに送信します。ただし、ログファイルには完全なログ情報が含まれています。同じプロジェクトをエディタで開いている間は、プロジェクトをバッチモードで開くことはできません。一度に実行できる Unity のインスタンスは 1 つだけです。

エディタまたはスタンドアロンプレイヤーがバッチモードで実行されているかどうかを確認するには、 application.isBatchMode 演算子を使用します。

-batchmode
を使用するときにプロジェクトがまだインポートされていない場合は、ターゲットプラットフォームがデフォルトのプラットフォームになります。異なるプラットフォームを強制するには、
-buildTarget
オプションを使用します。
‑ignorecompilererrors
この引数を使用すると、コンパイルエラーが発生しても、Unity はアプリケーションの開始を継続します。
-nographics
これをバッチモードで実行すると、Unity はグラフィックスデバイスを初期化しません。その後、GPU のないマシンで自動化されたワークフローを実行できます。自動化されたワークフローは、ウィンドウにフォーカスがある場合にのみ機能します。フォーカスされていないと、シミュレートされた入力コマンドを送信できません。Enlighten リアルタイムグローバルイルミネーションではメタパスレンダリングに GPU が必要なため、
-nographics
では GI をベイクできません (詳細については、ライトマッピングとシェーダーのメタパスセクションを参照してください)。
ノート:出力ログはこのモードではオフになります。出力ログの作成をイネーブルにするには、コマンド
-logFile
を使用してファイルの場所を指定します。

ビルド引数

以下の引数を使用して、コマンドラインからさまざまなプラットフォーム用のプレイヤーをビルドします。コマンドラインからのプレイヤーのビルドの詳細については、コマンドラインからのビルド を参照してください。

** コマンド

説明

-activeBuildProfile <pathname>
指定したパスに保存したビルドプロファイルをアクティブなビルドプロファイル (例えば、
-activeBuildProfile "Assets/Settings/Build Profiles/WindowsDemo.asset"
) として設定します。

ノート:
  • -activeBuildProfile <pathname>
    は、コンパイル前にアクティブなビルドプロファイルのビルドデータセクションにあるカスタムスクリプト定義を適用します。これらのスクリプト定義は、現在の定義セットに追加され、プロジェクト内の既存のスクリプト定義をオーバーライドまたは削除しません。
  • ビルドプロファイルアセットへのパスは、プロジェクトのルートフォルダーからの相対パスである必要があります。
  • -executeMethod
    と一緒に指定すると、Unity はプロファイルのスクリプト定義を適用し、メソッドを呼び出す前にスクリプトコンパイルをトリガーします。プロファイルの定義は、現在のプロジェクト定義に追加され、後続の
    -executeMethod
    実行中に有効になります。これにより、1 つのバッチセッションでターゲットプラットフォームを切り替えるなどの CI/CD ワークフローが可能になります。
-build <pathName>
activeBuildProfile <pathname>
から指定されたターゲットパスにプレイヤーをビルドします。プラットフォームによっては、ターゲットプラットフォーム固有のファイル拡張子でパスを終了する必要があります。例えば
-build path/to/your/build.exe
などです。拡張が必要なプラットフォームについては、プラットフォームビルドパスリファレンス を参照してください。
-buildLinux64Player <pathname>
64 ビットのスタンドアロン Linux プレイヤー(例えば、
-buildLinux64Player path/to/your/build
)をビルドします。
-buildLinuxHeadlessSimulation <pathname>
64ビットLinuxヘッドレス シミュレーション プレイヤー(例えば、
-buildLinuxHeadlessSimulation path/to/your/build
)をビルドします。
-buildOSXUniversalPlayer <pathname>
64ビットのスタンドアロンmacOSプレイヤー(例えば
-buildOSXUniversalPlayer path/to/your/build.app
)をビルドする。
-buildTarget <name>
エディターを起動するアクティブなビルドターゲットを選択します。使用可能なオプションは、エディターで有効にしたビルドゲットによって異なります。これらのオプションは、API 列挙
BuildTarget
で使用可能なオプションに次のように対応しています。
  • android
  • cloudrendering
  • ios
  • linux64
  • osxuniversal
  • tvos
  • visionos
  • windowsstoreapps
  • webgl
  • win
  • win64
クローズドプラットフォームにアクセスできる開発者は、他の
-buildTarget
オプションを使用できる場合があります。詳細については、ターゲットプラットフォームのドキュメントを参照してください。
-buildWindowsPlayer <pathname>
32 ビットのスタンドアロン Windows プレイヤー (例えば、
-buildWindowsPlayer path/to/your/build.exe
) をビルドします。
-buildWindows64Player <pathname>
64ビットのスタンドアロンWindowsプレイヤー(例えば
-buildWindows64Player path/to/your/build.exe
)をビルドします。
-standaloneBuildSubtarget <name>
プロジェクトをロードする前に、スタンドアロンアロンプラットフォームのアクティブなビルドサブターゲットを選択します。
  • プレイヤー /Player
  • サーバー

Unity Accelerator キャッシュ サーバーの引数

以下の引数を使用して、Unity Accelerator キャッシュ サーバーを Unity で使用するように設定します。これらの引数は、Editor Preferences に保存されている対応する設定をオーバーライドします。

** コマンド

説明

-EnableCacheServer
Unity Accelerator を有効にします。また、
-cacheServerEndpoint <host:port>
を使用して Unity Accelerator インスタンスのアドレスを指定する必要があります。
-cacheServerEndpoint <host:port>
Unity Accelerator インスタンスのエンドポイント アドレスを指定します。

例:
-cacheServerEndpoint 127.0.0.1:10080

デフォルト ポートは
10080
ですが、インストール中に変更できます。
-cacheServerNamespacePrefix <prefix>
Unity Accelerator インスタンスの名前空間プレフィックスを設定します。この引数を名前空間名とともに使用して、キャッシュ サーバー上のデータを分割します。例えば、異なるプロジェクトや Unity バージョンのキャッシュ データを分離します。

例:
-cacheServerNamespacePrefix MyProject_Unity23LTS

スペースを含むプレフィックスは、二重引用符(
"
)で囲む必要があります。
指定された名前は、メタデータ、アーティファクトファクトデータ、シェーダーキャッシュデータのタイプごとにデータを分ける、キャッシュ内の最大 3 つの名前空間のプレフィックスとして使用されます。
-cacheServerEnableDownload true

-cacheServerEnableDownload false
Unity Accelerator インスタンスからのダウンロードを有効または使用不可にします。
-cacheServerEnableUpload true

-cacheServerEnableUpload false
Unity Accelerator インスタンスへのアップロードを有効または使用不可にします。

例:
-cacheServerEnableUpload true
-cacheServerWaitForConnection <ms>
プロジェクトのロード中に Unity Accelerator インスタンスへの接続を待機する時間をミリ秒単位で指定します。この時間が経過すると、プロジェクトの初期更新が開始されます。

例:
-cacheServerWaitForConnection 5000
-cacheServerWaitForUploadCompletion
Unity Accelerator の保留中のアップロードが完了するまで Unity を閉じないようにします。これは、Unity Accelerator をコマンドライン引数
-quit
と組み合わせて使用する場合に推奨されます。コマンドライン引数は、他のスクリプト コマンドの実行が完了した後に Unity エディターを閉じます。
-cacheServerDownloadBatchSize <batchSize>
個々のキャッシュサーバーのダウンロードバッチでアーティファクトの数を設定します。ダウンロードバッチは、個々のダウンロードを大きなバッチにグループ化してダウンロード操作の数を減らすために使用される最適化です。

例:
-cacheServerDownloadBatchSize 256

デフォルト値は
128
です。
-cacheServerUploadExistingImports
Unity が Unity Accelerator インスタンスに新しいインポートのアップロードを開始したときに、以前にアップロードされていない既存のインポートをアップロードします。以前にアップロードされたインポートは再アップロードされません。
-cacheServerUploadAllRevisions
Unity が Unity Accelerator インスタンスに新しいインポートのアップロードを開始したときに、アセットデータベースに既知の以前のすべてのリビジョンを含め、まだアップロードされていない既存のインポートをアップロードします。以前にアップロードされたインポートリビジョンは再アップロードされません。
-cacheServerUploadExistingShaderCache
Unity がキャッシュサーバーへの新しいインポートのアップロードを開始したときに、以前にアップロードされていない既存のシェーダーキャッシュインポートをアップロードします。以前にアップロードされたシェーダーインポートは再アップロードされません。

デバッグ引数

** コマンド

説明

-disableManagedDebugger
デバッガーリッスンソケットを無効にします。
-diag-debug-shader-compiler
Unity は 1 つのシェーダーコンパイラーインスタンスのみを起動し、そのタイムアウトを 1 時間に強制します。シェーダーコンパイラーの問題のデバッグに役立ちます。
-debugCodeOptimization
デバッグ コード最適化モードをイネーブルにし、セッションの現在のデフォルト コード最適化モードをオーバーライドします。
-enableCodeCoverage
Code Coverage を有効にし、Coverage API へのアクセスを許可します。
-force-d3d12-debug
DX12検証レイヤーを有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。
-force-d3d12-debug-gbv
DX12 GPU ベースの検証を有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。
-force-vulkan-layers
Vulkan 検証レイヤーを有効にします。これは、XR プラグインやネイティブ プラグインでの作業に役立ちます。
-stackTraceLogType
詳細なデバッグを可能にします。すべての設定で、None (なし)、Script Only (スクリプトのみ)、Full (完全) を選択できます (例えば、
-stackTraceLogType Full
)。
-log-memory-performance-stats
エディターを閉じるときに、Unity エディターのメインログファイルに詳細なメモリとパフォーマンスのレポートを追加します。
-wait-for-managed-debugger
起動前にマネージデバッガのアタッチ、設定、添付を待機させます。エディターのプロセス ID を表示するダイアログを生成します。マネージ デバッグの詳細は、『 Unity のデバッグ C# コード 』を参照してください。
-wait-for-native-debugger
エディターを起動する前にネイティブがアタッチ、設定、添付するのを待機させます。エディターのプロセス ID を表示するダイアログを生成します。

グラフィックス API 引数

以下の引数を使用して、Unity エディターに特定のグラフィックス API の使用を強制します。

** コマンド

説明

-force-clamped
-force-glcoreXY
でこれを使用して、Unity が追加の OpenGL 拡張をチェックしないようにし、同じコードパスを持つプラットフォーム間で実行できるようにします。このアプローチは、問題がプラットフォーム固有かどうかを判断するのに役立ちます。例えば、ドライバーのバグなどです。
-force-d3d11
(Windows のみ)
エディターにレンダリングに Direct3D 11 を使用させます。通常、グラフィックス API はプレイヤー設定に依存します (通常、デフォルトは D3D11)。
-force-d3d12
(Windows のみ)
エディターにレンダリングに Direct3D 12 を使用させます。通常、グラフィックス API はプレイヤー設定に依存します。
-force-device-index
GPU のインデックスを渡すことで、エディターに特定の GPU デバイスを使用させます。例えば、これを使用して、エディターに専用の GPU ではなく内蔵 GPU の使用を強制します。GPUインデックスと物理GPUのマッピングは、システムによってGPUが列挙される順序によって決まります。この列挙型は通常、GPU ドライバーまたは使用され例えば、Metal、Direct3D、Vulkan) によって行われます。通常、インデックス
0
はプライマリモニタに接続された GPU になります。デスクトップコンピューターでは通常、これが専用 GPU ですが、ノートパソコンでは通常、内蔵 GPU です。したがって、デスクトップコンピュータでは通常、
-force-device-index=0
が専用グラフィックスカードです。
-force-glcore
エディターにレンダリングに OpenGL 3/4 コアプロファイルを使用させます。エディタは、使用可能な最良のバージョンの OpenGL と、OpenGL ドライバによって公開されたすべての OpenGL 拡張を使用しようとします。プラットフォームがサポートされていない場合は、Direct3D が使用されます。
-force-glcoreXY
に
-force-glcore
似ていますが、特定の OpenGL コンテキストバージョンを要求します。XY に受け入れられる値:32、33、40、41、42、43、44、または 45。プラットフォームが特定のバージョンのOpenGLをサポートしない場合、Unityはサポートされているバージョンにフォールバックします。
-force-gles
(Windows のみ)
エディタでレンダリングに OpenGL for 埋め込まれたシステムを使用するようにします。エディタは、使用可能な最良の OpenGL ES バージョンと、OpenGL ドライバによって公開されたすべての OpenGL ES 拡張の使用を試みます。
-force-glesXY
(Windows のみ)
-force-gles
に似ていますが、特定の OpenGL ES コンテキストバージョンを要求します。XY に受け入れられる値:30, 31, 31aep, 32.プラットフォームが特定のバージョンのOpenGL ESをサポートしない場合、Unityはサポートされているバージョンにフォールバックします。プラットフォームが OpenGL ES をサポートしない場合、Unity は別のグラフィックス API にフォールバックします。
-force-opengl
エディターに古い機能 OpenGL バック終了を使用させます。
-force-vulkan
エディターにレンダリングに Vulkan を使用させます。通常、グラフィックス API はプレイヤー設定に依存します。

ライセンス引数

以下の引数を使用して、Unity ライセンスを処理したり、異なるライセンスオプションで Unity エディターを実行したりできます。

** コマンド

説明

-createManualActivationFile
Unity ライセンスを手動でアクティブ化する 3 ステップ プロセスのステップ 1。詳細については、手動ライセンス アクティベーションを参照してください。
-manualLicenseFile <yourulffile>
Unity ライセンスを手動でアクティブ化する 3 ステップ プロセスのステップ 3。詳細については、手動ライセンス アクティベーションを参照してください。
-returnlicense
現在アクティブなシリアルベースまたは名前付きユーザーライセンスを返却します。フローティング ライセンスの返却に
-returnlicense
を使用しないでください。詳細については、ライセンスの返却 を参照してください。ライセンスモデルの詳細については、ライセンスの概要 を参照してください。
-serial <serial-key>
有料の Unity ライセンスをアクティブ化する。シリアルベース ライセンスをアクティブ化する、または指定ユーザー ライセンスとそのシリアル キーを同時にアクティブ化するには、
<serial-key>
値を指定します。シリアル キーをアクティブ化せずに名前付きユーザー ライセンスをアクティブ化するには、
<serial-key>
値を除外します。詳細については、コマンドラインからライセンスをアクティブ化する を参照してください。ライセンスモデルの詳細については、ライセンスの概要 を参照してください。

ノート:
-serial
引数を使用する場合は、
-batchmode
引数も使用する必要があります。
-quit
引数を指定することも推奨されます。

Metal 引数(macOS のみ)

以下の引数を使用して、Apple デバイスでの Metal グラフィックス API の使用を設定します。

** コマンド

Details:

-force-low-power-device
(macOS のみ)
Metal を使用する場合は、エディタに低消費電力デバイスを使用します。
-force-metal
デフォルトのグラフィックス API として Metal をエディタで使用する (macOS のみ)。
-enable-metal-capture
Metal キャプチャをエディター内から取得できるようにします。

プロファイラー引数

以下の引数を使用して、Unity のプロファイラーの使用を設定します。

** コマンド

説明

-deepprofiling
CPU プロファイラーのディーププロファイリングオプションを有効にします。
-profiler-enable
プレイヤーまたはエディタの開始をプロファイルする。プレイヤーでこの引数を使用すると、ビルドプロファイルで自動接続プロファイラーオプションを有効にしてプレイヤーをビルドするのと同じエフェクトが得られます。

この引数をエディターで使用すると、エディターの開始時に プロファイラー ウィンドウのプロファイラー情報の収集と表示が開始されます。
-profiler-log-file <Path/To/Log/File.raw>
この引数は、起動時にプロファイル データを .Raw ファイルにストリームするように Unity プロファイラーを設定します。プレイヤーとエディターの両方で動作します。
-profiler-capture-frame-count <NumberOfFrames>
この引数は、起動時に .Raw ファイルにストリーミングするときにプロファイラーがプロファイルでキャプチャするフレーム数を設定します。プレイヤーでのみ動作します。
-profiler-maxusedmemory
デフォルトでは、Unity プロファイラーの
maxUsedMemory
はプレイヤーで 16 MB、エディターで 256 MB です。この引数を使用して、起動時に
maxUsedMemory
パラメーターをカスタムサイズ (例えば、
-profiler-maxusedmemory 16777216
) に設定できます。サイズはバイト単位で設定されます。

Unity エディターの特別なコマンドライン引数

これらは、特殊な状況で、または Unity サポートから指示されたときにのみ使用してください。

** コマンド

説明

-enableIncompatibleAssetDowngrade
より新しいバージョンの Unity で作成した互換性のないアセットを、ダウングレードして現在のバージョンの Unity で使用する場合に使用します。
これを有効にすると、ダウングレードを必要とするプロジェクトを開こうとすると、Unity はこのダウングレードの確認を求めるダイアログを表示します。

ノート:この手順はサポートされていないためリスクが高く、最後の手段としてのみ使用してください。
-giCustomCacheLocation
グローバルイルミネーション (GI) キャッシュフォルダーのカスタムの場所を設定します。値は絶対パスでなければならず、スペースが含まれている場合は引用符で囲む必要があります。
-giCustomCacheLocation
が設定されている場合、現在のエディターセッションでは、その値は、GI キャッシュ設定で以前に定義されたカスタムキャッシュフォルダーの場所よりも優先されます。この値は、エディターの終了後には維持されません。
-rebuildLibrary
この手順では、
Library
プロジェクトのサブディレクトリを削除し、すべてのアセットの完全な再インポートをトリガーします。プロジェクトの初期化中に Unity がデータベース破損エラーを報告する場合に使用します。

Unity Hub の特別なコマンドライン引数

これらは、特殊な状況で、または Unity サポートから指示されたときにのみ使用してください。これらの引数は、デフォルトで Unity Hub を使用しないバージョンの Unity エディターで使用されます。

** コマンド

説明

-useHub
HubインテグレーションでUnityエディターを起動します。
-hubIPC
UnityエディターとUnity Hub間の通信とインタラクションを可能にします。
-hubSessionId
Unity Hubセッションの一意の識別子を指定します。
サポートされているすべてのバージョンの Unity エディターでは、これらの引数はすでにデフォルトで設定されています。

追加リソース