【Unity】アプリケーションを終了させる方法|終了ボタンとEscapeキーに対応

2026年11月13日

広告

ゲーム画面に「終了」ボタンを置き、クリックしたらゲームを終了させてみましょう。

Unityでは、Editor内の再生を止める処理と、ビルドしたPCアプリを閉じる処理が異なります。そこで、終了処理をQuitGame()というメソッドにまとめ、そのメソッドをボタンから呼び出します。

この記事では、Canvasを使うUnity UI(uGUI)で、次の2通りの接続方法を紹介します。

  • 方法A:InspectorのButton > On Click()に登録する
  • 方法B:C#のonClick.AddListener()で登録する

初めて作る場合は方法Aから試してください。同じボタンの終了処理には、AかBのどちらか一方を使います。

対象はUnity 6のWindows・macOS・Linux向けアプリです。説明はUnity 6.0の公式資料とuGUI 2.0の資料を基準にしています。小バージョンやパッケージによってメニュー表示が異なる場合があります。UI ToolkitのButtonは別の仕組みなので、この記事では扱いません。

1. Editorとビルドしたアプリで、何が違う?

実行する場所今回行う処理結果
Unity EditorのPlayモードUnityEditor.EditorApplication.isPlaying = false;再生が止まる。Unity Editor自体は閉じない
Windows・macOS・LinuxのビルドApplication.Quit();実行中のアプリが終了する
Web・Android・iOSのビルド今回のコードでは終了しないPC以外の終了方法は後述

Application.Quit()だけではEditorの再生は止まりません。Editorではこの呼び出しが無視されるためです。Unity公式:Application.Quit

EditorApplication.isPlayingをfalseにするとPlayモードを終了できます。変更の反映は、そのフレームのスクリプト処理が終わった後になります。Unity公式:EditorApplication.isPlaying

2. Canvasに「終了」ボタンを作る

ボタンを配置する

  1. Playモードを停止しておきます。設定は再生していない状態で行います。
  2. Hierarchyの空いている場所を右クリックし、UI > Button - TextMeshProを選びます。上部メニューのGameObject > UIから選んでも構いません。
  3. TMPの初期設定画面が出た場合は、Import TMP Essentialsを実行します。
  4. 作成したButtonの名前をQuitButtonに変更します。
  5. 子オブジェクトのText (TMP)を選び、文字を「終了」に変更します。
  6. Gameビューを見ながら、QuitButtonのRect Transformで位置と大きさを調整します。例えば中央に、幅200・高さ60程度で配置します。

日本語が四角く表示される場合は、日本語の文字を含むTMP Font Assetを設定してください。動作確認だけなら、いったん表示をQuitにして進めても構いません。

既存のCanvasがない場合、UIの作成時にCanvasが自動で作られます。CanvasはUIを表示するための土台です。Unity公式:Canvas

最初はCanvasのRender ModeをScreen Space - Overlayにすると、カメラの設定に左右されず配置を確認しやすくなります。

EventSystemも確認する

通常はUI作成時にEventSystemも追加されます。今回のシンプルなシーンでは、有効なEventSystemを1つ用意してください。ない場合はGameObject > UI > Event Systemから追加します。

Input Systemを使うプロジェクトでは、EventSystemにInput System UI Input Moduleが必要です。古いStandalone Input Moduleが付いていて置き換え用ボタンが表示される場合は、それを使って置き換えます。UIアクションが空なら、Assign Default Actionsが表示されていれば既定のアクションを設定します。

旧Input Managerを使うプロジェクトではStandalone Input Moduleを使います。入力方式はEdit > Project Settings > Player > Other Settings > Active Input Handlingで確認できます。この終了ボタンのためだけにBothへ変更する必要はありません。Unity公式:Input SystemのUI対応

3. 共通の終了処理を作る

ProjectウィンドウでC#スクリプトを作成し、ファイル名をGameQuitter.csにします。内容をすべて次のコードに置き換えて保存してください。

