开始使用

先决条件

• 创建 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（默认 QoS 地区）。
6. 单击页面底部的 Create（创建）。

创建 Matchmaking 工单

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>