Matchmaking 示例教程
Matchmaking 示例教程
搭配服务
在开始使用 Matchmaking 之前，您需要先按照 示例教程 中的指引创建一个启动配置、制作镜像并应用配置。本教程中并不涉及到服务器程序的改动，因此您可以直接使用示例教程中创建的启动配置。您也可以自行构建服务器程序并制作镜像。
请确保您已经 创建 UOS APP 并开启 Multiverse 服务，进入「项目设置」页面，点击启用「Matchmaking」功能，并进行确认。
需要注意的是，Matchmaking作为Multiverse的支持"玩家匹配"的功能，依赖于Multiverse的「房间管理」功能。因此，对于没有启用「房间管理」功能的应用，在启用「Matchmaking」后，会自动启动「房间管理」功能。
启用「Matchmaking」功能后，可以通过目录进入「Matchmaking」的页面，点击「立即创建」按钮就可以开始创建 Match 配置。
写 Match 配置的名称，并且可以对「超时时长」和「匹配回填」等相关配置项进行调整，然后点击「选择模板」，进入模板选择页面。
我们基于市面上常见的游戏玩法及其匹配机制为用户事先准备了一系列的 Match 配置的模板。在本教程中，我们以「5v5排位赛」的玩法匹配模板为例进行说明。选择了相应的模板后，点击「创建」之后，就可以创建相应的 Match 配置。
在开始使用 Matchmaking 之前，您可以先阅读 Sync 的 快速上手 篇章，对 Sync 的概念和接入方法进行了解，便于您后续在 Sync 应用中开通 Matchmaking 服务用于创建匹配对局。
请确保您已经 创建 UOS APP 并开启 Sync 服务，进入「项目设置」页面，点击启用「Matchmaking」功能，并进行确认。
启用「Matchmaking」功能后，可以通过目录进入「Matchmaking」的页面，点击「立即创建」按钮就可以开始创建 Match 配置。
填写 Match 配置的名称，并且可以对「超时时长」和「匹配回填」等相关配置项进行调整，然后点击「选择模板」，进入模板选择页面。
我们基于市面上常见的游戏玩法及其匹配机制为用户事先准备了一系列的 Match 配置的模板。在本教程中，我们以「5v5排位赛」的玩法匹配模板为例进行说明。选择了相应的模板后，点击「创建」之后，就可以创建相应的 Match 配置。
编辑 Match 配置
在 Match 配置的详情页中，可以对配置模板所提供的匹配信息进行调整，也可以更换新的模板，或者是对相关配置项进行调整。
对于配置的参数说明，参见： 配置参数
测试 Match 配置
点击「测试」按钮，可以启用 Match 配置的测试页面
在测试过程中，我们需要先基于创建的模板去生成一系列用于测试的模拟用户。点击「生成」按钮，进入生成模拟用户的窗口。
在生成模拟用户的窗口中，我们需要设置生成的模拟用户的数量，并且根据模板中提供的玩家属性，来设置随机生成的用户的各项属性值。
对于数值型(number)的属性来说，我们需要设置相应的最大值和最小值，在生成模拟用户的过程中，相应的属性就会在这个取值范围内随机生成；而对于字符串型(string)的属性来说，我们需要设置具体的取值范围。
点击「生成」按钮就可以随机创建指定数量的模拟用户来进行测试。
点击「启动模拟」，进行匹配的模拟。匹配模拟的结果会展示在页面的下方。因为在随机生成的用户的过程中，我们将用户的游戏模式（mode）的范围设置在了排位（ranking）和练习（practice）两类，而我们选择的模板只针对于「5v5排位赛」，所以会有一部分用户进入「资质不符玩家」的列表中，而其余用户则会划分至不同的场次，人数不足以开启对局的玩家，则会进入「匹配失败玩家」的列表中。
应用 Match 配置
测试成功之后，即可参考 SDK 指南 在客户端中接入 Matchmaking SDK，在需要创建对局时发起匹配Ticket对玩家进行匹配。