本文档提供了如何在 Unity 项目中集成 Apple App Store 应用内支付功能的详细说明。

1. 概述
2. 前提条件
3. 集成步骤
4. API 说明
5. 使用示例
6. 常见问题

本插件提供了一套简单易用的 API，用于在 Unity 应用中集成 Apple App Store 应用内支付功能。它封装了 StoreKit 的复杂性，提供了一个统一的接口，使开发者能够轻松实现以下功能：

• 初始化 Apple App Store Billing
• 查询商品详情
• 购买商品（一次性商品和订阅）
• 消耗购买（消耗型商品）
• 查询购买历史

1. Unity 2019.4 或更高版本
2. iOS 构建支持
3. Apple 开发者账号
4. 在 App Store Connect 中配置好的应用内商品

将 GameFrameX.Payment.Apple 插件导入到您的 Unity 项目中。

在您的游戏场景中添加 ApplePaymentManager 组件，或者通过代码动态创建：

// 获取 ApplePaymentManager 实例
var billingManager = GameFrameX.Payment.PaymentModule.GetPaymentManager<ApplePaymentManager>();

// 注册事件监听
billingManager.OnInitialized += OnInitialized;
billingManager.OnProductsQueried += OnProductsQueried;
billingManager.OnPurchaseCompleted += OnPurchaseCompleted;

// 初始化
billingManager.Init();

// 初始化 Apple App Store Billing
billingManager.Init(bool isDebug = false, bool isClientVerify = false);

// 查询一次性商品
billingManager.QueryPurchases("inapp");

// 查询订阅商品
billingManager.QueryPurchases("subs");

// 购买一次性商品
billingManager.BuyInApp("product_id", "order_id");

// 购买订阅商品
billingManager.BuySubs("subscription_id", "order_id");

// 购买带优惠的订阅商品
billingManager.BuySubs("subscription_id", "order_id", "offer_token");

// 消耗购买（仅适用于消耗型商品）
billingManager.ConsumePurchase("purchase_token");

// 查询一次性商品的购买历史
billingManager.QueryPurchases("inapp");

// 查询订阅商品的购买历史
billingManager.QueryPurchases("subs");

请参考项目中的示例代码，其中包含了完整的使用示例，包括：

• 初始化 Apple App Store Billing
• 查询商品详情
• 购买商品
• 消耗购买
• 查询购买历史

在 App Store Connect 中，您可以将商品配置为「消耗型」或「非消耗型」。在代码中，您可以通过商品 ID 的前缀或其他方式来区分它们。

购买成功后，您应该：

• 对于消耗型商品：调用 ConsumePurchase 方法消耗购买，然后给予用户相应的游戏内物品。
• 对于非消耗型商品：确认购买（插件会自动处理），然后解锁相应的功能。
• 对于订阅商品：确认购买（插件会自动处理），然后授予用户订阅权益。

插件在初始化时会自动查询未处理的购买，并触发相应的事件。您应该在 OnPurchaseCompleted 事件中处理这些未完成的购买。

Apple 提供了沙盒环境，您可以创建测试账号，并使用测试卡进行购买测试，而不会产生实际费用。详情请参考 Apple App Store 测试应用内购买。

---

如有任何问题或建议，请联系开发者。