本页目录
截至 2026-11,PUN 2 处于维护 / LTS 模式:现有项目可以继续运行,但不再规划新功能。下面的配置只面向维护中的 PUN 2 中国区 Unity 项目,不适用于 PUN 1/Classic 的旧做法。
为中国区准备 Realtime AppID,并先完成中国区解锁。
中国区客户端需要 ns.photonengine.cn;Use Name Server 保持开启。
Fixed Region = cn 固定中国区;留空则使用 Best Region。
Dev Region 仅对 Editor / Development Build 有意义,发布构建不要依赖它。
01PUN 2 的当前状态
光子将 PUN 2 置于 maintenance / LTS 模式。已有项目继续使用是合理的,但新项目应先评估 Fusion 或 Quantum。不要把 PUN 2 的新功能宣传建立在光子已停止投入的前提上。
02创建并解锁中国区 AppID
- 在 Dashboard 创建 Realtime AppID。
- 为国内项目申请解锁,并准备单独的构建。
- 建议使用独立 AppID,便于隔离中国区缓存与白名单。
- 不要把 PUN 1 的 CloudRegionCode.cn / CloudRegionFlag 作为当前配置方式。
03PhotonServerSettings 关键字段
| 字段 | 建议值 | 说明 |
|---|---|---|
| AppId Realtime | 中国区 AppID | Chat / Voice 另需各自 AppID |
| App Version | 固定版本号 | 参与匹配隔离 |
| Use Name Server | 开启 | 云端连接必须使用 NameServer |
| Fixed Region | cn 或留空 | 填写后固定中国区;留空则自动选择最佳区域 |
| Dev Region | 仅调试时设置 | 只在 Editor / Development Build 生效 |
| Server | ns.photonengine.cn | 本地 NameServer,不是游戏服务器 |
| Port | 0 | Photon Cloud 自动选择 |
Inspector 字段名可能随 PUN 版本变化;以目标版本的界面与光子文档为准。
04连接与运行时配置
C# / PhotonServerSettings
verify against target SDK// Official docs: https://doc.photonengine.com/pun/current/connection-and-authentication/regions
// China differences: https://vibrantlink.com/resources/pun-china-region
// Quota & pricing: https://vibrantlink.com/pricing
// 通常直接在 Inspector 配置后调用
PhotonNetwork.ConnectUsingSettings();
// 需要运行时修改时,先取得 AppSettings
var settings = PhotonNetwork.PhotonServerSettings.AppSettings;
settings.AppIdRealtime = "<中国区 AppID>";
settings.FixedRegion = "cn";
settings.UseNameServer = true;
settings.Server = "ns.photonengine.cn";
PhotonNetwork.ConnectUsingSettings();Fixed Region 和 Dev Region 的优先级在不同 PUN 版本中可能不同,光子文档没有给出统一保证。发布前需要在目标版本实测;编辑器里的表现只能作为参考。
05Best Region 与缓存
如果希望保留运营期调整能力,可以清空 Fixed Region,并用 Dashboard 白名单约束可用区域。Best Region 会缓存上一次结果;延迟接近时,选择可能不同。调试时可清空缓存:
C# / 清空 Best Region 缓存
verify against target SDKPhotonNetwork.BestRegionSummaryInPreferences = null;06验收清单
- 确认 AppID 已解锁中国区,构建使用独立 AppID 或至少独立配置。
- 确认实际连接使用 ns.photonengine.cn 与 cn 区域。
- 用 Editor + Development Build + 正式构建分别测试。
- 检查 Dashboard 白名单与缓存是否同步。
- 验证自定义认证、Webhook 与 WebRPC 是否依赖境外服务。
07中国区注意事项
容量与语音
中国区公开 Cloud 套餐为 500 CCU,更大规模需商务定制;付费方案通常不能在 Dashboard 直接购买。Photon Voice 中国区云不可用,语音项目需要评估 Photon Server 自建。
Official sources
本文依据上述光子文档整理与翻译,仅供中文接入参考。若与光子英文文档、SDK 实际行为或双方合同不一致,以光子资料与合同为准。
旧地址 /chinacloudpun/ 会永久跳转到本页,原有链接仍可访问。
Need help?
把文档里的步骤,落到你的项目里。
中国区 AppID、区域、许可与部署问题,可以带着项目背景直接询问。 我们不会索要账号密码。
Related products