跳转到内容

Apollo 概念与命名 ​

名称按职责固定:gateway、loginServer、baseServer、worldServer、database、machined,以及 worldServer 管理的 cell 执行进程。空间和实体语义尽量复用 BigWorld。完整的上游含义、Apollo 对应、代码类型与缺口见BigWorld 与 Apollo 对照。

进程与执行边界 ​

Apollo 名称对照职责所有权
gateway独立连接层,承担部分 Proxy/会话相关职责客户端 socket 与投递,缓存 Base 和模拟目标路由。
loginServerLoginApp 加 Apollo 的服务/在线目录职责认证、Base/World 服务寻址、玩家归属与位置投影。
baseServerBaseApp 的长期非空间逻辑base::Avatar 等长期对象、基础业务、结算校验。
worldServerCellAppMgr 的空间/执行进程管理职责cell 注册、就绪、负载、Space/Cell 分配与拓扑、迁移和排空。
cell 执行进程CellApp本地 Cell 的实体、AOI、战斗、脚本和 tick,向各所属 Base 提交业务结果。
databaseDBApp 的存储访问职责资料加载、保存、存储路由、持久结果;不制定业务奖励。
machined本机监督职责拉起、停止、死亡检测和重启,不裁决跨服或玩家归属。

cell 自注册到所属 worldServer;独立部署不要求同机 machined。worldServer 是拓扑权威,loginServer 的位置投影与 gateway 缓存随版本刷新,不重复裁决分区所有权。

空间与玩法边界 ​

概念Apollo 含义
地图资源静态几何/配置;现有 SceneDescriptor 引用它,不表示一次运行空间。
Space一份有独立 ID 和坐标的运行空间,对应现有 Scene 的空间语义;两者不叠加为同义容器。现有 Scene 是单进程实现映射。
CellSpace 的空间分区,记录范围与权威实体,分配到执行进程;不等于 cell 进程。
InstanceApollo 的临时玩法生命周期,管理小队、目标、计时、结算和回收;关联 Space,不冒称 BigWorld 原生八态类型。
Base 实体baseServer 的长期非空间对象,玩家侧现有代码为 base::Avatar。
Cell/Real 实体cell 进程中拥有模拟写权的实体,玩家侧复用 cell::Avatar。
Ghost邻接分区的非权威投影,设计预留;不执行独立业务写入。
Witness面向客户端的可见世界上下文;现有 ViewerState、SceneAoi 与属性同步只承担部分职责。

默认一个 cell 执行进程,每个 Space 一个 Cell;同一进程可以承载多个 Space 的 Cell。扩展先分配完整 Space 到多个执行进程,未来允许一个 Space 多 Cell。Space 身份和坐标不因执行进程或分区变化而改变。

角色实体与 Avatar ​

Avatar 在 BigWorld 词汇中可包含玩家和 NPC;BigWorld/KBEngine 的角色实体可按需有 Base、Cell、客户端部分。Apollo 的玩家角色由 base::Avatar(Base 部分)与 cell::Avatar(Cell 模拟部分)两个实现类共同表达,命名是 Apollo 的实现约定,不是上游通用术语,也不表示固定 Base 进程。文档使用 Base/Cell 部分描述职责,代码引用保持真实名称;行业原文与命名判断见玩家对象模型。

数据归属与生命周期 ​

长期资料只由所属 Base 校验修改并经 database 保存;模拟实体只由一个权威 Cell 推进。跨服、跨 Space、跨 Cell 的模拟迁移不改变长期资料和原存储归属;Base 承载进程可按负载或更新独立迁移,玩家到当前 Base 的目录记录和写权代次必须同步交接。Instance 销毁只释放临时玩法和空间资源,不销毁长期资料。

小队请求 → Base 校验 → worldServer 分配 → cell 创建关联 Space/Cell 与玩法 → 成员运行 → 各所属 Base/database 持久确认结算 → 离开并回收。复用既有 Create → Initialize → Waiting → Running → Finishing → Rewarding → Draining → Destroyed。

迁移、更新与无缝预留 ​

跨 Space 换场与同 Space 跨 Cell 连续交接分别定义;后者保持实体 ID、位置、血量、技能和必要脚本状态,不触发一次完整离场重置。共享玩法有唯一逻辑负责人,不能把整个多 Cell 空间锁定在一个进程内对象或线程。

协议更新分别处理 Base、worldServer 管理状态和 cell 模拟状态的进程替换;仅代码更新保持 wire 契约不变,可使用 Lua 模块发布。当前不启用无缝地图,预留空间分区、邻接可见性、Real/Ghost、权威交接和跨 Cell 交互边界。实现和验收只维护在根目录 todo.md。

源码抽象层词汇表 ​

下表记录 2026-11-08 源码通读得到的抽象层。行号定位当前 HEAD;进程含义保留上文既有 BigWorld 词汇。

术语英文定义证据
进程壳Process shell进程入口、信号、崩溃捕获、参数解析与应用门控;是静态装配层和运行实例之间的边界。apps/CMakeLists.txt:34、apps/gateway/src/main.cpp:9
应用装配Application assembly把配置、连接、状态表、后台泵和服务器线程绑定成一个可启停的应用实例。apps/gateway/include/gateway/gateway_server.hpp:200、apps/world/include/world_app/world_app.hpp:120
服务器生命周期Server lifecyclePreInit 到 Ready 的组件初始化、启动、主循环、停止与统计采集。include/apollo/server/game_server.h:146、src/apollo/server/game_server.cpp:205
会话边界Session edge客户端连接认证、状态机、心跳、限流、准入、缓存与收发缓冲。include/apollo/net/session.h:86、apps/gateway/include/gateway/session_manager.hpp:59
内部链路Internal M1 link服务间 intent/rpc 的收发端点、路由表装载、重连与代次回执。modules/net/link/include/apollo/net/link/route_json.hpp:1、apps/gateway/src/m1_egress.cpp:70
IPC 通道IPC channel同机或跨主机的共享内存/Socket 传输、QoS、背压与异步 I/O。include/apollo/ipc/channel.h:20、src/apollo/ipc/async_io.cpp:23
服务发现Service discovery端点注册、健康心跳、订阅、负载均衡与本地缓存。include/apollo/core/service_discovery.h:133、src/apollo/ipc/sqlite_service_discovery.cpp:137
契约面Contract surfaceXML/XSD 定义的属性、消息、实体和错误,经生成器输出 C++、Lua、Proto 与路由表。sdks/contract/apollo.xsd:1、sdks/gen/src/main.cpp:105
游戏域Game domain属性、匹配、排行、计时、AOI、Scene 与 cell 执行等玩法内核。include/apollo/game/attributes/attribute.hpp:70、apps/world/include/world_app/cell_app.hpp:124
数据归属Data ownership长期资料的缓存、journal、原子落盘、迁移与数据库 RPC 面。apps/common/include/player_store/storage.hpp:11、apps/common/src/database_service.cpp:98
观测运维Operations observability日志汇聚、指标快照、告警、看板、本机监督与进程编排。apps/logger/include/logger/archive_writer.hpp:28、apps/admin/include/admin/metrics_hub.hpp:39
客户端 SDKClient SDKUnity/Cocos/Laya 连接、认证、编解码、路由与属性同步入口。skds/unity/ApolloSDK/ApolloClient.cs:1、skds/cocos/ApolloSDK/ApolloClient.ts:1

基于 MIT 许可发布