ドキュメント

Unity Engine

Unity Engine

コマンドインターフェースから Unity を実行する

コマンドラインからUnityを起動し、スクリプトを実行する方法を理解します。
読み終わるまでの所要時間 7 分最終更新 6日前

オペレーティングシステムのコマンドラインインターフェースフェースから Unity エディターを起動し、引数を渡すことでエディターの起動方法を変更できます。起動時に、コマンドラインを使用してプロジェクトの C# スクリプトから特定のメソッドを実行することもできます。
Unity エディターを起動するとき、コマンド引数値のデリミタは 1 つのスペースです。例えば、ウィンドウモードを borderless に設定するには、
-window-mode borderless
を使用します。
コマンドライン引数の完全なリストについては、Unity エディター コマンドライン引数リファレンスおよび Unity Player コマンドライン引数リファレンスを参照してください。

コマンドインターフェースフェースからの Unity の起動

コマンドラインインターフェースから Unity プロジェクトを起動するには、Unity アプリケーションのディレクトリパスを入力し、その後に
-projectPath
とターゲットプロジェクトのディレクトリパスを入力します。
重要
プロジェクトのパス名にスペースが含まれている場合は、引用符で囲みます。例えば
"Unity Projects/My Game"
などです。
このように起動すると、エディターは起動時にコマンドと情報を受け取ります。これは、テストスイート、自動ビルド、その他の本番タスクに役立ちます。
エラーが発生した場合は、Unity ログ ファイルを参照して問題の診断に役立つ追加情報を確認してください。

前提条件

Unity Hubを使用して、デフォルトの場所にUnityエディターをインストールします。エディターが別の場所にインストールされている場合は、パスを調整してこれを反映します。エディタの場所のパスを見つける方法の詳細については、エディタバージョンのインストールとアンインストール を参照してください。

Linux での Unity の起動

Unity を起動するには、端末に以下の入力します。
/home/<user>/Unity/Hub/Editor/<version>/Editor/Unity -projectPath <project path>

macOSでUnityを起動

Unity を起動するには、端末に以下の入力します。
/Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity -projectPath <project path>

Windows での Unity の起動

Unity を起動するには、コマンドプロンプトに以下の入力します。
"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "<project path>"
Windows での構文エラーを防ぐために、ディレクトリリパスが 1 つのバックスラッシュで終了ないようにしてください。次のように、ダブルバックスラッシュ(
\\
)またはバックスラッシュなしのいずれかを使用します。
  • "C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "C:\MyUnityProjects\MyProject"
  • "C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -createProject "C:\MyUnityProjects\MyProject\\"

起動時にメソッドを実行するスクリプトの例

コマンドラインを使用して、エディター起動時にプロジェクトの C# スクリプトから特定のメソッドを実行できます。以下の例は、Cスクリプトと、起動時にそのスクリプトからメソッドを実行するために使用されるコマンド引数を示しています。
プロジェクトの Cスクリプトの例:
using UnityEditor;class MyEditorScript{ 静的 void PerformBuild () { BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions(); buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity", "Assets/Scene2.unity" }; BuildPipeline.BuildPlayer(buildPlayerOptions); }}
以下のコマンドは、バッチモードでエディターを実行し、前のスクリプトから
MyEditorScript.PerformBuild
メソッドを呼び出し、完了時に終了します。エディターパスで、
<version>
を起動する Unity のバージョンに置き換えます。Unity エディターパスがデフォルトでない場合、パスを完全に置き換えます。
  • Windows:
    "C:\Program Files\Unity\Hub\Editor\<version>Editor\Unity.exe" -終了 -batchmode -projectPath "C:\Users\UserName\Documents\MyProject" -executeMethod"MyEditorScript.PerformBuild
  • macOS:
    /Applications/Unity/Hub/Editor/<version>/Unity.アプリ/Contents/MacOS/Unity -終了 -batchmode -projectPath ~/UnityProjects/MyProject -executeMethodMyEditorScript.PerformBuild

追加リソース