开始使用
快速入门:第一次解锁
大约 15 分钟内,你会在自己的手表上购买自己的应用,看它解锁,再退款看它重新锁定。全程在测试模式下运行:免费,没有真实资金流动。
开始之前
- 一个能成功构建的 Connect IQ 项目。本页以应用为例。表盘和数据字段需要添加几个钩子,而不是一行代码:参见表盘和数据字段。
- 一块手表,或 Connect IQ 模拟器。
- 一部带相机的手机。
- 一个 Stripe、PayPal、Polar、Razorpay 或 Paystack 账户。可以在连接时创建。
在控制台中设置应用
- 添加你的应用。打开添加应用。为它命名,选择类型(应用、表盘或数据字段),添加图标并选择颜色。
- 说明付费内容。选择整个应用或部分功能,并写最多三行简短说明,介绍 Premium 新增的内容。首次测试请将免费试用保持为 0 天,这样购买界面会立即显示。之后可以再添加试用。
- 连接测试付款账户。在“连接付款”步骤中,选择“连接 Stripe”或“连接 PayPal”,并连接测试端。正式端在你正式上线时再连接。买家直接向该账户付款:我们从不经手这笔钱。
- 设置价格。一次性、订阅或固定期限。之后可以修改。
把库添加到你的项目
最后一步“添加到你的应用”会显示同样的几行代码,并填好你的应用信息。随时可以从应用的“安装”标签页再次打开。
- 下载配置。把
PaywallConfig.mc下载到项目的source文件夹。它包含你的应用地址,是公开的,不是密钥。 - 添加库。下载库并解压到应用文件夹旁边,让两者并排放置。
- 让 jungle 指向它。用相对路径把库的文件夹添加到
monkey.jungle。 - 允许网络访问。在 manifest 中添加 Communications 权限。
monkey.jungle
base.sourcePath = source;../wearcheckout/lib/watch/app;../wearcheckout/lib/watch/glance
base.resourcePath = resources;../wearcheckout/lib/watch/resourcesmanifest.xml
<iq:permissions>
<iq:uses-permission id="Communications"/>
</iq:permissions>你的配置文件如下所示,其中是你自己应用的地址:
source/PaywallConfig.mc
// PaywallConfig.mc: from your dashboard (Interval Timer). Public, not a secret.
import Toybox.Lang;
(:glance)
module PaywallConfig {
const URL = "https://pay.example/api/K7Q2/c"; // your app's address
// const TRIAL_DAYS = 7; // add for a time trial
}改一行代码
在应用的 getInitialView() 中,把你已经返回的视图包起来:
source/YourApp.mc
// Before
return [new MainView(), new MainDelegate()];
// After: the whole app is paid for
return Paywall.gate([new MainView(), new MainDelegate()]);应用锁定期间,由购买界面代替它显示。付费后,打开你自己的视图。如果只出售部分功能,请使用 Paywall.start,每个功能检查一次:参见给付费功能加锁。
在手表上购买
- 运行。构建应用并在手表或模拟器上启动。首次启动会将其注册为你的测试手表,应用的“测试”标签页会勾选第一步。
- 扫码。购买界面会显示 QR 码。用手机相机对准它。支付服务商的结账页面会在手机上打开,并已关联到那块手表。
- 用测试卡付款。Stripe 请使用
4242 4242 4242 4242、任意未来日期和任意 CVC。PayPal 请使用 PayPal 沙盒中的买家账户。不会有真实资金流动。 - 看它解锁。让应用在手表上保持打开。付款约一秒后,手表播放解锁动画(如果手表开启了提示音和振动,还会响铃和振动),并显示“Premium 已解锁”。
- 退款。让手表停留在“Premium 已解锁”界面。在支付服务商的测试控制台中退还测试付款。手表会在几秒内重新锁定并显示 QR 码。
已经按了 START 或 BACK?那么购买界面已关闭,手表会改为在下次检查时锁定。具体时间见退款、争议与续订。
检查测试结果
应用的“测试”标签页会在每一步发生时立即勾选这五个步骤:
- 你的测试手表已注册。
- 在手机上打开了购买页面。
- 测试付款成功。
- 手表已解锁。
- 退款后重新锁定。
五项全部通过是上线前的检查之一。