使用の準備

前提条件

• Unity ID の作成
• Unity Cloud アカウントの作成
• Unity Cloud アカウントでのプロジェクトの作成

ホスティングの設定

Matchmaker SDK のインストール

1. Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) に移動します。
2. Package Manager で、以下のパッケージを検索します。
   • Unity 6 以上:

     com.unity.services.multiplayer

   • Unity 2022 LTS 以前:

     com.unity.services.matchmaker

3. パッケージを選択して Install (インストール) を選択します。

Matchmaker の設定

1. cloud.unity.com に移動します。
2. サイドバーから Products (製品) タブを選択します。
3. Gaming Services (ゲームサービス) > Multiplayer (マルチプレイヤー) で、Matchmaker に移動し、Launch (起動) を選択します。

キューとプールの作成

1. Create a Queue (キューの作成) を選択します。最初のキューの名前を選択し、マッチメイキングチケットの最大プレイヤー数を設定します。Create (作成) をクリックします。
2. Create a Pool (プールの作成) を選択します。プールの名前を選択します。前の手順で作成したキューを選択します。チケットのタイムアウトの値を設定します。Next (次へ) をクリックします。
3. 以下に従ってホスティングタイプを選択します。

• Multiplay Hosting を使用している場合には、ドロップダウンメニューで Multiplay Hosting を選択し、Multiplay Hosting を設定したときに作成した フリート と ビルド設定 を選択します。
• Unity が提供するクライアントホスト型ソリューションを使用している場合には、ドロップダウンメニューで Client Hosting (クライアントホスト) を選択します。

5. Next (次へ) をクリックします。

{  "Name": "Test",  "MatchDefinition": {    "Teams": [      {        "Name": "Main team",        "TeamCount": {          "Min": 1,          "Max": 1        },        "PlayerCount": {          "Min": 1,          "Max": 5        }      }    ],    "MatchRules": []  },  "BackfillEnabled": false}

5. Logic Builder (ロジックビルダー) をクリックし、ドロップダウンで地域を 1 つ選択して Default QoS Region (デフォルトの QoS リージョン) を設定します。
6. ページの下部にある Create (作成) をクリックします。

マッチメイキングチケットの作成

Unity SDK

var players = new List<Unity.Services.Matchmaker.Models.Player>{    new ("Player1", new Dictionary<string, object>())};// Set options for matchmakingvar options = new CreateTicketOptions(  "Default", // The name of the queue defined in the previous step,  new Dictionary<string, object>());// Create ticketvar ticketResponse = await MatchmakerService.Instance.CreateTicketAsync(players, options);// Print the created ticket idDebug.Log(ticketResponse.Id);

CURL

# Fetch anonymous token##fetch-anonymous-tokencurl -X POST -H "ProjectId: <projectId>" https://player-auth.services.api.unity.com/v1/authentication/anonymous# Call the create ticket endpoint##call-the-create-ticket-endpointcurl -X POST -H "Authorization: Bearer <TOKEN>" \-H 'Content-Type: application/json' \--data-raw '{    "queueName": "Default",    "attributes": {},    "players": [{        "id": "Player 1",        "customData": {}    }]}' \'https://matchmaker.services.api.unity.com/v2/tickets'

REST API

チケットステータスのポーリング

Unity SDK

MultiplayAssignment assignment = null;bool gotAssignment = false;do{    //Rate limit delay    await Task.Delay(TimeSpan.FromSeconds(1f));    // Poll ticket    var ticketStatus = await MatchmakerService.Instance.GetTicketAsync("<ticket id here>");    if (ticketStatus == null)    {        continue;    }    //Convert to platform assignment data (IOneOf conversion)    if (ticketStatus.Type == typeof(MultiplayAssignment))    {        assignment = ticketStatus.Value as MultiplayAssignment;    }    switch (assignment?.Status)    {        case MultiplayAssignment.StatusOptions.Found:            gotAssignment = true;            break;        case MultiplayAssignment.StatusOptions.InProgress:            //...            break;        case MultiplayAssignment.StatusOptions.Failed:            gotAssignment = true;            Debug.LogError("Failed to get ticket status. Error: " + assignment.Message);            break;        case MultiplayAssignment.StatusOptions.Timeout:            gotAssignment = true;            Debug.LogError("Failed to get ticket status. Ticket timed out.");            break;        default:            throw new InvalidOperationException();    }} while (!gotAssignment);

CURL

# Call the poll ticket status endpoint with same anonymous token as for the creation##call-the-poll-ticket-status-endpoint-with-same-anonymous-token-as-for-the-creationcurl -X GET -H "Authorization: Bearer <TOKEN>" \--header 'Content-Type: application/json' \'https://matchmaker.services.api.unity.com/v2/tickets/status?id=<TICKETID>'

REST API

マッチメイキングの結果

Unity SDK

var payloadAllocation = await MultiplayService.Instance.GetPayloadAllocationFromJsonAs<MatchmakingResults>();

server.json

CURL

curl -X GET http://localhost:8086/payload/<allocation_uuid>