Google Play 应用内支付集成指南

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

目录

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

概述

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

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

前提条件

1. Unity 2019.4 或更高版本
2. Android 构建支持
3. Google Play 开发者账号
4. 在 Google Play Console 中配置好的应用内商品

集成步骤

1. 导入插件

将 GooglePlayBilling.cs 和相关文件导入到您的 Unity 项目中。

2. 配置 AndroidManifest.xml

确保您的 AndroidManifest.xml 包含以下权限：

<uses-permission android:name="com.android.vending.BILLING"/>

3. 配置 Gradle 构建文件

确保您的 Gradle 构建文件包含 Google Play Billing 库依赖：

dependencies {
    implementation 'com.android.billingclient:billing:8.0.0'
}

4. 在 Unity 中使用

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

// 获取 GooglePlayBilling 实例
GooglePlayBilling billingManager = GooglePlayBilling.Instance;

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

// 初始化
billingManager.Initialize();

API 说明

初始化

// 初始化 Google Play Billing
GooglePlayBilling.Instance.Initialize();

查询商品

// 查询一次性商品
GooglePlayBilling.Instance.QueryProductDetails("product_id_1,product_id_2", "inapp");

// 查询订阅商品
GooglePlayBilling.Instance.QueryProductDetails("subscription_id_1,subscription_id_2", "subs");

购买商品

// 购买一次性商品
GooglePlayBilling.Instance.Purchase("product_id", "inapp");

// 购买订阅商品
GooglePlayBilling.Instance.Purchase("subscription_id", "subs");

// 购买带优惠的订阅商品
GooglePlayBilling.Instance.PurchaseWithOffer("subscription_id", "subs", "offer_token");

消耗购买

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

查询购买历史

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

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

使用示例

请参考 GooglePlayBillingExample.cs 文件，其中包含了完整的使用示例，包括：

• 初始化 Google Play Billing
• 查询商品详情
• 购买商品
• 消耗购买
• 查询购买历史

常见问题

1. 如何区分消耗型商品和非消耗型商品？

在 Google Play Console 中，您可以将商品配置为「消耗型」或「非消耗型」。在代码中，您可以通过商品 ID 的前缀或其他方式来区分它们。例如，在本插件中，我们约定以 consumable_ 开头的商品 ID 为消耗型商品。

2. 购买成功后如何处理？

购买成功后，您应该：

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

3. 如何处理未完成的购买？

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

4. 如何测试应用内购买？

Google Play 提供了测试环境，您可以添加测试账号，并使用测试卡进行购买测试，而不会产生实际费用。详情请参考 Google Play 测试应用内购买。

---

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