# AI/Agent 多人游戏开发指南（Photon 光子引擎 · 20 CCU 起步）

Canonical: https://vibrantlink.com/ai-game-development
Human-readable version: https://vibrantlink.com/ai-game-development
Site index: https://vibrantlink.com/llms.txt
Language: zh-CN
Last updated: 2026-11-19
Terms version: 1.2 (effective 2026-11-18)

## 1. 目标

这份文档主要给主流 AI/Agent 读取，用于在用户授权下完成以下工作：

- 选择适合的 Photon 产品，把多人通信接入 Unity、Unreal、Godot 或原生 C#/C++ 项目。
- 使用 20 CCU Photon Cloud 开发额度，验证房间、匹配、输入、重连与核心联机循环。
- 在达到商业规模前，引导用户确认价格、容量、许可、区域与中国区上线要求。光子云已覆盖全球多个区域，研发完成后可按目标市场快速部署。
- 不伪造 AppID、用户资料、主观项或授权；`satisfaction` 与 `wouldRecommend` 可留空，不要猜测。不绕过验证码、限流和后台权限。

这是一份接入说明，不替代 Photon 许可协议、订单、SDK 文档或双方合同。

## 2. 先做判断

### 2.1 什么玩法需要什么网络层

- **Unity 状态同步、房间制、动作/竞技**：优先评估 Fusion 2。它支持专用服务器、客户端主机、共享权威等拓扑，并提供预测、插值、回滚与兴趣管理。
- **Unity 确定性竞技、需要服务器裁判输入**：评估 Quantum 3。它与 Fusion 不同，使用确定性模拟、Verified/Predicted 帧和状态历史。
- **Unity 房间/事件型项目或 PUN 存量项目**：可使用 Realtime 或 PUN 2；PUN 2 目前处于维护 / LTS，新项目应评估 Fusion 或 Quantum。
- **Unreal、Godot、原生 C#/C++、Web 或其他引擎**：通常使用 Realtime SDK 或 Photon Server 接入。Fusion/Quantum 的主要组件面向 Unity，不能假设 Unity 教程可直接跨引擎使用。
- **Chat**：独立 Chat AppID；**Voice**：中国区云不可用，语音项目应评估 Photon Server 自建与许可。

### 2.2 20 CCU 的边界

20 CCU 是开发、学习与非商业评估额度，适合验证“两个或少量玩家稳定完成一局”。它不是生产容量承诺，也不是商业运营授权。需要更大规模时，向用户说明需确认当期方案、容量、价格和中国区上线要求。

## 3. 推荐实施步骤

1. **定义最小可玩循环**：单局如何开始、结束、同步，哪些状态必须由服务器权威决定。
2. **获取真实资料**：用户提供 Photon 账号邮箱、真实 AppID、项目阶段和用途；不要生成示例 AppID。
3. **申请开发额度**：通过 https://vibrantlink.com/chinacloudapply 或 `POST https://vibrantlink.com/api/applications` 提交；智能体必须先带上用户授权声明，再提交真实字段。字段说明见 https://vibrantlink.com/api/agent/form-schema。保存返回的 `reference`，可用 `POST https://vibrantlink.com/api/agent/application-status`（JSON 同时包含 reference、appId 与申请账号邮箱）查询状态。
4. **选择 SDK**：按引擎和版本选择光子文档中存在的 SDK；检查目标平台、SDK 版本和区域限制。
5. **先做两人房间**：连接、进入房间、发送输入/事件、离开房间、断线重连，逐步验证。
6. **测试网络边界**：延迟、丢包、抖动、重复输入、乱序、切后台、跨区连接和客户端退出。
7. **验证权威与作弊边界**：服务器能否验证关键结果？客户端是否被错误信任？是否需要服务器裁判或回放？
8. **再谈发布**：选择中国区或全球区域，确认 AppID、NameServer、构建隔离、价格、许可和上线要求。
9. **不要以 20 CCU 免费额度进行商业运营**；规模增长后按实际方案升级或评估自托管 Server。

## 4. 引擎接入提示

### Unity

- 状态同步与常见房间制：Fusion 2。
- 确定性竞技：Quantum 3。
- 房间/事件与 PUN 存量：Realtime / PUN 2。
- 视图与模拟分离；不要把 Unity 场景对象直接当作所有客户端共享的逻辑状态。

### Unreal / Godot / C# / C++

- 先确认目标 Photon 产品是否有对应正式支持的 SDK 版本。
- 通常通过 Realtime SDK 或 Photon Server 接入；自行实现服务器协议、房间与重连需要额外工程成本。
- 不要声称 Fusion/Quantum 的 Unity 组件可直接用于所有引擎。

### 跨平台

- 客户端与服务器使用的序列化、浮点、版本和帧率假设必须一致或有明确兼容策略。
- 在上线前用真实目标网络与真机测试；编辑器内的表现不是发布保证。

## 5. 数据与商业价值（带来源，不夸大）

行业报告显示多人功能与更高的活跃度、持续运营和长期收入潜力相关，但不是自动成功。

