精确的 Android 优惠
传入 offerToken 来自相同的 getProducts() 你显示的结果 purchaseProduct() 对该优惠进行计费。参见 Android 订阅优惠.
@capgo/native-purchases 封装 StoreKit 2 以及 Google Play 结算系统 通过一个 Capacitor API 即可覆盖订阅、消耗型商品和恢复购买流程。从商店加载产品元数据、在应用内购买并刷新权益,无需维护单独的原生桥接。
如果你想要第一方计费,又不想依赖第三方订阅 SDK,就选这个插件。
精确的 Android 优惠
传入 offerToken 来自相同的 getProducts() 你显示的结果 purchaseProduct() 对该优惠进行计费。参见 Android 订阅优惠.
可选的计费周期
Product.subscriptionPeriod 是可选的。Android 在预付费优惠中会省略它。使用 product.subscriptionPeriod?.unit.
分期周期
Android 分期付款计划可以包含 subscriptionBillingCycles 来自 Play 的分期付款承诺付款次数。
这些 Android 优惠和产品详情记录于 capacitor-native-purchases#245.
| 平台 | 计费技术栈 |
|---|---|
| iOS | StoreKit 2 |
| Android | Google Play Billing 7+ |
| 方法 | 描述 |
|---|---|
restorePurchases | 恢复用户之前的购买记录,并将其 appUserIDs 与任何也使用这些 appUserIDs 的用户关联。 |
getAppTransaction | 获取 App Transaction 信息,其中包含用户最初下载或购买 App 的详细信息。 |
isEntitledToOldBusinessModel | 将 App Transaction 中的原始 App 版本与目标版本进行对比,以确定用户是否有权使用旧版商业模式的功能。 |
purchaseProduct | 启动原生购买流程。在 Android 上,传入 offerToken 以从 getProducts(),或 planIdentifier 中购买该基础套餐的第一个优惠。在支持的 iOS 版本上,传入 billingPlanType: 'monthly' 用于购买含 12 个月承诺期的按月计费方案。 |
getProducts | 获取与产品标识符关联的产品信息。在支持的 iOS 版本上,订阅产品可包含 pricingTerms。在 Android 上,订阅产品可能包含 subscriptionPeriod 以及 subscriptionBillingCycles ,前提是 Play 提供了这些内容。 |
getProduct | 获取单个产品标识符的产品信息。 |
isBillingSupported | 检查当前设备是否支持计费。 |
getPluginVersion | 获取原生 Capacitor 插件版本。 |
getPurchases | 获取用户的所有购买记录(包括应用内购买和订阅)。此方法会查询当前用户在平台上的购买历史。 |
manageSubscriptions | 打开平台的原生订阅管理页面。用户可以在这里查看、修改或取消订阅。 |
acknowledgePurchase | 手动确认/完成购买交易。 |
consumePurchase | 在 Android 上消耗应用内购买。 |
addListener | 监听由 Apple 的 Transaction.updates 推送的 StoreKit 交易更新。如果存在未完成的交易,应用启动时会触发;之后任何更新也会触发。仅限 iOS。 |
addListener | 监听由 Apple 的 Transaction.updates 推送的 StoreKit 交易验证失败。当验证结果为 unverified 时触发。仅限 iOS。 |
removeAllListeners | 移除所有已注册的监听器。 |
此参考文档同步自 src/definitions.ts 中的 capacitor-native-purchases.
如果你正在使用 @capgo/native-purchases 要规划付款和购买,请将其与 使用 @capgo/native-purchases 关于“使用 @capgo/native-purchases”中的原生能力, Capgo 定价 关于 Capgo 定价中的产品工作流, 支付系统 了解支付系统的实现细节, 快速入门 关于“入门指南”中的实现细节,以及 营收手册 关于“Revenue Playbook”中的实现细节。