ドキュメント

Unity Engine

Unity Engine

Unity Player コマンドライン引数リファレンス

コマンドラインからビルドされたプレイヤーを起動するときに使用できる引数のリスト。
読み終わるまでの所要時間 16 分最終更新 6日前

コマンドラインから Unity Player を起動し、引数を渡してプレイヤーの実行方法を変更できます。
これらの引数は、ウェブプラットフォームを除くすべてのスタンドアロンプラットフォームで使用できます。以下の表は、その他のプラットフォーム要件を示しています。
コマンドラインから Unity を起動する方法の詳細については、「コマンドライン インターフェースからの Unity の実行」を参照してください。

** コマンド

説明

-batchmode
アプリケーションをヘッドレスモードで実行します。このモードでは、アプリケーションは何もディスプレイせず、ユーザー入力も受け付けません。
-disable-gpu-skinning
起動時のグラフィックス処理単位(GPU)スキニングを無効にします。
-dontConnectAcceleratorEvent
(UWP のみ)
AcceleratorKeyEvent への接続を使用不可にします。これは、XAML 要素の入力に問題がある場合にヘルプになります。
**ノート:**Unity は F10、Ctrl、Alt、Tab などの一部のキーボード キーを処理できません。
-force-clamped
これと
-force-glcoreXY
を併用して、追加の OpenGL 拡張の確認を回避し、同じコードパスを持つプラットフォーム間でアプリケーションを実行できるようにします。
-force-d3d11
(Windows のみ)
レンダリングに Direct3D 11 を使用するようアプリケーションに強制します。
-force-d3d11-bitblt-model
(Windows のみ)
Direct3D 11 を使用する場合、アプリケーションに DXGI BitBlt モデルスワップチェーンを強制的に使用します。詳細については、「
PlayerSettings.useFlipModelSwapchain
」を参照してください。
-force-d3d11-flip-model
(Windows のみ)
Direct3D 11 を使用するときに、アプリケーションに DXGI 反転モデルスワップチェーンを強制的に使用させます。詳細については、「
PlayerSettings.useFlipModelSwapchain
」を参照してください。
-force-d3d11-no-singlethreaded
(Windows および UWP のみ)
D3D11_CREATE_DEVICE_SINGLETHREADED
フラグなしで DirectX 11.0 を強制的に作成します。
-force-d3d11-singlethreaded
(Windows および UWP のみ)
DirectX 11.0 を
D3D11_CREATE_DEVICE_SINGLETHREADED
フラグ付きで強制的に作成します。
-force-d3d12
(Windows のみ)
レンダリングに Direct3D 12 を使用するようアプリケーションに強制します。
-force-device-index
GPU のインデックスを渡すことで、スタンドアロンプレイヤーに特定の GPU デバイスを使用させます。このオプションは、D3D11、D3D12、Metal、および Vulkan グラフィックス API ではサポートされていますが、OpenGL ではサポートされていません。
-force-driver-type-warp
(Windows および UWP のみ)
DirectX 11.0 ドライバータイプの WARP デバイスを強制します。詳細については、Windows 上級者向けのラスタライゼーションプラットフォームに関する Microsoft のドキュメントを参照してください。
-force-feature-level-10-0
(Windows および UWP のみ)
DirectX 11.0 特徴レベル 10.0 を強制します。
-force-feature-level-10-1
(Windows および UWP のみ)
DirectX 11.0 特徴レベル 10.1 を強制します。
-force-feature-level-11-0
(Windows および UWP のみ)
DirectX 11.0 特徴レベル 11.0 を強制します。
-force-gfx-direct
シングルスレッドレンダリングを強制します。
-force-glcore
アプリケーションにレンダリングに OpenGL コアプロファイルを強制的に使用します。エディタは、使用可能な最新の OpenGL バージョンと、OpenGL ドライバによって公開されたすべての OpenGL 拡張を使用しようとします。プラットフォームが OpenGL をサポートしない場合、Unity は Direct3D を使用します。
-force-glcoreXY
-force-glcore
に似ていますが、特定の OpenGL コンテキストバージョンを要求します。XY に受け入れられる値:32、33、40、41、42、43、44、または 45。
-force-low-power-device
(macOS のみ)
スタンドアロンプレイヤーに低電力デバイスを使用させます。
-force-metal
(macOS のみ)
スタンドアロンプレイヤーにデフォルトのグラフィックス API として Metal を使用させます。
-forceTextBoxBasedKeyboard
(UWP のみ)
TouchScreenKeyboard に TextBox ベースの実装を使用します。この実装では、デフォルトに問題がある場合に、異なる実装に切り替えることができます。

**ノート:**この実装は、UWP XAML アプリケーションにのみエフェクトがあります。
-force-vulkan
アプリケーションにレンダリングに Vulkan の使用を強制します。
-force-wayland
(Linuxのみ)
Linux プレイヤー実行時に実験的 Wayland サポートをアクティブ化する。
-logFile <pathname>
Unity がスタンドアロン プレイヤーのログ ファイルを書き込むファイル パスの場所を指定します。この引数を指定しない場合のログ ファイルのデフォルトの場所の詳細については、ログ ファイル リファレンスを参照してください。コンソールに出力するには、パス名に
-
を指定します。Windows では、
-logFile
を使用して出力を
stdout
に送信できます。デフォルトではコンソールではありません。パスにスペースが含まれている場合は、二重引用符で囲みます。コマンドインターフェースによっては、パスにスペースが含まれていない場合でも、パスを引用符で囲む必要がある場合があります。

