《Steam 游戏平台:开发与商业化》11.2 Demo 与试玩

Demo、免费周末、限时试玩是三种不同的所有权状态,BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial 分别回答「有没有」「靠什么」「还剩多少」。本节讲所有权状态机与启动门控的工程语义,lab 用 C++ mock 验证状态机与门控。

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;

工程语义:

  1. BIsSubscribedApp 是「另一个 appid」的许可查询:头文件注释点名它的适用场景——“check ownership of another game related to yours, a demo for example”。Demo 是独立的 appid,完整版是另一个 appid;游戏启动时用它确认玩家手里是哪种许可证。
  2. BIsSubscribedFromFreeWeekend 只回答「当前 App 是否通过免费周末获得访问」:注释明确它对「拥有零售或其他类型许可证」的用户返回 false——有完整版的人不因免费周末再返回 true。它是「来源」查询,不是「能否玩」查询。
  3. BIsTimedTrial 同时带回两个输出:允许的秒数(punSecondsAllowed)与已玩秒数(punSecondsPlayed),返回值表示「当前是否处于限时试玩」。门控 = 已玩 < 允许,两个输出都要读。
  4. 三种状态不是互斥的:免费周末、Demo、限时试玩可以叠加出现。工程上要做的是优先级判定:有完整版 → 无条件可玩;没有完整版 → 看免费周末 / Demo / 试玩剩余。不能假设玩家只有一种状态。

启动门控:能不能继续玩

把三个接口合成一个「门控函数」,是 Demo/试玩接入的核心逻辑:

// 模型:可玩性门控(对应所有权状态机的判定,非 SDK 头文件)
// canPlay = 有完整版 || 免费周末中 || 有 Demo || (试玩中 && 已玩 < 允许)

工程语义:

  1. 完整版是最高优先级:购买完整版后,Demo/试玩/免费周末的约束全部解除。注意购买行为发生在会话中途——试玩进行中买了完整版,门控要立刻放开,不能等重启。
  2. Demo 不受限时约束:Demo appid 的玩家可玩性由 Demo 自己的设计决定(比如关卡限制),而不是限时秒数。把 Demo 和限时试玩混在一个倒计时里是常见错误。
  3. 试玩是「倒计时」不是「次数」:BIsTimedTrial 返回的是已玩秒数与允许秒数,门控按「已玩 < 允许」判。工程上要在游戏内展示剩余时间,并在超时时给出「购买完整版可继续」的转化路径。
  4. 转化是目的:Demo/免费周末/限时试玩的存在意义是把玩家转化成完整版购买。接入工程在门控关闭时提供的购买入口,是转化漏斗的最后一环——下面 lab 用一个量级假设(模型假设 10% 量级)示意转化率口径,不代表官方数值。

Demo、免费周末、限时试玩的产品差异

三个形态在工程上有明确的差异边界:

形态许可证来源可玩性约束典型转化信号
Demo独立 Demo appid内容范围(关卡/时长),不限时Demo 玩家 → 完整版
免费周末当前 App 的临时许可只在周末窗口内周末活跃 → 购买
限时试玩当前 App 的计时许可已玩秒数 < 允许秒数超时后的购买转化

工程上判断「玩家当前到底属于哪种」,要按 BIsSubscribedApp(Demo appid)、BIsSubscribedFromFreeWeekend、BIsTimedTrial 三个查询的顺序判定,优先级是完整版 > 免费周末 > Demo > 试玩。顺序错了会出「试玩倒计时把 Demo 玩家也拦了」之类的逻辑倒挂。

接口签名对照

头文件条目语义
isteamapps.hISteamApps::BIsSubscribedApp检查某 appid 的许可证(Demo/关联游戏)
isteamapps.hISteamApps::BIsSubscribedFromFreeWeekend当前 App 是否经免费周末获得访问
isteamapps.hISteamApps::BIsTimedTrial是否限时试玩及允许/已玩秒数
—(模型)可玩性门控(优先级判定)完整版 > 免费周末 > Demo > 试玩

数据口径与来源

  • BIsSubscribedApp/BIsSubscribedFromFreeWeekend/BIsTimedTrial 签名与注释语义:SDK v1.65 public/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 测试策略与数据 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图