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

在您的移动应用中展示付费墙是向用户提供高级内容或服务访问权限的重要步骤。但是，仅仅展示付费墙只有在您使用付费墙编辑工具自定义付费墙时，才足以支持购买。

如果您没有使用付费墙编辑工具，则必须使用一个单独的方法 .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 会自动完成该交易——Apple 购买系统界面会立即显示，Adapty 则像处理其他任何购买一样处理该交易。

如果被推广的产品包含订阅优惠，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
    });
}

SDK 目前不会将推广购买传递给此方法，而是自动完成购买流程，因此你暂时无法在展示自定义内容前延迟处理推广购买。不过仍需实现该方法（接口要求），空方法体即为有效实现。

管理预付费计划（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;
    }
});