15.3 与卷二工程衔接
卷一(本书)讲的是机制位:平台机制如何决定设计、定价与商业模型。卷二将进入工程位:用 Steamworks SDK 把这些机制落成可运行的代码。本节做两卷之间的转接——把「机制需求」翻译成「功能需求」,并给出一种覆盖校验方法,确保没有机制被工程遗漏。
判断链:卷一机制结论是卷二工程输入。先定机制(要不要成就、要不要工坊、要不要联机),再定功能清单(要接哪些 Steamworks 功能面),最后才是写代码。
本章与站内既有内容的分工
| 主题 | 站内既有内容 | 本节做什么 |
|---|---|---|
| 机制层 | 第 1–15.2 章全部 | 前文讲机制与决策;本节把机制汇总成功能需求 |
| Steamworks 上架操作 | game/publish/steam 发行专题 | 发行专题讲 Steamworks 操作;本节做「机制→功能面」映射 |
| 卷二预告 | 本书三卷结构 | 本节收口卷一,给出卷二工程的功能清单起点 |
一句话:发行专题教你怎么用 Steamworks,本节告诉你「按你的机制,该用 Steamworks 的哪些部分」。
机制 → 功能面:映射表
每个卷一机制对应卷二要落地的 Steamworks 功能面(映射为工程关系,非 Valve 官方表述):
| 卷一机制 | 卷二 Steamworks 功能面 | 落地形态 |
|---|---|---|
| 成就 | ISteamUserStats | 统计与成就解锁 |
| 云存档 | ISteamRemoteStorage | 云存储读写 |
| 创意工坊 | ISteamUGC | UGC 上传/订阅 |
| 联机 | ISteamNetworkingSockets、ISteamMatchmaking | 网络通道、会话 |
| 匹配 | ISteamMatchmaking | 大厅与匹配 |
| 微交易 | ISteamInventory、MicroTxn | 库存与交易 |
| DRM/所有权 | ISteamApps、SteamDRM | 授权校验 |
| 覆盖层/截图 | ISteamUtils、ISteamScreenshots | 覆盖层 UI、截图 |
| 排行榜 | ISteamUserStats | 排行榜 |
| 远程同乐 | ISteamRemotePlay | 远程一起玩 |
| 家庭共享 | SteamDRM、ReleaseConfig | 所有权派生共享 |
| 区域定价 | ReleaseConfig | 区域价格配置 |
| 愿望单发售 | ReleaseConfig、StorePage | 商店页与发售配置 |
| 身份校验 | ISteamUser、ISteamApps | 登录与所有权 |
注意两类「非运行时」功能面:区域定价与愿望单发售主要落在商店页/发售配置(ReleaseConfig、StorePage),它们不在运行时 API 里,但同样决定机制能否成立。
覆盖校验:机制组合决定功能清单
工程上最怕「机制说了,功能没接」。覆盖校验的方法是:
- 把游戏规划的机制组合展开成必需功能面集合。
- 拿工程计划提供的功能面清单逐项比对。
- 有缺失即失败,多提供不扣分。
lab 对三类典型游戏做校验:
- 单人肉鸽:成就 + 云存档 + 排行榜 + 覆盖层 → 需要 ISteamUserStats、ISteamRemoteStorage、ISteamUtils、ISteamScreenshots;不需要联机。若工程计划里出现 ISteamMatchmaking,是过度实现;若少了 ISteamUserStats,是漏接。
- 合作联机:联机 + 匹配 + 远程同乐 + 成就 + 云存档 + 覆盖层 + 身份校验 → 需要 9 个功能面,是功能面最多的组合。
- 模拟经营 + 工坊:工坊 + 成就 + 云存档 + 覆盖层 → ISteamUGC 是核心。
判断链:功能面数量 ≈ 机制组合的工程复杂度。机制越少、越聚焦,工程范围越可控;机制越多,越要靠覆盖校验兜底。
从机制到工程的收口
卷一的最后一个结论是工作顺序:机制位先于工程位。
- 先定机制:用 14.1/14.2/14.3 判断品类、机制匹配与机会缺口,得出「这款游戏该带哪些机制」。
- 再定功能清单:用本节映射表展开必需 Steamworks 功能面,产出卷二的需求输入。
- 最后写代码:进入卷二后,按功能面清单逐项实现与验收。
这就是三卷书的结构逻辑:卷一给你「做什么与为什么」,卷二给你「怎么用 SDK 落地」,卷三给你「商业化怎么闭环」。本节是卷一与卷二的接线端子。
数据口径与来源
- 机制→功能面映射:基于 Steamworks 公开功能模块的工程归纳,非 Valve 官方表述;各 API 接口名称与行为以 partner.steamgames.com 文档(登录后可见)为准。
- 功能面清单(ISteamUserStats、ISteamUGC、ISteamNetworkingSockets 等):Steamworks 公开的接口模块名称。
- 覆盖校验规则(缺即失败、多不扣分):模型方法,供工程校验使用。
以上机制口径撰写时对照 Steamworks 官方文档与 store.steampowered.com 可实证页面核对;登录后可见数据以官方当前为准。
可运行产物:C++ 最小验证
下面这个程序把「机制 → 功能需求映射」实现为覆盖校验仿真:机制到功能面的映射表、三类典型游戏的必需功能面展开、以及覆盖校验的通过与失败用例。它与 src/15-3-bridge-to-sdk.cpp 逐字节一致:
// file: src/15-3-bridge-to-sdk.cpp
// tier: L1
// verify: clang++ -std=c++20 -Wall -I. src/15-3-bridge-to-sdk.cpp -o bin/15-3-bridge-to-sdk && ./bin/15-3-bridge-to-sdk
//
// 复现「从机制到 SDK 功能需求的映射」仿真:
// 卷一各章的平台机制(成就、云存档、创意工坊、联机、微交易、DRM、
// 愿望单发售等)映射到卷二要落地的 Steamworks 功能面,并对游戏规划
// 的机制组合做功能清单覆盖校验。映射为机制→功能面的工程关系,
// 独立最小验证,非 Valve 官方口径。
#include "verify.h"
#include <algorithm>
#include <cstdio>
#include <map>
#include <string>
#include <vector>
namespace steam_repro {
using FeatureSet = std::vector<std::string>;
// 机制 → 所需 Steamworks 功能面(卷一机制位 → 卷二工程位)
const std::map<std::string, FeatureSet>& mapping() {
static const std::map<std::string, FeatureSet> m = {
{"achievements", {"ISteamUserStats"}},
{"cloud-saves", {"ISteamRemoteStorage"}},
{"workshop", {"ISteamUGC"}},
{"online-multiplayer", {"ISteamNetworkingSockets", "ISteamMatchmaking"}},
{"matchmaking", {"ISteamMatchmaking"}},
{"microtransactions", {"ISteamInventory", "MicroTxn"}},
{"drm", {"ISteamApps", "SteamDRM"}},
{"overlay", {"ISteamUtils", "ISteamScreenshots"}},
{"leaderboards", {"ISteamUserStats"}},
{"remote-play", {"ISteamRemotePlay"}},
{"family-sharing", {"SteamDRM", "ReleaseConfig"}},
{"regional-pricing", {"ReleaseConfig"}},
{"wishlist-launch", {"ReleaseConfig", "StorePage"}},
{"auth-ownership", {"ISteamUser", "ISteamApps"}},
};
return m;
}
// 去重合并:给定一组机制,返回所需功能面(唯一、排序)
FeatureSet requiredFeatures(const std::vector<std::string>& mechanisms) {
FeatureSet out;
for (const auto& mech : mechanisms) {
for (const auto& f : mapping().at(mech)) {
if (std::find(out.begin(), out.end(), f) == out.end()) out.push_back(f);
}
}
std::sort(out.begin(), out.end());
return out;
}
bool contains(const FeatureSet& fs, const std::string& f) {
return std::find(fs.begin(), fs.end(), f) != fs.end();
}
// 覆盖校验:所有必需功能面都已提供
bool coverageComplete(const FeatureSet& required, const FeatureSet& provided) {
for (const auto& r : required) {
if (!contains(provided, r)) return false;
}
return true;
}
} // namespace steam_repro
int main() {
using namespace steam_repro;
// 1. 每个机制都有至少一个功能面(无孤儿机制)
for (const auto& [mech, feats] : mapping()) CHECK(!feats.empty());
// 2. 单人肉鸽:成就 + 云存档 + 排行榜 + 覆盖层
const FeatureSet rogue = requiredFeatures(
{"achievements", "cloud-saves", "leaderboards", "overlay"});
CHECK(contains(rogue, "ISteamUserStats"));
CHECK(contains(rogue, "ISteamRemoteStorage"));
CHECK(contains(rogue, "ISteamUtils"));
CHECK(!contains(rogue, "ISteamMatchmaking")); // 单人不需要联机
// 3. 合作联机:联机 + 匹配 + 远程同乐 + 成就 + 云存档 + 覆盖层
const FeatureSet coop = requiredFeatures(
{"online-multiplayer", "matchmaking", "remote-play",
"achievements", "cloud-saves", "overlay", "auth-ownership"});
CHECK(contains(coop, "ISteamNetworkingSockets"));
CHECK(contains(coop, "ISteamMatchmaking"));
CHECK(contains(coop, "ISteamRemotePlay"));
CHECK(contains(coop, "ISteamUser"));
CHECK(contains(coop, "ISteamApps"));
// 4. 创意工坊模拟经营:工坊 + 成就 + 云存档
const FeatureSet workshopGame = requiredFeatures(
{"workshop", "achievements", "cloud-saves", "overlay"});
CHECK(contains(workshopGame, "ISteamUGC"));
// 5. 免费 + 微交易:身份校验 + 库存 + 交易
const FeatureSet f2p = requiredFeatures(
{"auth-ownership", "microtransactions", "overlay"});
CHECK(contains(f2p, "ISteamInventory"));
CHECK(contains(f2p, "MicroTxn"));
CHECK(!contains(f2p, "ISteamMatchmaking"));
// 6. 去重:成就 + 排行榜都映射到 ISteamUserStats,只出现一次
CHECK(std::count(rogue.begin(), rogue.end(), "ISteamUserStats") == 1);
// 7. 愿望单发售 → 商店页/发售配置(工程位不在运行时 API)
const FeatureSet launch = requiredFeatures({"wishlist-launch"});
CHECK(contains(launch, "ReleaseConfig"));
CHECK(contains(launch, "StorePage"));
CHECK(!contains(launch, "ISteamUserStats"));
// 8. 覆盖校验:提供齐全 → 通过
CHECK(coverageComplete(rogue, rogue));
CHECK(coverageComplete(coop, coop));
// 9. 覆盖校验:漏掉 ISteamUserStats → 失败
FeatureSet missingStats = {"ISteamRemoteStorage", "ISteamUtils",
"ISteamScreenshots"};
CHECK(!coverageComplete(rogue, missingStats));
// 10. 覆盖校验:多提供了无关功能面不影响通过
FeatureSet extra = rogue;
extra.push_back("ISteamUGC");
CHECK(coverageComplete(rogue, extra));
// 11. 机制组合的功能面数量:合作联机 > 单人肉鸽
CHECK(coop.size() > rogue.size());
// 12. 家庭共享依赖 DRM/所有权配置而非单独运行时 API
const FeatureSet family = requiredFeatures({"family-sharing"});
CHECK(contains(family, "SteamDRM"));
// 输出映射(模型输出,非官方口径)
for (const auto& [mech, feats] : mapping()) {
std::printf("%-18s -> ", mech.c_str());
for (size_t i = 0; i < feats.size(); ++i) {
std::printf("%s%s", feats[i].c_str(), i + 1 < feats.size() ? ", " : "");
}
std::printf("\n");
}
std::printf("rogue features: %zu, coop features: %zu\n",
rogue.size(), coop.size());
return lab::report("15-3 与卷二工程衔接");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 37/37 通过。
小结
- 卷一机制 → 卷二功能面:成就/排行榜→ISteamUserStats,工坊→ISteamUGC,联机→Networking+Matchmaking,微交易→Inventory+MicroTxn。
- 非运行时机制(区域定价、愿望单发售)落在商店页与发售配置,不是运行时 API。
- 覆盖校验:机制组合展开成功能清单,缺失即失败、多提供不扣分。
- 判断链:先定机制,再定功能清单,最后写代码——机制位先于工程位。
阅读导航:上一节:15.2 机制决定的设计原则 · 下一节:卷一目录 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。