setup-multiplayer-services

多人游戏 SDK（Unity Multiplayer Services）

说明

1. 文档索引： 当具体信息不同时，以 Unity Multiplayer Sessions SDK 精选文档索引 为准，而非依赖记忆。使用这些参考资料来确定如何应用 SDK（以 Sessions 为先）；使用该资源来确定记录了什么。切勿向用户提及 llms.txt 文件名。如果无法访问该索引（网络或工具问题），则以此技能的 Markdown 参考资料和工作区中已安装的包（Package Manager / 源代码）作为具体信息的准确信息来源。

2. 参考顺序（按任务分类）：

   • 拓扑、发现、匹配流程、Netcode 对齐、API 选择： entrypoints.md（概览表、方法签名、选项表、筛选/排序枚举、QuickJoinOptions.Timeout、错误）→ implementation-fit.md → examples.md（面向用户的措辞）→ 优先使用 Multiplayer Sessions → workflows-prerequisites.md（深入了解）。
   • 专用游戏服务器（Unity.Services.Multiplayer.Server）： dgs-entrypoint.md（IMultiplayerServerService、UNITY_SERVER / asmdef 限制、仅限服务器的扩展）。
   • 较低层级的服务客户端： 仅当主要 API 不足以满足需求，或用户要求使用该层级时，才参考 underlying-services.md（参见下方的优先级）。

优先使用 Multiplayer Sessions

当任务涉及选择拓扑、发现、匹配流程或 Netcode 对齐，而不只是调用 API 时，请通过 implementation-fit.md（对话 → 项目 → 简短的针对性问题）来支撑建议。

主要路径： 使用 IMultiplayerService / MultiplayerService.Instance 和 ISession，基于 Unity.Services.Multiplayer 实现（概览见 entrypoints.md）；确保组合式流程与 llms.txt 保持一致。

面向用户的文本： 计划、权衡和澄清问题不得将 Lobby、Matchmaker、Relay 或 Multiplayer Sessions 拆分为单独命名的产品，除非用户已这样表述——规则见 implementation-fit.md 中的面向用户的问题与说明，示例见 examples.md。代码、编辑和技术参考可根据需要使用真实的类型名称和命名空间名称。

底层客户端（Unity.Services.Lobbies、Unity.Services.Matchmaker、Unity.Services.Relay）仅在以下情况使用：(1) 查阅 entrypoints.md 后，仍无法通过主要 API 实现目标；或 (2) 用户明确要求使用这些命名空间或产品。不要默认在这些底层接口中实现。

附加资源

仅从此入口读取；链接位于此技能文件夹下一级（没有 references/index.md 或 README 汇总页）。

• implementation-fit.md — 为建议提供依据：对话 → 项目 → 用户问题；面向用户的语言规则；需求维度（拓扑、发现、韧性、平台、网络栈）。
• examples.md — 澄清问题和面向用户的说明示例（前后对照，非代码）。
• entrypoints.md — IMultiplayerService、ISession、概述和能力表、方法签名、选项表（默认值、限制）、筛选/排序枚举、会话/网络/主机流程、错误、编辑器组件。
• dgs-entrypoint.md — 专用服务器：Unity.Services.Multiplayer.Server、IMultiplayerServerService、MultiplayerServerService / GetMultiplayerServerService、MatchmakerServerExtensions、UNITY_SERVER 和 asmdef 限制；通用 SessionOptions 详情请参阅 entrypoints。
• workflows-prerequisites.md — 按工作流列出的包和云端前置条件（表格）。
• underlying-services.md — 回退命名空间和 IUnityServices 访问器（仅供 Agent 使用；非默认路径）。