《Steam 游戏平台:开发与商业化》12.2 异步操作模式
SteamAPICall_t 句柄驱动异步:发起返回句柄,IsAPICallCompleted 查询完成态,GetAPICallResult 取结果,GetAPICallFailureReason 解释失败。本节讲句柄生命周期、失败分支与 CCallResult 自动交付的工程语义,lab 用 C++ mock 验证句柄/失败/CCallResult 生命周期。
category
SteamAPICall_t 句柄驱动异步:发起返回句柄,IsAPICallCompleted 查询完成态,GetAPICallResult 取结果,GetAPICallFailureReason 解释失败。本节讲句柄生命周期、失败分支与 CCallResult 自动交付的工程语义,lab 用 C++ mock 验证句柄/失败/CCallResult 生命周期。
Steamworks 的事件是回调驱动:按 callback id 注册监听,SteamAPI_RunCallbacks 泵出排队事件。本节讲回调注册/注销、FIFO 派发、客户端与游戏服务器两套队列、手动分发模式的工程语义,lab 用 C++ mock 验证注册、派发与队列分离。
测试要出数据结论:会话事件的漏斗聚合、次日留存、崩溃率与全局聚合统计(RequestGlobalStats/GetGlobalStat)。本节讲测试数据模型与发布就绪判定的工程语义,lab 用 C++ mock 验证漏斗、留存与就绪门禁。
Demo、免费周末、限时试玩是三种不同的所有权状态,BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial 分别回答「有没有」「靠什么」「还剩多少」。本节讲所有权状态机与启动门控的工程语义,lab 用 C++ mock 验证状态机与门控。
Playtest 是邀请驱动的限定访问:GetLaunchQueryParam 解析 steam://run 的查询参数,邀请清单决定谁能进入 playtest 分支。本节讲启动参数解析、保留前缀与邀请门控的工程语义,lab 用 C++ mock 验证参数解析与访问门控。
webhook 是外部服务,会超时、会挂。准入链对 webhook 故障的策略由 failurePolicy 决定:Ignore 是故障不阻塞(请求继续),Fail 是故障拒绝请求。两者各有一份代价。webhook 还必须幂等——被反复调用不能产生重复效果(如 sidecar 注入只注入一次)。本节解剖 failurePolicy 的权衡与 webhook 幂等的必要性。lab 用 admission/admission.go 验证两种策略与幂等注解。
灰度发布是分支体系的产品用法:候选 build 先在受限分支小比例放量,以成功率为门禁推进或回滚。本节讲灰度放量、按用户分配 build、推进/回滚门禁与分支独立推进的工程语义,lab 用 C++ mock 验证放量分配与门禁判定。
分发管道是 SteamPipe 客户端(后台构建上传工具)的职责,产出清单-分块-完整性校验-发布推进 buildid 的闭环。本节讲清单以 depot 归属、大文件分块、变更检测与 buildid 推进的工程语义,lab 用 C++ mock 验证清单校验与变更检测逻辑。
内容以 depot 为单位归属,分支指向某个 buildid,GetCurrentBetaName/GetNumBetas/GetBetaInfo/SetActiveBeta 描述客户端可见分支状态。本节讲 depot 归属、分支指向与切换分支需要重启的内容语义,lab 用 C++ mock 验证 depot/分支所有权与切换边界。
服务器侧的数据落盘靠 ISteamGameServerStats 的 RequestUserStats/SetUserStat/StoreUserStats,官方服务器写权限门由后台声明 IP 范围控制。本节讲服务器统计读写循环、容量声明与商业模型的关系,lab 用 C++ mock 验证官方权限门与落盘一致性。
VAC 的状态从哪来:EAuthSessionResponse 的 VACBanned 分支、ISteamApps::BIsVACBanned 客户端查询、GSPolicyResponse_t 的 secure 标记。本节讲封禁在接入工程中的可观测点与边界(按游戏隔离、与自研封禁分工),lab 用 C++ mock 验证封禁判定与 secure 标记。
写请求进入 apiserver 后、落盘 etcd 前,要经过准入链(Admission Chain):Mutating webhook 先改对象(加默认值、注入 sidecar),Validating webhook 后校验(拒绝非法请求)。任一 validating 拒绝则整体拒绝,apiserver 不会执行后续步骤。本节解剖准入链的位置、顺序与拒绝语义。lab 用 admission/admission.go 验证 mutating 先于 validating、拒绝即整体拒绝。
游戏服务器接入的入口是 SteamGameServer_InitEx 与 EServerMode 安全模式,登录走 ISteamGameServer::LogOn/LogOnAnonymous,BLoggedOn/BSecure 是运行态门控。本节讲专用服务器登录生命周期与属性可变性边界,lab 用 C++ mock 服务器初始化状态机与连接/失败回调。
网络可靠性落在发送标志与消息上限上:可靠消息带单调消息号、经重传恰好一次按序投递,不可靠可能丢失,单消息上限 512KiB(k_cbMaxSteamNetworkingSocketsMessageSizeSend),连接断开后发送返回 NoConnection。本节讲可靠性的接口工程语义,lab 用 C++ mock 复现重传、丢包与消息号延续。
P2P 消息接入选 ISteamNetworkingMessages:SendMessageToUser 隐式建会话并触发 SessionRequest、ReceiveMessagesOnChannel 按频道取消息、可靠消息恰好一次按序、不可靠可能丢失、CloseSessionWithUser 结束会话。本节讲会话与消息的接口语义,lab 用 C++ mock 复现双对端收发、频道路由与丢包。
Steam 网络层以连接状态机为主线:CreateListenSocketP2P 绑定端口、ConnectP2P 进入 Connecting、AcceptConnection 转 Connected、CloseConnection 使对端观察 ClosedByPeer。本节讲 ISteamNetworkingSockets 状态机与两个接口家族(Sockets/Messages)的分工,lab 用 C++ mock 复现连接生命周期与对端状态观察。
创意工坊的商业侧是统计、时长、投票、收藏四组接口:GetQueryUGCStatistic 读订阅与唯一订阅统计、Start/StopPlaytimeTracking 归集游玩时长、SetUserItemVote 投票、AddItemToFavorites 收藏。本节讲这些接口的工程语义与长尾识别等商业分析(阈值模型假设),lab 用 C++ mock 复现统计归集与榜单排序。
CronJob 在 Job 之上加了一层『按 cron 表达式定时创建 Job』。定时系统最麻烦的两个问题是漏执行与重叠:控制面停机时错过的调度点怎么补、上一个还没跑完时下一个该不该开。本节解剖 CronJob 的调度语义、Forbid/Allow/Replace 三种并发策略、以及错过执行的补偿。lab 用 controller/job.go 的 CronJob 验证 Forbid 重叠策略。
创意工坊的消费侧是查询、订阅、下载三段管道:CreateQueryAllUGCRequest/SendQueryUGCRequest 拿查询结果、SubscribeItem 订阅、DownloadItem 触发下载、GetItemInstallInfo/GetItemDownloadInfo 读安装与进度。本节讲 UGC 内容管道的接口语义,lab 用 C++ mock 复现查询句柄生命周期与订阅下载状态迁移。
创意工坊条目的生命周期是「创建 → 更新 → 提交」三步:CreateItem 拿版本号、StartItemUpdate 开一次更新、SubmitItemUpdate 上传并进入 EItemUpdateStatus 状态机。消费者侧由 EItemState 位标志描述订阅与安装。本节讲创意工坊机制接口语义,lab 用 C++ mock 复现条目生命周期与状态迁移。