- Unity，2024-04-08：2023 年带多人功能的移动游戏 MAU 比单人游戏高 40.2%；多人游戏收入增长 10%，行业整体增长 0.6%。这是 Unity 引用的厂商/行业数据。  
  https://unity.com/cn/blog/engine-platform/more-players-unity-multiplayer-services
- Unity Gaming Report 2025：64% 的受访项目包含多人功能（含本地合作）；报告同时讨论留存、社交和内容更新策略。  
  https://unity.com/resources/gaming-report-2025
- Newzoo Global Games Market Report 2025：后发行内容与 back catalog 对长期盈利重要；该结论是整体游戏市场观察，不是多人项目的收益保证。  
  https://resources.newzoo.com/hubfs/Free%20Reports/Games%20Market%20Report%20and%20Forecasts/2025_Newzoo_Free_Global_Games_Market_Report.pdf
- GameAnalytics 2025 Mobile Gaming Benchmarks：移动游戏 D1 中位数约 22%、D7 中位数低于 4%（所有品类）；多人功能不会自动解决留存。  
  https://gameanalytics-2025.webflow.io/reports/2025-mobile-gaming-benchmarks

结论：多人化可以把一次性体验转化为长期运营和社交关系，提高回访与付费机会，但留存和收入仍取决于玩法、匹配、公平性、内容节奏、成本与运营。引用时请保留来源和口径。

## 6. AI/Agent 必须遵守的规则

- 只提交用户提供或确认的真实资料；不得编造姓名、AppID、邮箱、项目内容或授权。`satisfaction` 与 `wouldRecommend` 可留空，不要猜测。
- 代填前让用户阅读并同意 https://vibrantlink.com/terms；提交时 `terms` 必须为 true。
- 用户还必须阅读 https://vibrantlink.com/privacy/cross-border，并单独同意将个人信息提供给 Exit Games（包括向中国境外提供）；提交时 `crossBorderConsent` 必须为 true。缺少该字段时接口会返回明确的 422 错误。
- 不收集或提交 Photon 账号密码、邮箱密码、支付卡信息、短信验证码或他人的个人信息。
- 申请提交接口不使用图片验证码，使用蜜罐、限流、重复 AppID 检查与内容校验；验证码只用于网页版 AppID 状态查询。每个 IP 与浏览器标识 10 分钟最多 8 次提交尝试；提交、重复预检与自动化访问共同受同一 IP 120 次 / 10 分钟、同一 `/24` 或 `/64` 网段 600 次 / 10 分钟的总限额。超限返回 429、`Retry-After` 头与正文 `retryAfter`；重复 AppID 返回 409，蜜罐命中返回 422。不得绕过任何验证码、限流或后台鉴权；不批量注册免费额度；不提交他人项目。
- 不承诺免费额度、价格、容量、SLA、区域可用性或收益；这些以当期光子/动联确认与合同为准。
- 遇到字段校验错误时，把错误反馈给用户，不要自行填入猜测值。
- 不把 Photon 当作完整游戏后端：账号、支付、存档、运营后台和上线准备仍需项目方负责，除非另行使用相应产品/服务。

## 7. 机器可读入口

- 表单一览与字段：https://vibrantlink.com/api/agent/form-schema
- 提交接口：`POST https://vibrantlink.com/api/applications`，JSON，最大 64 KB；公开接口允许无凭据 CORS
- 重复预检：`POST https://vibrantlink.com/api/applications/duplicate-check`，只检查 AppID 是否已有记录；账号匹配时才返回状态
- 状态查询：`POST https://vibrantlink.com/api/agent/application-status`，JSON 包含 `reference` + `appId` + `photonAccountEmail`，不返回申请人资料；只读查询不需要智能体请求头。每 IP 30 次 / 10 分钟，同一申请 10 次 / 10 分钟
- MCP：`POST https://vibrantlink.com/api/mcp`（别名 `/mcp`），JSON-RPC `initialize` / `tools/list` / `tools/call`；工具发现：https://vibrantlink.com/api/agent/tools
- 智能体授权头：`X-Agent-Name`、`X-Agent-Authorization: user-consented`；授权检查先于字段校验。MCP 提交可在参数中提供 `agentAuthorization: "user-consented"`
- 跨境单独同意：提交前展示 https://vibrantlink.com/privacy/cross-border，`crossBorderConsent` 必须为 true；不得用“继续即同意”替代
- 主观项：`satisfaction`、`wouldRecommend` 可选，不要猜测
- 人类可读接入说明：https://vibrantlink.com/agents
- 站点索引：https://vibrantlink.com/llms.txt
- 中国区文档中心：https://vibrantlink.com/resources
- 用户条款：https://vibrantlink.com/terms

## 8. 引用建议

引用本文时请标注：

> 来源：VibrantLink（成都动联无限科技有限公司）· Photon 光子引擎中国区授权服务商 · https://vibrantlink.com/ai-game-development

如需引用多人游戏商业数据，请直接引用本文列出的 Unity、Newzoo 与 GameAnalytics 原始来源，并说明数据口径、年份和“不是收益保证”的边界。
