PlayServ SDK 架构与组件

Session 是客户端所处的运行时上下文。它保存当前状态 —— Offline、Recovering、Active 或 Banned —— 并驱动客户端在重连与正常运行之间的转移。SDK 中其余的一切都以存在一个 Session 为前提。想了解客户端如何在这些状态之间移动、每个状态对你的游戏意味着什么，请读 Session Lifecycle & States。

授权代表当前 Session 的权限级别。未认证的 Session 从最低权限开始。传入 UserToken 会提升它，把 Session 绑定到某个用户档案，并解锁受保护的操作。何时以及如何传这个 token，见 User Login & Authentication。

SDK 配置保存着让运行时识别出正确 Project 和 Environment 的凭据与设置。如果你还没配置好 Project 凭据，SDK Initialisation & Handshake 会逐项讲清楚每个输入是什么、从哪里来，以及如何在 Unity 中配置。

Group 负责组织客户端连接，支持广播式通信和在线状态跟踪。Group 位于基础层之上，借助基础层完成信令和服务端行为 —— 包括可扩展的加入和离开流程。如何创建、加入 Group，以及如何用自定义的服务端规则扩展它，见 Groups。

Model 是操作游戏数据的入口，它把客户端代码接到查询、过滤、修改和订阅上。Query 负责构造和过滤数据请求。Schema 定义数据结构以及对象之间的关系 —— 正是它让嵌套读取和关系的自动展开成为可能。完整的查询语法见 Query Language & Data Retrieval。

PubSub 是驱动实时更新的订阅机制。服务端数据一旦变化，Delta 会立即送达已订阅的客户端。第一次送达的是完整快照，之后的更新是自动应用的 JSONPatch Delta。如果你想在本地保有一份与服务端同步的数据副本、又不想轮询，Data Subscriptions & Live Updates 讲了怎么做。

Entity 提供以实体为中心的数据与行为视角。它位于数据访问和命令之间，正是它让你可以把领域行为 —— 比如 player.Shoot() —— 作为具名的 RPC 方法挂到某个 Model 类型上。如何持久化字段改动、如何用自定义方法扩展 Model，见 Data Mutation & Model Extending。

Command 是执行服务端具名操作的机制。服务端代码写在客户端代码库里，由代码分析器发现，并部署到服务端运行时。客户端代码通过 PlayServ.Remote(...) 调用它。完整的执行模型见 RPC & Server-side Game Logic。

Event 是两端共享的强类型信令机制。Event 用 [Event] 声明，通过 Send(...) 或生成的语法糖发送，通过 Wait<T>(...) 接收。借助自动生成的 Event 描述类，客户端和服务端拿到的是同一份契约。完整 API 见 Events System。

State 是运行时各项功能底下的状态层。Session 的状态转移 —— Offline → Recovering → Active —— 是它最显眼的用途，但它同样支撑着 SDK 的其他组件。这些状态以及订阅它们的方式，见 Session Lifecycle & States。