跳到主要内容
VibrantLink 动联无限
中国区中文指南

在 PUN 中设置中国区域:固定区域、NameServer 与开发区域

在 Unity PUN 2 中配置中国区:PhotonServerSettings、Fixed Region cn、Use Name Server、ns.photonengine.cn,以及 Dev Region 与 Best Region 的取舍。

SDK 用法、API 参考、代码示例、区域表与平台支持矩阵以光子官方文档为准;本站只维护中国区可用性、额度、价格与合同口径、上线合规和支持渠道。

阅读约 7 分钟更新于 2026 年 11 月 15 日光子原文
本页目录
  1. 01 · PUN 2 的当前状态
  2. 02 · 创建并解锁中国区 AppID
  3. 03 · PhotonServerSettings 关键字段
  4. 04 · 连接与运行时配置
  5. 05 · Best Region 与缓存
  6. 06 · 验收清单
  7. 07 · 中国区注意事项

截至 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

  1. 在 Dashboard 创建 Realtime AppID。
  2. 为国内项目申请解锁,并准备单独的构建。
  3. 建议使用独立 AppID,便于隔离中国区缓存与白名单。
  4. 不要把 PUN 1 的 CloudRegionCode.cn / CloudRegionFlag 作为当前配置方式。

03PhotonServerSettings 关键字段

PUN 2 中国区关键设置
字段建议值说明
AppId Realtime中国区 AppIDChat / Voice 另需各自 AppID
App Version固定版本号参与匹配隔离
Use Name Server开启云端连接必须使用 NameServer
Fixed Regioncn 或留空填写后固定中国区;留空则自动选择最佳区域
Dev Region仅调试时设置只在 Editor / Development Build 生效
Serverns.photonengine.cn本地 NameServer,不是游戏服务器
Port0Photon 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 SDK
PhotonNetwork.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、区域、许可与部署问题,可以带着项目背景直接询问。 我们不会索要账号密码。