> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置多人服务

> 为您的游戏配置 XBOX 多人服务,包括服务配置中的会话模板、SmartMatch 匹配器和自定义邀请字符串。

本主题介绍如何配置多人服务,包括配置会话模板、SmartMatch 匹配器 (hopper) 和自定义邀请字符串。为了让您的游戏利用 XBOX 服务,必须首先定义游戏的服务配置。您的服务配置存在于 XBOX 服务云中,并定义 XBOX 服务如何与运行您游戏的设备交互。

您可以配置多人服务的以下三个方面。

* 会话模板
* SmartMatch 匹配器
* 自定义邀请字符串

## 会话模板

通过使用 XBOX 多人服务,玩家可以创建和加入会话、与同一会话中的其他玩家交换会话消息,并将游戏结果发布到会话。请注意,发布结果会清理会话并更新会话中所有玩家的排行榜。

例如,多人会话可以是两个玩家之间的一盘国际象棋。多人会话的另一个示例可能是许多玩家参与的持续进行的动作冒险游戏。当游戏创建新的多人会话时,它基于预定义的会话模板来创建。此模板本质上是包含描述会话属性的 JSON 对象。

创建新的会话模板时,必须定义下表所示的值。

| 字段             | 说明                                                     |
| -------------- | ------------------------------------------------------ |
| 会话名称           | 创建一个可表征多人会话模板的名称。选择一个便于记忆和识别的名称。名称必须是最多 100 个字符的文本字符串。 |
| 合约版本           | 此值由系统自动填充,表示 JSON 合约的当前系统版本。请勿编辑此值。                    |
| 会话模板 (JSON 文本) | 指定描述与多人会话关联的各种属性的 JSON 数据。                             |

有关多人会话模板的详细信息,包括若干可用作 JSON 文本基础的预定义模板,请参见 [多人会话模板](/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates)。

<Info>游戏通过最终认证后,您将无法再更改或删除该游戏中已有的多人会话。</Info>

## SmartMatch 匹配器

SmartMatch 匹配器是 XBOX 多人服务的一个可选补充。SmartMatch 匹配器是基于 XBOX 服务器的匹配服务的名称。它根据以下信息将玩家分组。

* 由游戏提供
* 存储在玩家统计信息中
* 来自玩家偏好
* 来自服务质量 (QoS)

匹配现在基于服务器。玩家可以向服务提交请求,并在找到匹配时接到通知。这意味着玩家不必在您的游戏中等待匹配过程发生。他们可以自由地玩游戏的单人部分,甚至玩其他游戏,同时仍然是匹配的候选者。这种方法消除了在找到匹配之前必须达到玩家临界质量的需要。

<Note>您必须基于先前定义的会话模板来构建匹配器。</Note>

创建新的 SmartMatch 匹配器时,必须定义下表所示的值。

| 字段      | 说明                                                                  |
| ------- | ------------------------------------------------------------------- |
| 名称      | 输入一个可表征匹配器的名称。选择一个便于记忆和识别的名称。名称是最多 140 个字符的文本字符串。                   |
| 最小组大小   | 指定可接受的最小玩家数。最小值为 1。                                                 |
| 最大组大小   | 指定可接受的最大玩家数。最大值为 256。                                               |
| 规则扩展周期数 | 默认值为 3,对于典型的玩家群体不应更改。                                               |
| 排名匹配器   | 如果匹配器被标记为排名匹配器,则允许该匹配器中的玩家被匹配到一起 — 即使他们已相互屏蔽。这有助于防止玩家屏蔽技能水平更高的其他玩家。 |
| 自动从会话更新 | 当启用此字段时,对会话成员列表或成员自定义属性的更改会自动传播到先前提交的票证。                            |

<Info>游戏通过最终认证后,您将无法再更改或删除该游戏中已有的匹配器。</Info>

## 自定义邀请字符串

当您的游戏向玩家发送邀请以加入多人游戏时,您可以选择显示自定义邀请文本字符串,而不是默认邀请字符串。创建新的自定义邀请字符串时,必须定义下表中的值。

| 字段 | 说明                                                                      |
| -- | ----------------------------------------------------------------------- |
| ID | 自定义邀请字符串的标识符。`custominvitestrings_` 会自动附加到您的 ID 的开头。此字符串的最大长度为 100 个字符。 |
| 值  | 显示在自定义邀请通知中的自定义邀请字符串的文本。此字符串的最大长度为 100 个字符。                             |

## 其他信息

有关配置多人服务的更多信息,请参见以下主题。

| 主题名称                                                                                        | 说明                         |
| ------------------------------------------------------------------------------------------- | -------------------------- |
| [多人会话模板](/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates)          | 简要概述多人会话模板并提供若干可复制和修改的模板示例 |
| [会话模板常量](/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants) | 描述多人会话模板的预定义元素             |
| [在多人游戏中使用大型会话](/services/xbox-services/multiplayer/mpsd/concepts/live-large-sessions)       | 描述何时以及如何使用大型会话             |


## Related topics

- [多人服务器对比](/zh-CN/services/playfab/multiplayer/servers/server-comparison.md)
- [归档和检索多人服务器日志](/zh-CN/services/playfab/multiplayer/servers/archiving-and-retrieving-multiplayer-server-logs.md)
- [分配游戏服务器并连接 Visual Studio 调试器](/zh-CN/services/playfab/multiplayer/servers/allocating-game-servers-and-configuring-vs-debugging-tools.md)
- [多人游戏概念](/zh-CN/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts-nav.md)
- [概念](/zh-CN/services/xbox-services/multiplayer/concepts/index.md)