在 Flutter SDK 的移动应用中发起购买

在您的移动应用中展示付费墙，是为用户提供高级内容或服务访问权限的关键步骤。但是，只有当 Adapty 负责渲染界面时——即使用流程或旧版付费墙编辑工具构建的付费墙——展示付费墙才能独立支持购买。

如果您使用自己的代码渲染界面，则必须调用一个名为 .makePurchase() 的独立方法来完成购买并解锁目标内容。该方法是用户与付费墙交互并完成所需交易的入口。

如果你的付费墙针对用户正在购买的产品设置了有效的促销活动，Adapty 会在购买时自动应用该促销活动。

请确保您已完成初始配置，不要跳过任何步骤。否则，我们将无法验证购买。

发起购买

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

请求参数：

响应参数：

购买时更改订阅

当用户选择新订阅而非续订当前订阅时，具体行为取决于所使用的应用商店：

• 对于 App Store，订阅会在同一订阅组内自动更新。如果用户购买了某个订阅组的订阅，而此时已有另一个订阅组的有效订阅，则两个订阅将同时处于激活状态。
• 对于 Google Play，订阅不会自动更新。您需要按照以下说明在移动应用代码中手动处理切换逻辑。

在 Android 中，如需将订阅替换为另一个订阅，请在调用 .makePurchase() 方法时传入额外参数：

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // successful cross-grade
} on AdaptyError catch (adaptyError) {
  // Handle the error
} catch (e) {
  // Handle the error
}

附加请求参数：

您可以在 Google 开发者文档中了解更多关于订阅和替换模式的信息：

• 关于替换模式
• Google 关于替换模式的建议
• 替换模式 CHARGE_PRORATED_PRICE。注意：此方法仅适用于订阅升级，不支持降级。
• 替换模式 DEFERRED。注意：实际的订阅变更仅在当前订阅计费周期结束后才会生效。

在 iOS 中兑换优惠码

在应用中展示兑换码页面：

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

来自 App Store 的推广内购

当用户从你的 App Store 产品页面发起购买，且该交易流转到你的应用时，SDK 会将产品传递给 didReceivePromotedPurchaseStream。订阅该流并将产品传递给 makePromotedPurchase：

Adapty().didReceivePromotedPurchaseStream.listen((product) async {
  try {
    final result = await Adapty().makePromotedPurchase(product: product);
    // process the purchase result
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
});

在应用启动时、activate 调用之后立即订阅，确保在促销购买到达之前监听器已就绪。didReceivePromotedPurchaseStream 是一个广播流，不会重播历史事件：若在无监听器时推送了产品，该事件将被丢弃。

makePromotedPurchase 不接受任何购买参数，因为促销产品来自 App Store 而非付费墙，不包含付费墙上下文。它返回与 makePurchase 相同的 AdaptyPurchaseResult。

如果推广产品包含订阅优惠，SDK 会在购买时自动应用该优惠。优惠信息从 App Store 购买意图中读取，该功能在 iOS 18.0 及更高版本上可用。在 iOS 16.4–17.x 上，购买将以原价进行。

管理预付费方案（Android）

如果你的应用用户可以购买预付费方案（例如，购买数月有效期的非续订订阅），你可以为预付费方案启用待处理交易。

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);