文档

支持

Matchmaker

Matchmaker

身份验证

Learn how authentication works in Matchmaker to securely identify and authorize players.
阅读时间2 分钟最后更新于 4 天前

Matchmaker 提供两种身份验证方法:
  • 玩家身份验证
  • 服务帐户身份验证

玩家身份验证

玩家身份验证使用 Unity Authentication 来启用基于玩家的匹配,使游戏客户端可以连接 Matchmaker Service 来创建工单。 使用 Matchmaker SDK 发出任何调用指令前,请务必初始化 Authentication 服务并登录。 您可以通过多种方法登录,最简单的方法是使用匿名登录

服务帐户身份验证

服务帐户身份验证适用于后端服务代表游戏客户端创建匹配工单的场景。如果需要将服务器权威数据(如技能值)添加到匹配工单,可以采用这种方法。 要创建服务帐户,请根据说明操作。 要在 Matchmaker 中使用服务帐户,请根据以下步骤操作。 以下是服务到服务身份验证的典型流程示例:
  1. 客户端执行匿名身份验证,如上文中玩家身份验证所述。
  2. 客户端通过
    PlayerId
    参数调用自定义后端服务器。
  3. 自定义后端会调用工单创建流程,其中
    impersonate-user-id
    标题的值设置为
    PlayerId
    curl --location --request POST 'https://matchmaker.services.api.unity.com/v2/tickets' --header 'Content-Type: application/json' --header 'Authorization: {{SERVICE-ACCOUNT-TOKEN}}'--header 'impersonated-user-id: {{PLAYER-ID}}' --data-raw '{ "players": [ { "id": "{{PLAYER-ID}}", "customData": { "Skill": {{ENRICHED-DATA}} } } ] }'
  4. 自定义后端将工单 ID 发送回客户端。
  5. 客户端使用客户端 SDK 轮询工单状态。