本页目录
国内区域代码是 cn,节点位于中国境内。AppID 需要先开通中国区权限,客户端要使用本地 NameServer,并为国内环境准备单独构建;否则代码看起来没错,却可能一直连不上或连到境外。
先在 Photon 侧解锁中国区 AppID,再谈客户端区域配置。
中国区客户端使用 ns.photonengine.cn;这是 NameServer 地址,不是游戏服务器 IP。
单独构建是光子对国内环境的要求;独立 AppID 是建议,便于隔离配置、白名单与计费。
截至 2026-11,Photon Voice 在中国区不可用;Realtime/PUN/Fusion/Quantum/Chat 可用性需按产品分别确认。
01一个 AppID,胜似几页代码
如果 AppID 还没有开通中国区,单纯把客户端区域设为 cn,通常不会自动连到国内节点。先在光子侧确认 AppID 的中国区权限,再准备独立构建会更省时间。解锁流程和处理时间以光子当前流程为准;我们的申请表单可以协助提交,但不是唯一入口。
单独构建必需,独立 AppID 建议
为国内环境制作单独构建是光子要求;独立 AppID 是光子建议,有助于隔离中国区缓存、白名单和计费。
02cn 区域与产品可用性
按 Realtime 文档,国内区域的代码为 cn,节点位于中国境内。Realtime、PUN、Fusion、Quantum 与 Chat 的中国区可用性需按产品确认;光子明确 Photon Voice 在中国区不可用。中国区公开 Cloud 订阅为 500 CCU,更大规模需定制。
03使用本地 NameServer
中国区客户端必须使用 ns.photonengine.cn 作为 NameServer。不要修改 SDK 源码里的 NameServerHost;在当前 Realtime C# 路径中,通过 AppSettings.ServerAddress 设置。
C# / AppSettings
verify against target SDK// Official docs: https://doc.photonengine.com/realtime/current/connection-and-authentication/regions
// China differences: https://vibrantlink.com/resources/realtime-china-region
// Quota & pricing: https://vibrantlink.com/pricing
var china = new AppSettings {
AppIdRealtime = "<中国区 AppID>",
AppVersion = "1.0",
UseNameServer = true,
ServerAddress = "ns.photonengine.cn",
FixedRegion = "cn" // 需要固定中国区时
};
client.ConnectUsingSettings(china);04Fixed Region、Best Region 与手动选择
FixedRegion 会跳过区域列表与 ping,连接更快,但区域被写进构建。Best Region 会 ping 区域并缓存结果,适合希望运营期调整的发行版本。手动选择时,应使用当前 SDK 的区域列表与 ConnectToRegionMaster 流程,而不是旧版已移除的 API。
- 固定中国区:FixedRegion = "cn",适合确定只服务国内用户的构建。
- 希望以后调整:使用 Best Region,并在 Dashboard 白名单中限制可用区域。
- Best Region 缓存可能在延迟接近时选到不同区域;调试时清空缓存再测。
- 区域代码大小写不敏感,规范写法使用小写 cn。
05Dashboard 区域白名单
在 Dashboard 的 Manage → Edit Allowlist 中,用分号分隔区域代码,例如只保留 cn。白名单变更通常需要少量时间到达 Name Server;Best Region 会按允许列表重新筛选。空值或错误格式可能意味着允许全部区域,发布前务必确认。
中国区缓存同步
当前中国区应用缓存不会自动同步所有 Dashboard 变更。修改白名单、配置或应用信息后,需要按当前光子流程请求更新,并在发布前用真实中国区客户端复核。
06上线验收
- 从国内网络连接,确认落到 cn 区域并完成房间流程。
- 验证客户端实际使用的 NameServer 为 ns.photonengine.cn。
- 检查白名单、FixedRegion 与缓存配置一致。
- 测试自定义认证、Webhook、WebRPC 等跨境回调。
- 确认峰值 CCU、流量与付费套餐匹配当期合同。
07中国区常见陷阱
- 海外客户端默认连中国区:通常延迟与稳定性不理想,应做区域分流。
- 境外认证/回调:中国区服务器访问境外服务可能失败,需提供境内替代。
- Dashboard 直接购买:中国区付费方案通常需要工单或商务报价。
- Voice:光子明确 Voice 中国区云不可用,不能沿用旧资料中的可用说法。
- 把 NameServer 地址当成游戏服务器 IP:它是入口,不是房间服务器。
Official sources
本文依据上述光子文档整理与翻译,仅供中文接入参考。若与光子英文文档、SDK 实际行为或双方合同不一致,以光子资料与合同为准。
旧地址 /chinacloudrealtime/ 会永久跳转到本页,原有链接仍可访问。
Need help?
把文档里的步骤,落到你的项目里。
中国区 AppID、区域、许可与部署问题,可以带着项目背景直接询问。 我们不会索要账号密码。
Related products