ドキュメント

Unity Engine

Unity Engine

Matchmaker セッションの構成要素

プロジェクトに Unity の Multiplayer Matchmaker を、この構成要素の事前に作成された UI 要素とともに実装します。
読み終わるまでの所要時間 15 分最終更新 6日前

Unity の Multiplayer Matchmaker をプロジェクトに実装し、この Unity ビルディングブロックの既成の UI 要素を使用します。Matchmaker とは何か、その設定方法、Matchmaker キューとは何か、Unity のNetcodeパッケージへの接続方法について説明します。

概要

Matchmaker セッションビルディングブロックは、Unity の Matchmaker をプロジェクトに統合してプレイヤー同士を接続するのに役立ちます。この構成要素は、Multiplayer プロジェクトの出発点として、または開発全体を通して Matchmaker の迅速なインテグレーションとして使用できます。
このビルディングブロックは、以下の方法を示しています。
  • Unity プロジェクトから Matchmaker キュー設定を管理します。
  • 再生モード中に使用するために、このようなアセットウドサービスにデプロイします。
  • ルールのリストを使用してMatchmakerサービスを通じてプレイヤーを接続します。
Matchmaker セッションの構成要素には、シーン例、UIToolkit UI、およびプレイヤー同士を接続するための基本的なルールを持つ Matchmaker キュー設定のプリセットが含まれます。ゲームプレイの同期が必要な場合は、オプションで Unity Netcode for GameObjects または Netcode for Entities を使用して Netcode を追加できます。

前提条件

初期設定

  1. エディタの「Assets」>「Blocks」>「MatchmakerSession」>「Settings」で、
    MatchmakerQueue
    アセットファイルを選択します。
  2. 「
    Inspector

    ?

    」ウィンドウで、「デプロイウィンドウで表示」を選択します。
  3. デプロイ ウィンドウで、
    Blocks.MatchmakerSession
    の下の
    MatchmakerQueue
    ファイルを選択し、右クリックしてデプロイを選択してキューを設定します。
含まれているサンプルシーンを開くと、構成要素が正しくインストールされていることを検証できます。
  1. フォルダー Assets > Blocks > MatchmakerSession > Scenes にあるサンプルシーンを開きます。
  2. 再生モードを開始し、サインインが成功し、サービス エンドポイントに到達できることを確認します。

Unity Matchmaker

Unityのマッチメイキングでは、スキル、地域、ゲームモード、パーティサイズなどのルールに基づいて、プレイヤーをマルチプレイヤーセッションに自動的にグループ化します。

一般的な概念

  • チケット/キュー:プレイヤーはリクエストを送信し、マッチングを待機します。
  • Attributesスキル、地域、入力デバイス、パーティ サイズ、ゲーム モード。
  • チームバランス:公平なチームを実現するためにプレイヤーを分配する。
  • 待ち時間または地域ルーティング:近くのサーバーにプレイヤーを配置する。

一般的なフロー

  1. プレイヤーが参加リクエストを作成する。
  2. サービスはリクエストをキューに入れ、ルールで検索します。
  3. 一致すると、セッションが作成されます。
  4. プレイヤーは接続情報を受け取り、セッションに参加します。

含まれるシーン

アセット名

説明

Matchmake設定された条件に基づいて、互換性のあるプレイヤーとユーザーを接続します。マッチを最適化するための設定を追加できます。

Matchmake

.UXML
  • MatchmakeButton
    : 指定されたキュー名で Matchmake を開始します。
  • CancelButton
    : 現在の Matchmake リクエストをキャンセルします。
  • SessionConnectingTimerLabel
    : Matchmake の試行がアクティブになっている時間を表示します。
.UXML
  • SessionNameLabel
    : ウォッチしているセッションの名前を表示します。
  • PlayerCountLabel
    : 視聴したセッションのプレイヤー数を表示します。
  • PlayerNameLabel
    : プレイヤー自身の名前を表示します。
  • CopySessionCodeElement
    : コピーできるようにセッションの参加コードを表示します。
  • PlayerListView
    : セッションに参加しているプレイヤーのリストを表示します。
  • LeaveSessionButton
    : 参加セッションから退出する場合に選択します。

Matchmaker キュー