using UnityEngine;

public class GameQuitter : MonoBehaviour
{
    // ボタンから呼び出す、引数なしの終了処理
    public void QuitGame()
    {
#if UNITY_EDITOR
        UnityEditor.EditorApplication.isPlaying = false;
#elif UNITY_STANDALONE
        Application.Quit();
#else
        Debug.Log("このサンプルの終了ボタンはPC向けです。");
#endif
    }
}

HierarchyでCreate Emptyを選び、空のGameObjectを作ってGameManagerと名付けます。そこへGameQuitter.csをドラッグして、コンポーネントとして追加します。

Hierarchyの構成は、例えば次のようになります。Main Cameraなど、ほかのオブジェクトがあっても構いません。

Canvas
└─ QuitButton
   └─ Text (TMP)
EventSystem
GameManager
└─ GameQuitter(コンポーネント)

コードの読み方

public void QuitGame()は、外から呼び出せる、引数も戻り値もないメソッドです。今回はこの形にすることで、Buttonのイベントに登録しやすくしています。

#ifは、条件に合う部分だけをコンパイルするための指定です。今回の分岐は次の意味になります。

  • UNITY_EDITOR:Editor用の処理を使う
  • UNITY_STANDALONE:Windows・macOS・Linux向けビルドの処理を使う
  • それ以外:終了せず、確認用ログを出す

EditorでPC向けの設定を選んでいても、最初のUNITY_EDITOR側が使われます。#elif以降は同時に実行されません。Unity公式:条件付きコンパイル

UnityEditorはEditor専用です。今回のように参照を#if UNITY_EDITORの中に入れることで、PCビルドにEditor専用コードを含めずに済みます。このスクリプトはビルドでも使うので、Editorという名前のフォルダーには入れないでください。

4. 方法A:InspectorのOn Click()に登録する

ここでは、クリックしたときにGameManagerに付けたGameQuitter.QuitGame()を呼ぶようにします。

  1. HierarchyでQuitButton本体を選択します。子のText (TMP)ではありません。
  2. InspectorでButtonコンポーネントを探します。
  3. On Click()欄の+を押して、登録欄を1行追加します。
  4. その行のオブジェクト欄(None (Object))へ、HierarchyのGameManagerをドラッグします。Project内の.csファイルではありません。
  5. No Functionを開き、GameQuitter > QuitGame()を選びます。
  6. 呼び出しの設定はRuntime Onlyにします。これはビルドだけでなく、EditorのPlayモードでも呼び出される設定です。
  7. シーンを保存します。

設定後は、対象オブジェクトがGameManager、呼び出すメソッドがGameQuitter.QuitGameになっていることを確認してください。画面上では括弧などの表示が異なる場合があります。

このように、Inspectorから呼び出し先を設定できる仕組みがUnityEventです。Unity公式:UnityEventの設定

Editorで確認する

Playボタンを押して再生し、Gameビューの「終了」をクリックします。Playモードが解除され、Unity Editorが開いたままなら成功です。

ButtonのOn Click()は、マウス操作では基本的にボタン上で押して離したときに発生します。押したままボタン外へ移動して離した場合は、クリックとして扱われません。Unity公式:Button

方法Aだけを使う場合、次の方法Bのスクリプトは追加しなくて構いません。

5. 方法B:コードからonClick.AddListenerで登録する

次は、Inspectorのイベント欄へ手作業で登録する代わりに、コードから接続する方法です。UIをコードで組み立てるときなどにも使えます。

方法Aを試したシーンを使う場合は、先にOn Click()のGameQuitter.QuitGameの行を−で削除してください。 ほかの目的のイベントまで削除する必要はありません。

共通のGameQuitter.csとGameManagerはそのまま使います。新しくQuitButtonBinder.csを作り、次の内容にします。

using UnityEngine;
using UnityEngine.UI;

