在 Unity SDK 的移动应用中进行购买

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

如果你在自己的代码中渲染界面，则需要单独调用 .makePurchase() 方法来完成购买并解锁相应内容。该方法是用户与付费墙交互、完成所需交易的核心入口。

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

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

进行购买

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

请求参数：

响应参数：

购买时更改订阅

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

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

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

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

额外请求参数：

如需了解更多关于订阅和替换模式的内容，请参阅 Google 开发者文档：

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

在 iOS 中兑换优惠码

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

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

来自 App Store 的推广内购

当用户从 App Store 产品页发起购买时，SDK 会通过 OnReceivePromotedPurchase 将产品传递给你并等待。完成购买由你的应用决定：将产品传入 Adapty.MakePromotedPurchase 即可。由于你可以控制购买发起的时机，因此可以在购买开始前展示自定义界面。

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

IAdaptyEventListener 包含必要的 OnReceivePromotedPurchase(AdaptyPromotedProduct) 方法，与 Adapty.MakePromotedPurchase 配合使用以完成收到的购买：

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

管理预付费计划（Android）

如果你的应用用户可以购买预付费计划（例如，一次性购买数月的非续订订阅），你可以为预付费计划启用待处理交易功能。

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});