Unity 多人联机 SDK
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/unity-technologies-skills-setup-multiplayer-services。
技能介绍
要解决什么问题
在 Unity 里接多人联机,最容易踩坑的不是某个 API 拼写,而是先选对拓扑、发现方式、匹配流程,以及和 Netcode 的职责边界。官方能力横跨 Unity.Services.Multiplayer(Sessions 主路径)、专用游戏服务器 Unity.Services.Multiplayer.Server,以及 Lobby、Matchmaker、Relay 等更低层客户端;若一上来就按「产品名」拆方案,很容易和用户真实项目结构对不齐。
技能如何工作
本技能以 Sessions 优先 组织回答:以文档地图为权威来源(网络不可用时回退到技能内 markdown 与工作区已装包),按任务类型引用 entrypoints → implementation-fit → examples 等资料。
- 选型与对齐:拓扑、发现、匹配流、Netcode 对齐、API 选择时,先读
implementation-fit.md,通过对话 → 项目上下文 → 有针对性的澄清问题落地建议。 - 主实现路径:默认围绕
IMultiplayerService/MultiplayerService.Instance与ISession编写与修改代码;对用户可见的说明遵循 examples 中的措辞规则,避免擅自把 Lobby / Matchmaker / Relay 拆成互不相关的「产品线叙事」。 - 专用服务器:需要 DGS 时走
dgs-entrypoint.md,处理IMultiplayerServerService、UNITY_SERVER与 asmdef 约束等服务器侧细节。 - 底层客户端:仅在主 API 无法满足(且已核对 entrypoints),或用户明确要求
Unity.Services.Lobbies/ Matchmaker / Relay 命名空间时,才引用underlying-services.md。
适用边界与注意点
技能侧重如何应用 SDK 与文档路径,不是替代 Unity 云服务控制台配置或网络运维。包依赖、各工作流云侧前置条件见 workflows-prerequisites.md;若文档地图无法访问,应以工作区 Package Manager 中的实际包版本为准核对签名与选项默认值。
使用场景
- 新项目要决定主机托管、中继还是专用服务器,需要对照文档地图梳理拓扑与发现方式
- 已有 Netcode 工程,要把匹配、建房、加入流程迁到 IMultiplayerService 与 ISession 主 API
- 策划问「匹配和 Lobby 各管什么」,需要用 implementation-fit 规则写用户能看懂、且不误导产品边界的说明
- 主路径 API 不够用,且已核对 entrypoints,才考虑 Unity.Services.Lobbies 或 Relay 等底层客户端
适合人员
- 负责 Unity 联机原型的Gameplay 程序员,要在首版前定好 Sessions 主路径与 Netcode 分工
- 维护 UGS 多人服务的客户端工程师,需要按 entrypoints 查选项默认值、过滤枚举与错误处理
- 搭建 Linux 专用游戏服务器 build 的后端/工具链同学,要处理 UNITY_SERVER 与 IMultiplayerServerService
- 技术负责人评审联机方案,需要基于 implementation-fit 做拓扑与韧性维度的权衡说明