public class QuitButtonBinder : MonoBehaviour
{
    [SerializeField] private Button quitButton;
    [SerializeField] private GameQuitter gameQuitter;

    private void OnEnable()
    {
        if (quitButton == null || gameQuitter == null)
        {
            Debug.LogError("Quit ButtonとGame Quitterを設定してください。", this);
            return;
        }

        quitButton.onClick.AddListener(gameQuitter.QuitGame);
    }

    private void OnDisable()
    {
        if (quitButton != null && gameQuitter != null)
        {
            quitButton.onClick.RemoveListener(gameQuitter.QuitGame);
        }
    }
}

設定手順は次のとおりです。

  1. Playモードを停止します。
  2. QuitButtonBinder.csをGameManagerに追加します。
  3. BinderのQuit Button欄へ、HierarchyのQuitButtonをドラッグします。
  4. Game Quitter欄へ、GameQuitterが付いたGameManagerをドラッグします。
  5. QuitButtonのOn Click()に、方法Aの終了処理が残っていないことを確認します。
  6. シーンを保存し、再生して「終了」をクリックします。

AddListenerは「このイベントが起きたら、このメソッドを呼ぶ」と登録する処理です。ButtonはUnityEngine.UIの型を使います。Unity公式:Button.onClick

登録するときは、gameQuitter.QuitGameの後ろに()を付けません。 メソッドをその場で実行するのではなく、後で呼び出せる形で渡すためです。

この例では、有効になったときのOnEnableで登録し、無効になったときのOnDisableで同じメソッドを解除します。参照先は再生前に設定し、再生中は変更しない前提です。

RemoveListenerが解除するのはコードから追加した実行時リスナーです。Inspectorで登録したイベントは消えないため、方法Aの登録はInspectorで削除します。ほかの処理を巻き込まないよう、ここではRemoveAllListeners()も使いません。Unity公式:UnityEvent.RemoveListener

なお、コードで登録した呼び出し先は、通常のInspectorのOn Click()一覧に保存済みの行として追加されません。方法Bでは、欄が空でもコードによって接続されます。

Escapeキーで終了するサンプル

Escapeキーを押すとアプリを終了するスクリプトの例です。下の3つを開いて比較できます。

  • 簡易版(Input System):Unity 6の標準のInput Systemを使った最小の例です。キーボードが接続されていないと Keyboard.current が null になるため、実際のアプリでは完全版のような対応が安全です。
  • 旧方式(Input Manager):以前のUnityで使われていた方式です。Unity 6のProject Settings > Player の「Active Input Handling」が「Input System Package (New)」だけの場合、Input.GetKeyDown はエラーになります。「Both」にすると動作します。
  • 完全版(Input System):InputActionでEscapeキーとゲームパッドに対応し、Input Systemが無効な場合は旧方式で動くようにした例です。
using UnityEngine;
using UnityEngine.InputSystem;

public class Exit : MonoBehaviour
{
    // Escapeキーの押下でゲームを終了する
    // Updateメソッドは毎フレーム呼ばれるので、Updateメソッド内でキー入力を監視する

    [SerializeField]
    private Key exitKey = Key.Escape; // ゲーム終了キー

    // ゲーム終了キーを押したら、アプリケーションを終了する
    private void Update()
    {
        if (Keyboard.current[exitKey].wasPressedThisFrame)
        {
            // エディタ上で実行している場合は、エディタを終了する
#if UNITY_EDITOR
            UnityEditor.EditorApplication.isPlaying = false;

#elif UNITY_STANDALONE
            // スタンドアロンビルドの場合は、アプリケーションを終了する
            Application.Quit();
#endif
        }
    }
}
using UnityEngine;

