ドキュメント

Unity Engine

Unity Engine

Unity スタンドアロンプレイヤーのコマンドライン引数

A list of arguments you can use when you launch a built Player from the command line.
読み終わるまでの所要時間 15 分最終更新 1ヶ月前

コマンドラインから Unity Player を起動し、引数を渡すことで、プレイヤーの実行方法を変更することができます。
これらの引数は、ウェブプラットフォームを除くすべてのスタンドアロンプラットフォームで使用できます。以下の表は、その他のプラットフォーム要件を示しています。
ノート: このページの情報を使用するには、オペレーティングシステムのコマンドラインインターフェースフェースを使用してアプリケーションを起動し、コマンド引数を実行する方法を把握しておく必要があります。
Unity Player アプリケーションを起動する場合、コマンドライン引数値の区切り文字は 1 つのスペースです。例えば、ウィンドウモードを borderless に設定するには、
-window-mode borderless
を使用します。

コマンド

詳細

-batchmode
アプリケーションを "ヘッドレス" モードで実行します。このモードでは、アプリケーションは何も表示しない、またはユーザー入力を受け入れません。これはネットワークアプリケーションのサーバーを実行するのに役立ちます。
-disable-gpu-skinning
起動時の GPU (Graphics Processing Unit) スキニングを無効にします。
-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 のみ)
D3D11_CREATE_DEVICE_SINGLETHREADED
フラグを指定して DirectX 11.0 を強制的に作成します。
-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 Advanced Rasterization Platform に関する 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
に転送します。デフォルトではコンソールではありません。
-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
出力ログを生成しません。この引数を使用しない場合、Unity は Log Files フォルダーに
output_log.txt
を書き込み、このフォルダーに Debug.Log 出力が出力されます。
-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 を配置します。
-window-mode
(Windows のみ)
全画面ウィンドウモードをオーバーライドします。受け入れられる値は
exclusive
または
borderless
です。詳細については、プレイヤー設定を参照してください。