マッチセッションメニューの追加 - 専用サーバーで参加可能なセッションを作成する - (Unity モジュール)

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

メニューの内容​

このセクションでは、ゲームセッションの作成と閲覧のための UI メニューを準備する方法を学びます。これらの UI は以下のクラスで定義されています:

  • CreateMatchSessionMenu: ゲームセッションを作成する前にゲームモードの選択を表示するために使用される C# クラスです。

    • C# ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Scripts/UI/CreateMatchSessionMenu.cs
    • Prefab ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Prefabs/CreateMatchSessionMenu.prefab

  • CreateMatchSessionServerTypeMenu: ゲームセッションを作成する前にサーバータイプの選択（専用サーバーまたはピアツーピア）を表示するために使用される C# クラスです。

    • C# ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Scripts/UI/CreateMatchSessionServerTypeMenu.cs
    • Prefab ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Prefabs/CreateMatchSessionServerTypeMenu.prefab

  • CreateMatchSessionDSMenu_Starter: セッションの作成や参加など、専用サーバーを使用したゲームセッションの状態を表示するために使用される C# クラスです。

    • C# ファイル: Assets/Resources/Modules/Play/MatchSessionDS/Scripts/UI/CreateMatchSessionDSMenu_Starter.cs
    • Prefab ファイル: Assets/Resources/Modules/Play/MatchSessionDS/Prefabs/CreateMatchSessionDSMenu_Starter.prefab

  • BrowseMatchMenu: 参加可能なゲームセッションのリストを表示するために使用される C# クラスです。

    • C# ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Scripts/UI/BrowseMatchMenu.cs
    • Prefab ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Prefabs/BrowseMatchMenu.prefab

  • BrowseMatchEntry: 個々の参加可能なゲームセッションエントリを表示するために使用される C# クラスです。

    • C# ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Scripts/UI/BrowseMatchEntry.cs
    • Prefab ファイル: Assets/Resources/Modules/Play/MatchSessionEssentials/Prefabs/BrowseMatchEntry.prefab

これらの UI がどのように構築されているかの詳細については、以下をご覧ください。

マッチセッション作成メニュー​

以下は CreateMatchSessionMenu Prefab のプレビューです。この Prefab には、ゲームセッションを作成する前にゲームモードを選択するためのボタンが含まれています。

Create match session menu preview Unity Byte Wars joinable sessions dedicated server

このメニューで使用されるコンポーネントは、CreateMatchSessionMenu クラスで定義されています。ゲームモードボタンのいずれかがクリックされると、選択されたゲームモードが SelectedGameMode プロパティに保存されます。

public static InGameMode SelectedGameMode { get; private set; }

[SerializeField] private Button eliminationButton;
[SerializeField] private Button teamDeathMatchButton;
[SerializeField] private Button backButton;

マッチセッションサーバータイプメニュー​

以下は CreateMatchSessionServerTypeMenu Prefab のプレビューです。この Prefab には、ゲームセッションを作成する前にサーバータイプを選択するためのボタンが含まれています。

Create match session server type menu preview Unity Byte Wars joinable sessions dedicated server

このメニューで使用されるコンポーネントは、CreateMatchSessionServerTypeMenu クラスで定義されています。サーバータイプボタンのいずれかがクリックされると、選択されたタイプに基づいて次のメニューが開きます。たとえば、専用サーバーボタンがクリックされると、CreateMatchSessionDSMenu_Starter Prefab がインスタンス化されます。

[SerializeField] private Button dedicatedServerButton;
[SerializeField] private Button peerToPeerButton;
[SerializeField] private Button backButton;

マッチセッション DS メニュー​

CreateMatchSessionDSMenu_Starter Prefab には、ゲームセッションの作成または参加の状態に基づいて特定のメニューを表示するための状態スイッチャーが含まれています。メニューの状態を切り替えるには、CreateMatchSessionDSMenu_Starter クラスで定義された以下のコンポーネントを使用します。

[SerializeField] private MatchSessionStateSwitcher stateSwitcher;

以下は、このメニューに含まれる状態のリストです。

  • マッチ作成状態

    この状態では、ゲームセッションを作成するリクエストが送信されていることを示すメッセージが表示されます。また、プロセスをキャンセルするためのボタンも表示されます。

    Create match session DS menu create match state preview Unity Byte Wars joinable sessions dedicated server

  • マッチ参加状態

    この状態では、ゲームセッションに参加するリクエストが送信されていることを示すメッセージが表示されます。また、プロセスをキャンセルするためのボタンも表示されます。

    Create match session DS menu join match state preview Unity Byte Wars joinable sessions dedicated server

  • マッチ退出状態

    この状態では、ゲームセッションの作成または参加のリクエストがキャンセルされていることを示すメッセージが表示されます。

    Create match session DS menu leave match state preview Unity Byte Wars joinable sessions dedicated server

  • サーバーリクエスト状態

    この状態では、セッションが現在マッチをホストするサーバーをリクエストしていることを示すメッセージが表示されます。また、リクエストをキャンセルするためのボタンも表示されます。

    Create match session DS menu requesting server state preview Unity Byte Wars joinable sessions dedicated server

  • エラー状態

    この状態では、ゲームセッションプロセス中に発生したエラーメッセージが表示されます。また、ゲームセッションの作成または参加を再試行するためのボタンも表示されます。

    Create match session DS menu error state preview Unity Byte Wars joinable sessions dedicated server

マッチ閲覧メニュー​

以下は BrowseMatchMenu Prefab のプレビューです。この Prefab は、参加可能なゲームセッションのリストを表示します。

Browse match menu preview Unity Byte Wars joinable sessions dedicated server