Matchmakerキューは、プレイヤーチケットが収集され、評価されてマッチが作成される、ルール主導の待機ラインです。キューは、必須の属性、地域、モード、チーム サイズ、ロール、優先順位(例えば公平性対スピードなど)の設定を実行します。キューは互換性のあるチケットをマッチに集めてレート制限を処理し、有効な一致が作成されると参加データを返します。
このビルディングブロックには、各チームの 1 人から 2 人のプレイヤーまで 2 つのチームにマッチする単純な Matchmaker キュー設定が含まれています。その他の制限はありません。また、20 秒後に必要なチームの数を 1 つに減らす緩和ルールがあり、1 人の参加プレイヤーが 20 秒後にセッションに正常に参加できます。
より精細なルールのために、ダッシュボードですでに展開されている Matchmaker キューを変更し、調整可能なマッチメイキング ルールの全セットにアクセスできます。

マッチメイキングと Quick Join の違い

Multiplayer Services Matchmake API には、Quick Join と Matchmake の両方のオプションがあります。Quick Join は、使用可能な Lobby を見つける単純なアクションです。Matchmake は、最初の使用可能な一致だけでなく、可能な限り最良の一致をターゲットとするルール主導のプロセスです。

Quick Join /Quick Join

  • 開いている互換性のあるLobbyに最も迅速に入室する方法。
  • 最低限のルール。品質よりもスピードを優先。
  • カジュアルでリスクの少ない再生や小規模なロビーに最適です。

マッチメイキング

  • キュー ベースのルール主導プレースメント。例えば、スキル、地域、モード、パーティ サイズなど。
  • 公平なチーム、待ち時間の短縮、適切なサーバー アロケーションを目指します。
  • バックフィル、クロス再生フィルタ、専用サーバをサポートします。
即座に Quick Join を使用します。マッチメイキングは、バランス、待ち時間、役割の制約、サーバー オーケストレーションが重要な場合に使用します。Quick Join の例については、マルチプレイヤー セッションのビルディング ブロックを参照してください。

ローカルでのマッチメイキングのテスト

設定をローカルでテストするには、Multiplayer Play Mode を使用します。

セッションへの Netcode の追加

Netcode for GameObjects または Netcode for Entities をセッションに統合するには、以下の手順を実行します。
  1. Package Manager (ウィンドウ> パッケージ管理> Package Manager) を使用して、任意の Netcode パッケージをインストールします。
  2. SessionSettings
    でCreate Network Sessionを有効にします。
    • SessionSettings
      ScriptableObject で、Create Network Session オプションを見つけて有効にします。これにより、選択した Netcode ソリューションでセッションを認識および管理できるようになります。
  3. SessionSettings
    でネットワーク タイプを変更します。
    • SessionSettings
      内のネットワーク タイプを調整して、目的のネットワーク アーキテクチャと一致させます。以下から選択できます。
      • Relayクラウドベースの Relay サービス用。
      • 分散権限:Netcode for GameObjects 分散権限を使用する場合。
      • 直接:IP アドレスとポートを使用した直接接続用。
さまざまなネットワークタイプの詳細については、「ネットワーク接続管理」を参照してください。

トラブルシューティング

Multiplayer Servicesは使用できません

  • Multiplayer Services を初期化する必要があります。ServicesInitialization コンポーネントと PlayerAuthentication コンポーネントを追加して、独自のシーンをデフォルト設定で初期化できます。

Authentication失敗

  • Unity Dashboard で正しいプロジェクト ID の Matchmaker が有効になっていることを確認します。
  • 正しい組織と環境でエディターにサインインしていることを確認します。

Matchmaker エラー(404 または一致不可)

  • キュー Deployment 状態をチェックします。エディタで、「Assets」>「Blocks」>「MatchmakerSession」>「**Settings」**内の
    MatchmakerQueue
    アセットを選択し、Inspector がファイルヘッダーに緑のアイコンで Up to Date と表示されていることを確認します。
  • UXML 内の
    MatchmakeButton
    が適切な
    MatchmakerQueue
    アセットを参照していることを確認します。
  • キュー設定を確認するには、
    MatchmakerQueue
    アセットで、チームとプレイヤーの最小数が接続しようとしているクライアントの数と一致していることを確認します。プロジェクトのキュー設定に変更を加えた場合、再生再生モード中に機能させるには、デプロイ ウィンドウから再度デプロイする必要があります。

UI にデータが表示されない

  • UXML の各
    VisualElement
    に、その
    SessionType
    が正しく設定されていることを確認します。

追加リソース