简介
华为应用内支付服务(HUAWEI In-App Purchases)支持3种商品,包括消耗型商品、非消耗型商品和订阅型商品。
- 消耗商品:仅能使用一次,消耗使用后即刻失效,需再次购买。
- 非消耗商品:一次性购买,永久拥有,无需消耗。
- 订阅型商品:用户购买后在一段时间内允许访问增值功能或内容,周期结束后自动续期购买下一期的服务。
本Demo将基于这3种商品来演示华为应用内支付服务的接入过程和功能。
本demo仅演示商品购买过程,并未实际使用购买的商品。
该示例也可以通过HMS Toolkit快速启动运行,且支持各Kit一站式集成,并提供远程真机免费调测等功能。
开发准备
-
检查Android Studio开发环境是否准备就绪。如果是,则使用Android Studio打开示例代码工程路径下的build.gradle文件。
-
在AppGallery Connect中创建应用并配置应用信息。target=https%3A%2F%2Fdeveloper.huawei.com%2Fconsumer%2Fcn%2Fdoc%2Fdevelopment%2FHMSCore-Guides%2Fconfig-agc-0000001050033072)。
-
在AppGallery Connect中添加商品信息。
-
在Android Studio中导入demo,再进行构建。
-
配置示例代码:
- 在AppGallery Connect中下载应用的agconnect-services.json文件,把该文件添加至本demo的应用根目录(\app)中。
- 添加证书文件,在应用级build.gradle文件中添加配置。
- 修改示例工程中应用级build.gradle文件中的applicationId为您自己的应用包名。
- 将CipherUtil类中的PUBLIC_KEY替换为创建应用的公钥。获取公钥详情,参考查询支付服务信息。
- 将本demo中的商品替换为你的商品。
-
在Android设备或模拟机上运行该示例代码。
环境要求
- JDK 1.8及以上版本
- 安装Android Studio 3.6.1及以上版本
运行结果
Demo运行后,会出现如下页面。
购买消耗型商品
以游戏中的gem,演示消耗型商品购买。
-
点击Consumable products,可以看到购买消耗型商品的主页。调用
obtainProductInfo
接口,获取此类商品的详细信息。 -
点击5 gems,Demo会调用
createPurchaseIntent
接口,跳转至华为应用内支付收银台。 -
付款成功后,Demo会增加用户的钻石数量,然后调用
consumeOwnedPurchase
接口,通知华为应用内支付服务端用户已完成消耗。注意:如果付款成功后出现异常(如网络错误或流程终止),Demo将在您重新进入页面时尝试更新钻石数量。(调用
obtainOwnedPurchases
接口,获取已购消耗型商品的购买数据。调用consumeOwnedPurchase
接口,消耗该商品。) -
点击History,Demo会调用
obtainOwnedPurchaseRecord
接口,获取购买历史。
购买非消耗型商品
Demo以hidden level商品为例,演示非消耗型商品购买。
-
点击Non-consumable product,可以看到购买非消耗型商品的主页。调用
obtainOwnedPurchases
接口,获取非消耗型商品。 -
如果你还没购买hidden level,可以看到如下图所示页面。点hidden level,开始购买,步骤和购买消耗型商品一致。
-
购买成功后(或之前已购买hidden level商品),Demo将显示hidden level已经购买。
鸿蒙开发知识更新在gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
前往参考。
购买订阅型商品
Demo以Service-One和Service-Two为订阅群组进行演示,每个订阅组包含2个订阅选项。
-
点击Auto-renewable subscription,可以看到订阅型商品的主页。调用
obtainOwnedPurchase
接口,获取购买的订阅商品信息。用户已订阅的商品将显示为ACTIVE。 -
点击其中一个BUY按钮,Demo将调用
createPurchaseIntent
接口,开始购买。注意:目前订阅商品付款方式仅支持支付宝。
-
系统将提示您授权自动扣费协议。购买成功后,华为应用内支付服务将显示购买结果。
-
点击Manage Subscription,演示应用将跳转至订阅管理页面。该页面显示所有订阅商品,包括已过期的商品。
-
在订阅管理页面点击Happy Subscribe,可以编辑订阅商品,选择同一订阅组中的其他订阅商品,或点击UNSUBSCRIBE,取消订阅该商品。订阅商品在到期前一直有效。