このメニューで使用されるコンポーネントは、BrowseMatchMenu クラスで定義されています。

[SerializeField] private AccelByteWarsWidgetSwitcher widgetSwitcher;
[SerializeField] private BrowseMatchEntry sessionEntryPrefab;
[SerializeField] private Transform sessionListPanel;
[SerializeField] private ScrollRect sessionListScrollRect;
[SerializeField] private GameObject listLoaderPanel;
[SerializeField] private Button refreshButton;
[SerializeField] private Button backButton;

メニューが表示されたとき、または更新ボタンがクリックされたときに、以下のデリゲートがトリガーされます。このデリゲートを使用して、このメニューに表示するゲームセッションをクエリします。

public static event BrowseMatchHandler OnBrowseDSMatch = delegate { };

マッチ閲覧エントリ​

以下は BrowseMatchEntry Prefab のプレビューです。この Prefab は、参加する個々のゲームセッションエントリを表示します。セッションオーナー、ゲームモード、サーバータイプ、セッション内のプレイヤー数などの情報が表示されます。

Browse match entry preview Unity Byte Wars joinable sessions dedicated server

このメニューで使用されるコンポーネントは、BrowseMatchEntry クラスで定義されています。

[SerializeField] private AccelByteWarsAsyncImage sessionOwnerImage;
[SerializeField] private TMP_Text sessionOwnerText;
[SerializeField] private TMP_Text gameModeText;
[SerializeField] private TMP_Text serverTypeText;
[SerializeField] private TMP_Text memberCountText;
[SerializeField] private Button joinButton;

参加ボタンがクリックされると、以下のデリゲートがトリガーされます。このデリゲートを使用して、マッチ閲覧メニューから選択されたゲームセッションに参加するリクエストを送信します。

public static event JoinMatchHandler OnJoinDSMatchButtonClicked = delegate { };

UI の準備​

このセクションでは、ゲームセッション機能の統合を開始するために、前述のメニューを準備します。

  1. CreateMatchSessionDSMenu_Starter クラスを開き、以下の関数を作成します。後でこの関数を使用してゲームセッション作成リクエストを送信します。今のところ、以下のコードを追加して、メニューをマッチ作成状態に切り替えます。

    private void CreateMatchSession()
    {
        stateSwitcher.SetState(MatchSessionMenuState.CreateMatch);
    }

  2. ゲームセッションに参加するためにも CreateMatchSessionDSMenu_Starter クラスを使用します。そのため、参加するゲームセッション ID を保存するために、以下のヘルパー変数を宣言しましょう。

    private BrowseSessionModel sessionToJoin = null;

  3. 次に、以下の新しい関数を作成します。後でこの関数を使用してゲームセッションに参加するリクエストを送信します。今のところ、以下のコードを追加して、メニューをマッチ参加状態に切り替えます。

    private void JoinMatchSession(string sessionId)
    {
        stateSwitcher.SetState(MatchSessionMenuState.JoinMatch);
    }

  4. 以下の新しい関数を作成します。後でこの関数を使用してゲームセッションから退出するリクエストを送信します。今のところ、以下のコードを追加して、メニューをマッチ退出状態に切り替えます。

    private void LeaveMatchSession(string sessionId)
    {
        stateSwitcher.SetState(MatchSessionMenuState.LeaveMatch);
    }

  5. 事前定義された OnEnable() 関数を以下のコードに置き換えて、メニューが表示されたときにゲームセッションを作成するか参加するかを判断します。また、再試行ボタンとキャンセルボタンをそれに応じて再バインドします。

    private void OnEnable()
    {
        if (sessionToJoin == null)
        {
            stateSwitcher.OnRetryButtonClicked = CreateMatchSession;
            stateSwitcher.OnCancelButtonClicked = () => LeaveMatchSession(AccelByteWarsOnlineSession.CachedSession.id);
            CreateMatchSession();
        }
        else
        {
            stateSwitcher.OnRetryButtonClicked = () => JoinMatchSession(sessionToJoin.Session.id);
            stateSwitcher.OnCancelButtonClicked = () => LeaveMatchSession(sessionToJoin.Session.id);
            JoinMatchSession(sessionToJoin.Session.id);
        }
    }

  6. 次に、事前定義された Awake() 関数を以下のコードに置き換えて、マッチ閲覧エントリから参加ボタンがクリックされたときのイベントをバインドします。

    private void Awake()
    {
        BrowseMatchEntry.OnJoinDSMatchButtonClicked += async (BrowseSessionModel sessionModel) =>
        {
            if (await AccelByteWarsOnlineSession.OnValidateToJoinGameSession.Invoke(sessionModel.Session))
            {
                sessionToJoin = sessionModel;
                MenuManager.Instance.ChangeToMenu(GetAssetEnum());
            }
        };
    }

  7. 事前定義された OnDisable() 関数を以下のコードに置き換えて、キャッシュをリセットします。

    private void OnDisable()
    {
        sessionToJoin = null;
    }

  8. Unity エディターで、Assets/Resources/Modules/Play/MatchSessionDS に移動し、MatchSessionDSEssentialsAssetConfig.asset を開きます。Is Active と Is Starter Active の両方のチェックボックスをオンにして、モジュールがスターターモードでアクティブ化されていることを確認します。

  9. 最後に、エディターでゲームをプレイします。Play Online > Create Match からメインメニューに移動し、任意のゲームモードを選択して、Dedicated Server ボタンをクリックできるはずです。その後、メニューはマッチ作成状態に切り替わります。後で、この動作を実際のゲームセッションの作成と参加のリクエストに置き換えます。

リソース​

に最終更新
On this page