public class Exit : MonoBehaviour
{
    // Escapeキーの押下でゲームを終了する
    // Updateメソッドは毎フレーム呼ばれるので、Updateメソッド内でキー入力を監視する
    [SerializeField]
    private KeyCode exitKey = KeyCode.Escape; // ゲーム終了キー
                                              // ゲーム終了キーを押したら、アプリケーションを終了する
    private void Update()
    {
        if (Input.GetKeyDown(exitKey))
        {
            // エディタ上で実行している場合は、エディタを終了する
#if UNITY_EDITOR
            UnityEditor.EditorApplication.isPlaying = false;
#elif UNITY_STANDALONE
               // スタンドアロンビルドの場合は、アプリケーションを終了する
               Application.Quit();
#endif
        }
    }
}
using UnityEngine;
#if ENABLE_INPUT_SYSTEM
using UnityEngine.InputSystem;
#endif

/// <summary>
/// Escapeキー(または指定アクション)でアプリを終了する。
/// - Input System が有効なら InputAction を使う
/// - 無効時は従来の Input.GetKeyDown でフォールバック
/// - モバイル(iOS/Android)では終了処理を行わない(OS任せ)
/// </summary>
[DisallowMultipleComponent]
public sealed class Exit : MonoBehaviour
{
    [SerializeField]
    private bool quitInEditor = true; // Editor再生停止を有効にするか

#if ENABLE_INPUT_SYSTEM
    [Header("Input System")]
    [Tooltip("未設定なら Escape / Gamepad Start/Select / XR Menu を実行時に自動バインド")]
    [SerializeField] private InputActionReference exitActionRef;

    private InputAction _exitAction;

    private void OnEnable()
    {
        // 参照があればそれを使う
        if (exitActionRef != null && exitActionRef.action != null)
        {
            _exitAction = exitActionRef.action;
        }
        else
        {
            // なければ実行時にアクションを生成
            _exitAction = new InputAction("Exit", InputActionType.Button, "<Keyboard>/escape");
            _exitAction.AddBinding("<Gamepad>/start");
            _exitAction.AddBinding("<Gamepad>/select");
            _exitAction.AddBinding("<XRController>/menu");
        }

        _exitAction.performed += OnExitPerformed;
        if (!_exitAction.enabled) _exitAction.Enable();
    }

    private void OnDisable()
    {
        if (_exitAction != null)
        {
            _exitAction.performed -= OnExitPerformed;

            // 実行時生成のみ Dispose
            if (exitActionRef == null) _exitAction.Dispose();
        }
    }

    private void OnExitPerformed(InputAction.CallbackContext _)
    {
        Quit();
    }
#else
    [Header("Legacy Input (フォールバック)")]
    [SerializeField] private KeyCode exitKey = KeyCode.Escape;

    private void Update()
    {
        if (Input.GetKeyDown(exitKey))
        {
            Quit();
        }
    }
#endif

    private void Quit()
    {
#if UNITY_EDITOR
        if (quitInEditor)
        {
            UnityEditor.EditorApplication.isPlaying = false;
        }
#elif UNITY_STANDALONE
        Application.Quit();
#endif
        // UNITY_ANDROID / UNITY_IOS では処理しない(OS管理に任せる)
    }
}

6. PC向けにビルドして確認する

Editorでの成功は「再生停止」の確認です。アプリ自体が閉じるかは、PC向けビルドでも確認しましょう。

  1. シーンを保存します。
  2. File > Build Profilesを開きます。
  3. Windows・macOS・Linuxのうち、実行して確認できるプラットフォームを選択します。必要なBuild Supportがない場合はUnity Hubから追加します。
  4. 必要に応じてプロファイルを作成・切り替え、Scene Listに今回のシーンを追加して有効にします。複数シーンがある場合は、このサンプルのシーンを先頭にするなど、起動時に開かれるようにします。
  5. Build And Runを実行し、プロジェクトのAssets外の保存先を選びます。
  6. 起動したアプリの「終了」をクリックし、アプリが終了することを確認します。

Unity 6では、以前のBuild Settingsに相当する画面がBuild Profilesになっています。Unity公式:Editorからのビルド

