文档

开始使用

快速入门:第一次解锁

大约 15 分钟内,你会在自己的手表上购买自己的应用,看它解锁,再退款看它重新锁定。全程在测试模式下运行:免费,没有真实资金流动。

开始之前

  • 一个能成功构建的 Connect IQ 项目。本页以应用为例。表盘和数据字段需要添加几个钩子,而不是一行代码:参见表盘和数据字段。
  • 一块手表,或 Connect IQ 模拟器。
  • 一部带相机的手机。
  • 一个 Stripe、PayPal、Polar、Razorpay 或 Paystack 账户。可以在连接时创建。

在控制台中设置应用

  1. 添加你的应用。打开添加应用。为它命名,选择类型(应用、表盘或数据字段),添加图标并选择颜色。
  2. 说明付费内容。选择整个应用或部分功能,并写最多三行简短说明,介绍 Premium 新增的内容。首次测试请将免费试用保持为 0 天,这样购买界面会立即显示。之后可以再添加试用。
  3. 连接测试付款账户。在“连接付款”步骤中,选择“连接 Stripe”或“连接 PayPal”,并连接测试端。正式端在你正式上线时再连接。买家直接向该账户付款:我们从不经手这笔钱。
  4. 设置价格。一次性、订阅或固定期限。之后可以修改。

把库添加到你的项目

最后一步“添加到你的应用”会显示同样的几行代码,并填好你的应用信息。随时可以从应用的“安装”标签页再次打开。

  1. 下载配置。把 PaywallConfig.mc 下载到项目的 source 文件夹。它包含你的应用地址,是公开的,不是密钥。
  2. 添加库。下载库并解压到应用文件夹旁边,让两者并排放置。
  3. 让 jungle 指向它。用相对路径把库的文件夹添加到 monkey.jungle。
  4. 允许网络访问。在 manifest 中添加 Communications 权限。
monkey.jungle
base.sourcePath = source;../wearcheckout/lib/watch/app;../wearcheckout/lib/watch/glance
base.resourcePath = resources;../wearcheckout/lib/watch/resources
manifest.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,每个功能检查一次:参见给付费功能加锁。

在手表上购买

  1. 运行。构建应用并在手表或模拟器上启动。首次启动会将其注册为你的测试手表,应用的“测试”标签页会勾选第一步。
  2. 扫码。购买界面会显示 QR 码。用手机相机对准它。支付服务商的结账页面会在手机上打开,并已关联到那块手表。
  3. 用测试卡付款。Stripe 请使用 4242 4242 4242 4242、任意未来日期和任意 CVC。PayPal 请使用 PayPal 沙盒中的买家账户。不会有真实资金流动。
  4. 看它解锁。让应用在手表上保持打开。付款约一秒后,手表播放解锁动画(如果手表开启了提示音和振动,还会响铃和振动),并显示“Premium 已解锁”。
  5. 退款。让手表停留在“Premium 已解锁”界面。在支付服务商的测试控制台中退还测试付款。手表会在几秒内重新锁定并显示 QR 码。

已经按了 START 或 BACK?那么购买界面已关闭,手表会改为在下次检查时锁定。具体时间见退款、争议与续订。

检查测试结果

应用的“测试”标签页会在每一步发生时立即勾选这五个步骤:

  1. 你的测试手表已注册。
  2. 在手机上打开了购买页面。
  3. 测试付款成功。
  4. 手表已解锁。
  5. 退款后重新锁定。

五项全部通过是上线前的检查之一。

下一步

  • 测试:测试模式、模拟器和离线测试。
  • 添加库:语言、概览和其他调用。
  • 正式上线:八项检查和你的商店介绍。
Esc