gdx-pay - libGDX跨平台应用内购买API

本项目旨在提供一个跨平台的应用内购买API。 gdx-pay项目是libGDX的一个扩展。当前发布版本为1.3.7。请使用至少libGDX v1.9.8或Robovm 2.3.5。

SNAPSHOT版本定期发布在https://oss.sonatype.org/content/repositories/snapshots/。

支持的支付服务

Google Play (Android): googlebilling
Amazon IAP (Android): amazon
华为 (Android): huawei
苹果 (iOS): RoboVM

点击链接查看各子项目的readme文件，了解服务相关信息和构件。

安装

推荐通过Gradle或Maven进行依赖管理来使用gdx-pay。构件可在Maven Central找到。

project-root/build.gradle:

ext {
    gdxPayVersion = '1.3.7'
}

添加以下依赖：

core:

    implementation "com.badlogicgames.gdxpay:gdx-pay-client:$gdxPayVersion"

html:

    implementation "com.badlogicgames.gdxpay:gdx-pay:$gdxPayVersion:sources"
    implementation "com.badlogicgames.gdxpay:gdx-pay-client:$gdxPayVersion:sources"

还需要在html项目的GdxDefinition.gwt.xml文件中添加以下内容：

    <inherits name="com.badlogic.gdx.pay_client"/>

这就是在核心项目中使用gdx-pay所需的全部内容。当然，你可能想在游戏中使用特定的IAP服务。请查看上面链接的服务子项目readme文件。

使用方法

与支付服务通信的主要接口是PurchaseManager。在主游戏类中添加一个字段来持有它：

public PurchaseManager purchaseManager;

在启动器类中，实例化你想使用的支付服务的PurchaseManager：

game.purchaseManager = new DesiredPlatformPurchaseManager(...);

查看上面链接的所需支付服务文档，了解如何实例化其PurchaseManager实现。

配置

在使用PurchaseManager进行支付之前，需要先安装它：你需要提供一个实现PurchaseObserver接口的回调监听器和一个配置。通常，配置只是传递你想提供的商品：

PurchaseManagerConfig pmc = new PurchaseManagerConfig();
pmc.addOffer(new Offer().setType(OfferType.ENTITLEMENT).setIdentifier(YOUR_ITEM_SKU));
pmc.addOffer(new Offer().setType(OfferType.CONSUMABLE).setIdentifier(YOUR_ITEM_SKU));
pmc.addOffer(new Offer().setType(OfferType.SUBSCRIPTION).setIdentifier(YOUR_ITEM_SKU));
// 某些支付服务可能需要特殊参数，请查看文档
pmc.addStoreParam(storename, param)

purchaseManager.install(new MyPurchaseObserver(), pmc, true);

当PurchaseManager成功安装后，你的PurchaseObserver将收到回调，并且purchaseManager.installed()将返回true。根据支付服务的不同，这可能需要几秒钟的时间。现在你可以请求信息或购买商品了。

如果你完全不再需要PurchaseManager，调用它的dispose()方法。

请求商品信息

了解您添加到配置中的哪些项目在什么价格下可用很重要。使用getInformation()来检索项目的Information对象以获取这些信息：

Information skuInfo = purchaseManager.getInformation(sku);
if (skuInfo == null || skuInfo.equals(Information.UNAVAILABLE)) {
   // 该项目不可用...
   purchaseButton.setDisabled(true);
} else {
   // 启用购买按钮并设置其价格标签
   purchaseButton.setText(skuInfo.getLocalPricing());
}