Agent Skills
返回列表
💻

Unity 多人联机 SDK

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 做拓扑与韧性维度的权衡说明