给付费功能加锁

用 Paywall.gate 出售整个应用，或用 Paywall.start 出售部分功能，每个功能检查一次。本页列出库中的所有公开调用和常量，以及试用的工作方式。

整个应用还是部分功能

两者接受的数组与你从 getInitialView() 返回的相同：一个视图，或一个视图及其委托。

给功能加锁

使用 start 时，在每个付费功能的入口处检查：按钮、菜单项或页面。

function onHistory() as Void {
    if (Paywall.unlocked()) {
        showHistory();
    } else {
        Paywall.open();
    }
}

• 一把锁，全部打开。一次购买即可开启应用内所有付费功能。每个应用只有一个价格。
• 在概览中，只能调用 active()、unlocked() 和 trialLeft()。购买界面仅限应用使用。
• 只应向买家显示（试用期间不显示）的致谢小细节，请检查 Paywall.active()。

参考

除非表中另有说明，这里的所有内容都在 module Paywall 中（Pay.mc 以及你使用的 PayScope.mc）。

你调用的接口

由库自己调用

库会自己调用这些。不要在你的代码中调用。

常量

模块变量

购买界面自身的状态。需要时可以读取；切勿设置。

类

PaywallConfig

表盘和数据字段

表盘和数据字段使用 lib/watch/face，其 module Paywall 有自己的调用。active()、unlocked() 和 trialLeft() 的用法同上。

完整设置见表盘和数据字段。

试用

• 在 PaywallConfig 中设置 TRIAL_DAYS，与控制台中的免费试用一致。不设试用就省略：这样永远不会显示“试用结束”。
• 试用在首次启动时开始。结束前 Paywall.unlocked() 一直为 true。
• 重新安装不会重新开始试用。我们的服务器从第一次见到该手表时开始计算试用期，并在第一次应答时用它的计数替换手表上的计数。
• 把时钟调回也无法延长。服务器发送的是剩余时间而不是日期，手表计算的天数也永远不会超过 TRIAL_DAYS。
• 购买界面的标题依次显示“剩余 7 天”、“最后一天”、“试用结束”。

由应用计时的试用

如果按使用次数而不是天数试用，请省略 TRIAL_DAYS，在存储中保留你自己的计数器（“删除数据”时也要保留），并检查 active()：

// 20 free sessions, then Premium
if (Paywall.active() || sessionsUsed < 20) {
    startSession();
} else {
    Paywall.open();
}

库存储的内容

• 应用："pa"（应答）、"pp"（上次确认“已付费”的时间）、"ts"（试用结束时间）和 "te"（已显示“试用结束”）。
• 表盘和数据字段："pa"、"pp"、"ts" 和 "pg"，外加用于设置链接的 unlock 属性。
• 你自己的键请使用其他名称。