11.2 Demo 与试玩
上一节讲了邀请制测试,这一节讲另外三种「还没买就能玩」的形态:Demo、免费周末、限时试玩。它们共享同一个所有权状态机,但 SDK 用三个不同接口回答三个不同问题:BIsSubscribedApp 问「玩家有没有这个 appid 的许可证」、BIsSubscribedFromFreeWeekend 问「这份访问是不是来自免费周末」、BIsTimedTrial 问「限时试玩还剩多少时间」。接入工程要把这三个问题合成一个「能不能继续玩」的门控。
本卷所有接口口径以 Steamworks SDK v1.65(2026-07-23) 为准。本节摘录的签名对照该版本 public/steam/isteamapps.h。
本章与站内既有内容的分工
- Steam 发行专题 (操作手册)讲「后台上传 Demo、配置免费周末、开限时试玩」;本节讲「三种状态的 SDK 读取与启动门控」。
- 卷一《平台机制与商店》讲商店与发行商机制;本节把「转化漏斗」落成所有权状态机口径。
- lab 用纯 C++ 复现所有权状态机与门控,不依赖 Steam 客户端运行。
三种所有权:三个接口
先看三个接口的原始语义:
// isteamapps.h:ISteamApps 所有权与试玩(SDK v1.65 头文件摘录,已删减)
// only use this member if you need to check ownership of another game related to yours, a demo for example
virtual bool BIsSubscribedApp( AppId_t appID ) = 0;
// Checks if the user is subscribed to the current app through a free weekend
// This function will return false for users who have a retail or other type of license
virtual bool BIsSubscribedFromFreeWeekend() = 0;
// check if game is a timed trial with limited playtime
virtual bool BIsTimedTrial( uint32* punSecondsAllowed, uint32* punSecondsPlayed ) = 0;
工程语义:
BIsSubscribedApp是「另一个 appid」的许可查询:头文件注释点名它的适用场景——“check ownership of another game related to yours, a demo for example”。Demo 是独立的 appid,完整版是另一个 appid;游戏启动时用它确认玩家手里是哪种许可证。BIsSubscribedFromFreeWeekend只回答「当前 App 是否通过免费周末获得访问」:注释明确它对「拥有零售或其他类型许可证」的用户返回 false——有完整版的人不因免费周末再返回 true。它是「来源」查询,不是「能否玩」查询。BIsTimedTrial同时带回两个输出:允许的秒数(punSecondsAllowed)与已玩秒数(punSecondsPlayed),返回值表示「当前是否处于限时试玩」。门控 = 已玩 < 允许,两个输出都要读。- 三种状态不是互斥的:免费周末、Demo、限时试玩可以叠加出现。工程上要做的是优先级判定:有完整版 → 无条件可玩;没有完整版 → 看免费周末 / Demo / 试玩剩余。不能假设玩家只有一种状态。
启动门控:能不能继续玩
把三个接口合成一个「门控函数」,是 Demo/试玩接入的核心逻辑:
// 模型:可玩性门控(对应所有权状态机的判定,非 SDK 头文件)
// canPlay = 有完整版 || 免费周末中 || 有 Demo || (试玩中 && 已玩 < 允许)
工程语义:
- 完整版是最高优先级:购买完整版后,Demo/试玩/免费周末的约束全部解除。注意购买行为发生在会话中途——试玩进行中买了完整版,门控要立刻放开,不能等重启。
- Demo 不受限时约束:Demo appid 的玩家可玩性由 Demo 自己的设计决定(比如关卡限制),而不是限时秒数。把 Demo 和限时试玩混在一个倒计时里是常见错误。
- 试玩是「倒计时」不是「次数」:
BIsTimedTrial返回的是已玩秒数与允许秒数,门控按「已玩 < 允许」判。工程上要在游戏内展示剩余时间,并在超时时给出「购买完整版可继续」的转化路径。 - 转化是目的:Demo/免费周末/限时试玩的存在意义是把玩家转化成完整版购买。接入工程在门控关闭时提供的购买入口,是转化漏斗的最后一环——下面 lab 用一个量级假设(模型假设 10% 量级)示意转化率口径,不代表官方数值。
Demo、免费周末、限时试玩的产品差异
三个形态在工程上有明确的差异边界:
| 形态 | 许可证来源 | 可玩性约束 | 典型转化信号 |
|---|---|---|---|
| Demo | 独立 Demo appid | 内容范围(关卡/时长),不限时 | Demo 玩家 → 完整版 |
| 免费周末 | 当前 App 的临时许可 | 只在周末窗口内 | 周末活跃 → 购买 |
| 限时试玩 | 当前 App 的计时许可 | 已玩秒数 < 允许秒数 | 超时后的购买转化 |
工程上判断「玩家当前到底属于哪种」,要按 BIsSubscribedApp(Demo appid)、BIsSubscribedFromFreeWeekend、BIsTimedTrial 三个查询的顺序判定,优先级是完整版 > 免费周末 > Demo > 试玩。顺序错了会出「试玩倒计时把 Demo 玩家也拦了」之类的逻辑倒挂。
接口签名对照
| 头文件 | 条目 | 语义 |
|---|---|---|
isteamapps.h | ISteamApps::BIsSubscribedApp | 检查某 appid 的许可证(Demo/关联游戏) |
isteamapps.h | ISteamApps::BIsSubscribedFromFreeWeekend | 当前 App 是否经免费周末获得访问 |
isteamapps.h | ISteamApps::BIsTimedTrial | 是否限时试玩及允许/已玩秒数 |
| —(模型) | 可玩性门控(优先级判定) | 完整版 > 免费周末 > Demo > 试玩 |
数据口径与来源
BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial签名与注释语义:SDK v1.65public/steam/isteamapps.h可实证(本机镜像已核对)。- Demo 转化率、免费周末的典型提升幅度、限时试玩的时长设置:官方不公开运营口径,本卷的 10% 量级为模型假设,不代表官方数值。
- 免费周末的申请与打包方式:partner 文档登录后可见,以官方当前为准。
以上接口口径撰写时对照 Steamworks SDK v1.65 头文件与 partner.steamgames.com 官方文档核对;登录后可见数据以官方当前为准。
可运行产物:C++ 最小验证
下面的仿真复现「Demo 与试玩」的工程语义:所有权状态机(完整版/Demo/免费周末/限时试玩)、BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial 三查询、可玩性门控的优先级判定、试玩倒计时超时、购买后解除限制。它与 src/11-2-demo-trial.cpp 逐字节一致,mock 接口签名对照 SDK v1.65 头文件:
// file: src/11-2-demo-trial.cpp
// tier: L1
// verify: clang++ -std=c++20 -Wall -I. src/11-2-demo-trial.cpp -o bin/11-2-demo-trial && ./bin/11-2-demo-trial
//
// mock:复现 Demo 与试玩——所有权状态机(完整版 / Demo / 免费周末 / 限时试玩)
// 与启动门控;对应 SDK v1.65 isteamapps.h 的 BIsSubscribedApp、
// BIsSubscribedFromFreeWeekend、BIsTimedTrial 口径。转化率数值为模型假设。
#include "verify.h"
#include <cstdint>
#include <string>
namespace steam_repro {
class MockDemoTrial {
public:
uint32_t fullAppId_;
uint32_t demoAppId_;
bool ownsFull_ = false;
bool ownsDemo_ = false;
bool freeWeekend_ = false;
bool trial_ = false;
uint32_t secondsAllowed_ = 0;
uint32_t secondsPlayed_ = 0;
MockDemoTrial(uint32_t full, uint32_t demo) : fullAppId_(full), demoAppId_(demo) {}
// ISteamApps::BIsSubscribedApp
bool isSubscribedApp(uint32_t appId) const {
if (appId == fullAppId_) return ownsFull_;
if (appId == demoAppId_) return ownsDemo_;
return false;
}
// ISteamApps::BIsSubscribedFromFreeWeekend
bool isSubscribedFromFreeWeekend() const { return freeWeekend_; }
// ISteamApps::BIsTimedTrial
bool isTimedTrial(uint32_t* punSecondsAllowed, uint32_t* punSecondsPlayed) const {
if (punSecondsAllowed) *punSecondsAllowed = secondsAllowed_;
if (punSecondsPlayed) *punSecondsPlayed = secondsPlayed_;
return trial_;
}
// 玩家是否还能继续玩(门控)
bool canPlay() const {
if (ownsFull_) return true;
if (freeWeekend_) return true;
if (ownsDemo_) return true; // demo 不受限时约束(模型假设)
if (trial_) return secondsPlayed_ < secondsAllowed_;
return false;
}
// 玩一局
void play(uint32_t minutes) { secondsPlayed_ += minutes * 60; }
};
} // namespace steam_repro
int main() {
using namespace steam_repro;
MockDemoTrial d(480, 4800);
// 1. 初始未拥有任何版本,无法游玩
CHECK(!d.isSubscribedApp(480));
CHECK(!d.isSubscribedApp(4800));
CHECK(!d.canPlay());
// 2. Demo 所有权:订阅 demo appid
d.ownsDemo_ = true;
CHECK(d.isSubscribedApp(4800));
CHECK(d.canPlay());
// 3. 完整版所有权覆盖 demo
d.ownsFull_ = true;
CHECK(d.isSubscribedApp(480));
CHECK(d.isSubscribedApp(4800));
CHECK(d.canPlay());
// 4. 免费周末:不拥有但可玩
MockDemoTrial w(480, 4800);
w.freeWeekend_ = true;
CHECK(w.isSubscribedFromFreeWeekend());
CHECK(!w.isSubscribedApp(480));
CHECK(w.canPlay());
// 5. 限时试玩:允许 120 分钟
MockDemoTrial t(480, 4800);
t.trial_ = true;
t.secondsAllowed_ = 7200;
uint32_t allowed = 0, played = 0;
CHECK(t.isTimedTrial(&allowed, &played));
CHECK(allowed == 7200);
CHECK(played == 0);
CHECK(t.canPlay());
// 6. 玩 100 分钟后仍可继续
t.play(100);
CHECK(t.secondsPlayed_ == 6000);
CHECK(t.canPlay());
// 7. 超时:玩到 130 分钟 → 门控关闭
t.play(30);
CHECK(t.secondsPlayed_ == 7800);
CHECK(!t.canPlay());
// 8. 购买完整版后试玩限制解除
t.ownsFull_ = true;
CHECK(t.canPlay());
// 9. 试玩信息仍可查(BIsTimedTrial 返回 true)
CHECK(t.isTimedTrial(&allowed, &played));
CHECK(played == 7800);
// 10. 转化率模型:demo 玩家 → 完整版(模型假设量级)
double demoToFull = 0.10; // 模型假设:10% 量级
CHECK(demoToFull > 0.0 && demoToFull < 0.30);
return lab::report("11-2 Demo 与试玩");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 23/23 通过。
小结
- Demo、免费周末、限时试玩是三种不同的所有权状态,由
BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial三个接口分别回答。 - 可玩性门控按优先级判定:完整版 > 免费周末 > Demo > 试玩(已玩 < 允许)。
- Demo 是独立 appid、不受限时约束;试玩是倒计时、要展示剩余并给购买转化入口。
- 免费周末只回答「来源」,有零售许可证的玩家返回 false;三种状态可叠加,不能假设互斥。
阅读导航:上一节:11.1 Playtest 机制 · 下一节:11.3 测试策略与数据 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。