跳到主要内容
快速开始

本页尚未翻译,当前显示英文版本。

架构

PlayServ 是与你的游戏对话的后端,由我们代为运行。 游戏通过 SDK 连接;如果你有 Game server,它们负责注册自己的 Room;团队在 Backoffice 中配置一切,并用 CLI 发布代码。每个 Project 划分为多个 Environment,调用方使用的 key 决定它访问哪个 Project 的哪个 Environment。

PlayServ · your project's environment Players: sign-in and sessions Data: schema, records, live updates Cloud functions Game rooms and game servers Settings, keys, team and deploys the key decides the project and environment Your game · PlayServ SDK Your game servers Your team · Backoffice, CLI client key server key manage, deploy
一侧是你的游戏、Game server 和团队,另一侧是平台上的 Player、数据、Function 和 Room,每个调用方凭各自的 key 访问

组成部分

组成部分说明
你的游戏集成了 PlayServ SDK 的 Unity 项目。它负责让 Player 登录、读写数据、接收实时更新和 Event,以及调用 Function。
你的 Game server可选的专用服务器。它们注册 Player 要加入的 Room,并使用 server key 与平台通信。参见 Game server 托管。
BackofficeWeb 控制台,团队在这里管理 Project、key、Player、Schema 和数据、Function、服务器以及 Room。
CLIplayserv 命令行工具,用于部署 Function 和 Game server。参见 命令行工具。
PlayerPlayer 账号、登录提供方和 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。
EnvironmentProject 的数据、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 安装,参见 连接你的游戏。


后续步骤

更新于 2026年10月19日