例 (Windows):
"C:\Users\me\Builds\MyGame\MyGame.exe" -logFile "C:\Logs\Player.log"

例 (macOS):
"/Users/me/Builds/MyGame.app/Contents/MacOS/MyGame" -logFile "/Users/me/Logs/Player.log"

例 (Linux):
"/home/me/Builds/MyGame/MyGame" -logFile "/home/me/logs/Player.log"
-log-memory-performance-stats
プレイヤーを閉じるときに、プレイヤーファイルに詳細なメモリレポートを追加します。
-max-async-pso-job-count
シェーダーバリアントの事前準備に
Experimental.Rendering.ShaderWarmup
を使用する場合に、Unity がパイプラインステートオブジェクト (PSO) を作成するために使う並列スレッド数を設定します。これは、DirectX 12、Metal、または Vulkan グラフィックス API を使用するプラットフォームでアプリケーションを実行する場合にのみエフェクトがあります。
-monitor N
1 ベースのインデックス番号で示される指定されたモニタでスタンドアロンプレイヤーを実行します。
-nographics
この引数をバッチモードで使用する場合、Unity はグラフィックスデバイスを初期化しません。これにより、GPU のないマシンで自動化されたワークフローを実行できます。
ノート:出力ログはこのモードではオフになります。
-nolog
プレイヤー ロギングを無効にします。プレイヤー ログのコンテンツと場所の詳細については、ログファイル リファレンス フォルダーを参照してください。
-no-stereo-rendering
ステレオレンダリングをオフにします。
-parentHWND <HWND> delayed
(Windows のみ)
Windows スタンドアロンアプリケーションを別のアプリケーションに埋め込みます。この引数を使用する場合は、親アプリケーションのウィンドウウハンドル (HWND) を Windows スタンドアロンアプリケーションに渡す必要があります。

-parentHWND 'HWND' delayed
を渡すと、Unity アプリケーションは実行中非表示になります。アプリケーションで Unity の Microsoft 開発者ライブラリから SetParent を呼び出す必要もあります。Microsoft の
SetParent
は Unity ウィンドウを埋め込みます。Unity プロセスを作成するとき、Unity ウィンドウは Microsoft の STARTUPINFO 構造体の一部として提供された位置とサイズに従います。

Unity ウィンドウのサイズ変更は、Microsoft の
GetWindowLongPtr
機能の GWLP_USERDATA で確認してください。グラフィックスの初期化時に、その最下位ビットが 1 に設定され、サイズ変更しても安全です。Unity スプラッシュスクリーンの表示が終了した後、2 番目に低いビットが 1 に設定されます。

詳細については、次のダウンロード可能な例を参照してください。EmbeddedWindow.zip
-popupwindow
ウィンドウをフレームなしのウィンドウとして作成します。このコマンドは macOS ではサポートされていません。
-screen-fullscreen
デフォルトの全画面ステートをオーバーライドします。0 または 1 である必要があります。
-screen-height
デフォルトの画面の高ささをオーバーライドライドします。サポートされている解像度の整数である必要があります。
-screen-quality
デフォルトの画面品質をオーバーライドします。使用例は、
/path/to/myGame -screen-quality Beautiful
です。サポートされているオプションは品質設定名と一致します。
-screen-width
デフォルトの画面幅をオーバーライドします。この幅の値は、サポートされている解像度度の整数である必要があります。
-single-instance
(LinuxおよびWindowsのみ)
アプリケーションのインスタンスは一度に 1 つだけ実行します。別のインスタンスがすでに実行中の場合は、
-single-instance
でアプリケーションを再度起動すると、既存のインスタンスにフォーカスが移動します。
-systemallocator
プラットフォームでシステムアロケーターを強制的に使用します。これは、アドレスサニタイザなどのツールを使用してメモリの問題をデバッグする場合に役立ちます。このオプションは、デバッグの目的にのみ使用してください。
-timestamps
すべてのプレイヤーログメッセージの先頭に、現在のタイムスタンプとスレッド ID を付けます。
-wait-for-managed-debugger
プレイヤーは起動前にマネージデバッガのアタッチ、設定、添付を待機します。プレイヤーのプロセス ID を表示するダイアログを生成します。マネージ デバッグの詳細は、『 Unity のデバッグ C# コード 』を参照してください。
-wait-for-native-debugger
プレイヤーは起動する前にネイティブがアタッチ、設定、添付するのを待機します。プレイヤーのプロセス ID を表示するダイアログを生成します。
-window-mode
(Windows のみ)
全画面ウィンドウモードをオーバーライド。受け入れられる値は
exclusive
または
borderless
です。詳細については、プレイヤー設定 を参照してください。

追加リソース