快速集成

本文档说明了在Unity游戏中通过now.gg支付快速集成（now.gg Payments Quick Integration）流程实现应用内购买。

提示

快速集成流程简单且快速，仅需最少的代码级修改。但是，如果需要更可控的集成，请参考标准集成（Standard Integration）流程。
目前支持 Unity IAP v4.x.x。对 Unity IAP v5.0.0 的支持即将推出。

下面是标准集成和快速集成的比较：

详情	快速集成	标准集成
集成流程	只有当您的IAP实现基于Unity的 StandardPurchasingModule，才可以使用快速集成流程。	对于所以其他支付集成要求，您都应使用标准集成流程。
可消耗（Consumable）和订阅（Subscription）产品	快速集成流程仅支持一次性可消耗（one-time consumable）产品。	标准集成流程支持一次性消耗品和订阅产品。

下载并导入模块

now.gg支付Unity模块（now.gg Payments Unity module）以Unity包文件 NowGGUnitySdk.unitypackage 的形式提供。

将模块添加到您的Unity工程中：

下载该包，其中包含最新版本的 now.gg Payments Unity 模块。
现在，将该包导入到 Unity 项目中。操作步骤如下：
- 点击 Assets > Import Package > Custom Package。
  - 从系统中选择 NowGGUnitySdk.unitypackage。
- 默认情况下，所有模块都会被选中。取消勾选不需要的模块，然后点击 Import，如下所示：
添加必要的依赖项
- 点击 资源（Assets） > 外部依赖关系管理器（External Dependency Manager） > 安卓解析器（Android Resolver） > 解析（Resolve）
  此操作将使用Unity的外部依赖关系管理器（External Dependency Manager）下载所有所需的依赖关系，并将其添加到工程的 Assets/Plugins/Android 目录中。

重要信息

一旦导入了所有模块文件，一个名为’NowGGSdk‘的文件夹就会添加到工程中。您可以在资源（Assets）文件夹的根目录下找到该文件夹。
请不要修改NowGGSdk文件夹，因为其中包含与now.gg支付相关的所有资源。

实现now.gg支付

当now.gg支付模块导入完成，并且所需依赖项已添加后，可以按照以下步骤在您的应用/游戏中实现now.gg支付。

配置now.gg购买模块（now.gg Purchasing Module）

以下是将now.gg购买模块配置到您应用所需的步骤。

将Unity IAP中使用的标准购买模块（Standard Purchasing Module）StandardPurchasingModule.Instance() 替换为now.gg购买模块 NowGG.Sdk.NowGGPurchasingModule.Instance()。
在初始化支付时，将应用的 PaymentId 传递给now.gg支付模块。
确保您已在nowStudio中添加了所需的应用内产品，并与您的Unity购买模块配置一致。
- 这些应用内产品将展示给用户示用于购买。
- 当前，now.gg IAP仅支持可消耗产品。

以下示例代码展示了这些配置：

public void Start()
 {
  /* 当前代码
  var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance()); 
  */

  // 替换为
  var builder = ConfigurationBuilder.Instance(NowGG.Sdk.NowGGPurchasingModule.Instance());
  
  NowGG.Sdk.NowGGPaymentsSdkManager.Instance.PaymentId = "<your_Payment_ID_here>";
 }

重要信息

将执行初始检查以确保您是正在now.gg平台上初始化now.gg支付服务。
- 如果now.gg IAP不可用，在now.gg支付不支持的情况下将默认返回Unity的 StandardPurchasingModule 实例。
PaymentId 是您应用程序的唯一标识符。
- PaymentId 可在 nowStudio 的应用详细信息部分中找到。了解更多信息

参考资料

Unity IAP – 商店（Stores）

开始集成

测试集成