本页尚未翻译,当前显示英文版本。
架构
PlayServ 是与你的游戏对话的后端,由我们代为运行。 游戏通过 SDK 连接;如果你有 Game server,它们负责注册自己的 Room;团队在 Backoffice 中配置一切,并用 CLI 发布代码。每个 Project 划分为多个 Environment,调用方使用的 key 决定它访问哪个 Project 的哪个 Environment。
组成部分
| 组成部分 | 说明 |
|---|---|
| 你的游戏 | 集成了 PlayServ SDK 的 Unity 项目。它负责让 Player 登录、读写数据、接收实时更新和 Event,以及调用 Function。 |
| 你的 Game server | 可选的专用服务器。它们注册 Player 要加入的 Room,并使用 server key 与平台通信。参见 Game server 托管。 |
| Backoffice | Web 控制台,团队在这里管理 Project、key、Player、Schema 和数据、Function、服务器以及 Room。 |
| CLI | playserv 命令行工具,用于部署 Function 和 Game server。参见 命令行工具。 |
| Player | Player 账号、登录提供方和 Session。参见 管理 Player。 |
| 数据 | 你的 Schema 及其 Record,变更会实时推送到游戏。参见 构建游戏 Schema。 |
| Cloud Function | 由平台运行的服务端代码。参见 Function。 |
| 游戏 Room | 由你的 Game server 运行的 Room,以及其中的 Player。参见 游戏 Room。 |
游戏如何连接
游戏与 PlayServ 之间保持一条实时连接。 PlayServ.Connect() 让 Player 登录并打开这条连接;SDK 负责保持连接,断线后自动重连。
| 通道 | 传输的内容 |
|---|---|
| 实时连接 | 数据的实时更新、来自服务器的 Event、RPC 调用。 |
| 独立请求 | 大部分 Record 读写、调用 Cloud Function、登录。 |
你不需要在两者之间做选择:SDK 会为每次调用选择合适的通道。连接的状态、重连和 Session 处理见 连接与 Session。
Key、Environment 与 Player
| 术语 | 说明 |
|---|---|
| Project | 一款游戏的后端。参见 创建 Project。 |
| Environment | Project 的数据、Function 和 Player 的一份独立副本,例如 dev 和 prod。参见 Environment。 |
Client key(pk_…) | 内置在游戏中,决定游戏访问哪个 Project 的哪个 Environment。可以安全地随游戏发布。 |
Server key(sk_…) | 供你的服务器、工具和 CI 使用。切勿打包进游戏 build。参见 API key 管理。 |
| Player | 每个连接上来的游戏都以 Player 身份登录,一开始是匿名的。Player 来自其 Session,而不是某项设置。参见 用户登录。 |
一个 key,一个 Environment
使用 dev client key 构建的游戏永远连接 dev。发布时,请使用 Player 应当访问的那个 Environment 的 key 来构建。
SDK 模块
SDK 是一个包 com.playserv.sdk,按领域划分为多个模块,另有若干可选的配套包。
| 模块 | 作用 | 指南 |
|---|---|---|
PlayServ | 连接、配置和断开连接。 | 连接与 Session |
PlayServAuth | 让 Player 登录、关联登录提供方、结束 Session。 | 用户登录 |
PlayServData | 读取、写入和订阅 Record。 | 读取 Record |
PlayServCode | 调用 Cloud Function。 | Function |
PlayServEvents · PlayServRpc | 接收来自服务器的 Event;调用 RPC。 | 服务器 Event |
PlayServMatchmaking | 浏览和加入游戏 Room。 | 浏览、托管与加入 Room |
配套包提供登录提供方、专用 Game server 及其他可选功能,从 Tools ▸ PlayServ ▸ Settings 安装,参见 连接你的游戏。
后续步骤
- 连接你的游戏 —— 安装 SDK 并连接
- 创建新 Project —— Project 及其第一个 Environment
- 连接与 Session —— 游戏连接期间会发生什么
更新于 2026年10月19日