本指南介绍如何将 Adapty 集成到您的自定义付费墙中。您可以完全掌控付费墙的实现，同时让 Adapty SDK 负责获取产品、处理新购买以及恢复历史购买记录。

开始之前

配置产品

要启用应用内购买，您需要了解三个核心概念：

• 产品 — 用户可以购买的任何内容（订阅、消耗型商品、永久授权）
• 付费墙 — 定义向用户提供哪些产品的配置。在 Adapty 中，付费墙是检索产品的唯一方式，但这种设计让您无需修改应用代码即可调整产品、价格和优惠。
• 版位 — 应用中展示付费墙的位置和时机（例如 main、onboarding、settings）。您在看板中为版位配置付费墙，然后在代码中通过版位 ID 请求对应的付费墙。这使得运行 A/B 测试和向不同用户展示不同付费墙变得更加简便。

即使您使用自定义付费墙，也请确保理解这些概念。从本质上说，它们只是您管理应用内销售产品的一种方式。

要实现自定义付费墙，您需要创建一个付费墙并将其添加到某个版位。此配置允许您检索产品。若要了解需要在看板中执行的操作，请参阅此处的快速入门指南。

管理用户

您可以选择是否在后端进行身份验证。

但是，Adapty SDK 对匿名用户和已识别用户的处理方式有所不同。请阅读用户识别快速入门指南，了解其中的具体差异，确保正确处理用户。

第一步：获取产品

要为自定义付费墙检索产品，您需要：

1. 通过将版位 ID 传入 getPaywall 方法来获取 paywall 对象。
2. 使用 getPaywallProducts 方法获取该付费墙的产品数组。

import com.adapty.kmp.Adapty
import com.adapty.kmp.models.onSuccess
import com.adapty.kmp.models.onError

fun loadPaywall() {
    Adapty.getPaywall(placementId = "YOUR_PLACEMENT_ID")
        .onSuccess { paywall ->
            Adapty.getPaywallProducts(paywall = paywall)
                .onSuccess { products ->
                    // Use products to build your custom paywall UI
                }
                .onError { error ->
                    // Handle the error
                }
        }
        .onError { error ->
            // Handle the error
        }
}

第二步：接受购买

当用户在自定义付费墙中点击某个产品时，调用 makePurchase 方法并传入所选产品。该方法将处理购买流程并返回更新后的用户画像。

import com.adapty.kmp.Adapty
import com.adapty.kmp.models.AdaptyPaywallProduct
import com.adapty.kmp.models.AdaptyPurchaseResult
import com.adapty.kmp.models.onSuccess
import com.adapty.kmp.models.onError

fun purchaseProduct(product: AdaptyPaywallProduct) {
    Adapty.makePurchase(product = product)
        .onSuccess { purchaseResult ->
            when (purchaseResult) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile
                    // Purchase successful, profile updated
                }
                is AdaptyPurchaseResult.UserCanceled -> {
                    // User canceled the purchase
                }
                is AdaptyPurchaseResult.Pending -> {
                    // Purchase is pending (e.g., user will pay offline with cash)
                }
            }
        }
        .onError { error ->
            // Handle the error
        }
}

第三步：恢复购买

应用商店要求所有包含订阅的应用为用户提供恢复购买的途径。

当用户点击恢复按钮时，调用 restorePurchases 方法。该方法将把用户的购买历史与 Adapty 同步，并返回更新后的用户画像。

import com.adapty.kmp.Adapty
import com.adapty.kmp.models.onSuccess
import com.adapty.kmp.models.onError

fun restorePurchases() {
    Adapty.restorePurchases()
        .onSuccess { profile ->
            // Restore successful, profile updated
        }
        .onError { error ->
            // Handle the error
        }
}

后续步骤

您的付费墙已准备好在应用中展示。请在 App Store 沙盒或 Google Play Store 中测试购买流程，确保能够从付费墙完成测试购买。如需了解生产环境中的完整实现，请参阅我们示例应用中的 AppViewModel.kt，其中演示了包含完善错误处理和状态管理的购买处理方案。

接下来，检查用户是否已完成购买，以决定是否展示付费墙或授予用户访问付费功能的权限。