在移动应用中通过 Kotlin Multiplatform SDK 进行购买

在移动应用中展示付费墙是向用户提供高级内容或服务访问权限的关键步骤。然而，仅当 Adapty 负责渲染界面时——即使用流程或旧版付费墙编辑工具构建的付费墙——展示付费墙本身才能自动支持购买操作。

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

如果你的付费墙中某个产品存在有效的促销活动，Adapty 会在用户购买时自动应用该优惠。

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

发起购买

Adapty.makePurchase(product = product).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                // Grant access to the paid features
            }
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // Handle the case where the user canceled the purchase
        }
        is AdaptyPurchaseResult.Pending -> {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    }
}.onError { error ->
    // Handle the error
}

请求参数：

响应参数：

购买时更换订阅

当用户选择新订阅而非续订当前订阅时，具体行为取决于所使用的应用商店。对于 Google Play，订阅不会自动更新，你需要按照以下说明在移动应用代码中手动处理切换逻辑。

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

val subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    oldSubVendorProductId = "old_subscription_product_id",
    replacementMode = AdaptyAndroidSubscriptionUpdateReplacementMode.CHARGE_FULL_PRICE
)

val purchaseParams = AdaptyPurchaseParameters.Builder()
    .setSubscriptionUpdateParams(subscriptionUpdateParams)
    .build()

Adapty.makePurchase(
    product = product,
    parameters = purchaseParams
).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            // successful cross-grade
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // user canceled the purchase flow
        }
        is AdaptyPurchaseResult.Pending -> {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    }
}.onError { error ->
    // Handle the error
}

附加请求参数：

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

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

在 iOS 中兑换优惠码

在您的应用中显示代码兑换界面：

Adapty.presentCodeRedemptionSheet()
    .onSuccess {
        // code redemption sheet presented successfully
    }
    .onError { error ->
        // handle the error
    }

管理预付方案 (Android)

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

Adapty.activate(
    AdaptyConfig.Builder("PUBLIC_SDK_KEY")
        .withGoogleEnablePendingPrepaidPlans(true)
        .build()
).onSuccess {
    // successful activation
}.onError { error ->
    // handle the error
}

来自 App Store 的推广应用内购买

当用户从 App Store 产品页面发起购买，且交易转移到您的应用时，SDK 会通过 OnPromotedPurchaseListener 将产品传递给您。完成购买由您的应用负责：将产品传入 makePromotedPurchase。由于您可以控制购买发起的时机，您可以在购买开始前展示自己的界面。

要支持推广购买，请注册监听器并在其中完成购买：

Adapty.setOnPromotedPurchaseListener(OnPromotedPurchaseListener { product ->
    scope.launch {
        Adapty.makePromotedPurchase(product)
            .onSuccess { result -> /* process the purchase result */ }
            .onError { error -> /* handle the error */ }
    }
})

在应用启动时，紧接着 Adapty.activate 之后注册监听器。促销购买通常会冷启动应用，因此往往在你完成注册之前就已到达 SDK。SDK 会暂存一个此类购买，并在你注册后立即将其投递，但只保留最新的一个，并在每次暂存购买时写入控制台警告。

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

makePromotedPurchase 不接受任何购买参数——推广产品来自 App Store 而非付费墙，因此不携带任何付费墙上下文。它返回与 makePurchase 相同的 AdaptyPurchaseResult。

AdaptyPromotedProduct 包含 vendorProductId、localizedTitle、localizedDescription、price、regionCode、isFamilyShareable，以及一个 AdaptyProductSubscription 类型的 subscription。