7. 動かないときの確認ポイント

症状確認すること
QuitGameが候補に出ないConsoleのコンパイルエラーを解消する。ファイル名とクラス名をGameQuitterに合わせ、public void QuitGame()になっているか確認する
No FunctionのままGameManagerにGameQuitterを追加し、On Click()でメソッドまで選択する
対象をドラッグできないProjectの.csではなく、HierarchyのGameManagerを使う
ボタンが反応しないQuitButtonとCanvasが有効か、ButtonのInteractableがオンか、CanvasにGraphic Raycasterがあるか確認する
入力関連のエラーが出るEventSystemの入力モジュールとActive Input Handlingの方式を合わせる
見えているのにクリックできない手前のPanelやImageのRaycast Target、Canvas GroupのBlocks RaycastsやInteractableを確認する。不要なUIが入力を遮っていないか調べる
方法Bでエラーログが出るBinderのQuit ButtonとGame Quitterの両方を、再生前に設定する
処理が重複する方法Aの登録と方法Bを併用していないか、Binderを複数追加していないか確認する
Editorで何も起きないApplication.Quit()だけにしていないか、今回の条件分岐を確認する
ビルドするとUnityEditor関連で失敗するEditor専用の参照を#if UNITY_EDITORの内側に置く。無条件のusing UnityEditor;も確認する
再生を止めると設定が戻るPlayモードを停止してからInspectorを設定し直し、シーンを保存する

クリックが届いているか分からないときは、QuitGame()の先頭に一時的にDebug.Log("QuitGameが呼ばれました");を入れ、Consoleを確認すると原因を分けて調べられます。

8. 終了処理を作るときの注意点

セーブが必要なら、終了する前に完了させる

今回のサンプルは、終了ボタンと終了処理の接続だけを扱います。ゲームの進行状況を保存する機能は含みません。

セーブが必要なゲームでは、「終了してよいか確認する → 保存する → 保存の完了を確認する → QuitGameを呼ぶ」という順序にします。保存に時間がかかる場合は、完了する前にApplication.Quit()を呼ばないようにしてください。

Webやスマートフォンでは終了方法を別に考える

今回のコードはPC向けに限定しているため、Web・Android・iOSのビルドでは終了処理を実行しません。

Application.Quit()の公式資料には、次の違いがあります。

  • Web:Web Playerを停止しますが、Webページやブラウザーのタブは閉じません。「タイトルへ戻る」など、Web向けの操作を用意すると分かりやすくなります。
  • Android・iOS:OSが用意する操作との一貫性を保つため、独自の終了方法を作ることは推奨されていません。
  • iOS:プログラムから終了させると、利用者にクラッシュしたように見える場合があります。

PC版と同じ終了ボタンを、そのままほかのプラットフォームに流用しないようにしましょう。Unity公式:Application.Quitのプラットフォーム別注意点

OnApplicationQuitは「終了させる命令」ではない

Application.Quit()は終了を要求するメソッドです。一方、OnApplicationQuit()は、終了時にUnityから通知されるコールバックです。ボタンを押したら終了させたい場合に、名前が似ているからといって置き換えるものではありません。Unity公式:MonoBehaviour.OnApplicationQuit

9. 自分で確認してみよう

  • Inspectorで接続した終了ボタンで、Editorの再生を止められる。
  • On Click()の終了処理を削除し、AddListenerで接続しても同じ結果になる。
  • PCビルドでは、終了ボタンで実行中のアプリを閉じられる。
  • QuitGame、On Click()、AddListenerの役割を、それぞれ説明できる。

終了処理をQuitGame()へまとめておくと、ボタン以外の入力から終了したくなった場合にも、同じメソッドを呼び出せます。

参考資料

参考:プラットフォーム依存コンパイル(Unityマニュアル)

訪問数 458 回, 今日の訪問数 1回

広告

Unity

Posted by hidepon