시작하기

필수 조건

• 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이 구성될 때 생성된 Fleet과 Build Configuration을 선택합니다.
• 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를 클릭하고 드롭다운에서 지역을 선택해 Default QoS Region을 설정합니다.
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>