鴻蒙開發學習：【華為支付服務客戶端案例】

簡介

華為應用內支付服務（HUAWEI In-App Purchases）支持3種商品，包括消耗型商品、非消耗型商品和訂閱型商品。

• 消耗商品：僅能使用一次，消耗使用后即刻失效，需再次購買。
• 非消耗商品：一次性購買，永久擁有，無需消耗。
• 訂閱型商品：用戶購買后在一段時間內允許訪問增值功能或內容，周期結束后自動續期購買下一期的服務。

本Demo將基于這3種商品來演示華為應用內支付服務的接入過程和功能。

本demo僅演示商品購買過程，并未實際使用購買的商品。

該示例也可以通過HMS Toolkit快速啟動運行，且支持各Kit一站式集成，并提供遠程真機免費調測等功能。

開發準備

1. 檢查Android Studio開發環境是否準備就緒。如果是，則使用Android Studio打開示例代碼工程路徑下的build.gradle文件。
2. 在AppGallery Connect中創建應用并配置應用信息。target=https%3A%2F%2Fdeveloper.huawei.com%2Fconsumer%2Fcn%2Fdoc%2Fdevelopment%2FHMSCore-Guides%2Fconfig-agc-0000001050033072)。
3. 在AppGallery Connect中添加商品信息。
4. 在Android Studio中導入demo，再進行構建。
5. 配置示例代碼：
   • 在AppGallery Connect中下載應用的agconnect-services.json文件，把該文件添加至本demo的應用根目錄(app)中。
   • 添加證書文件，在應用級build.gradle文件中添加配置。
   • 修改示例工程中應用級build.gradle文件中的applicationId為您自己的應用包名。
   • 將CipherUtil類中的PUBLIC_KEY替換為創建應用的公鑰。獲取公鑰詳情，參考查詢支付服務信息。
   • 將本demo中的商品替換為你的商品。
6. 在Android設備或模擬機上運行該示例代碼。

環境要求

• JDK 1.8及以上版本
• 安裝Android Studio 3.6.1及以上版本

運行結果

Demo運行后，會出現如下頁面。

購買消耗型商品

以游戲中的 gem ，演示消耗型商品購買。

1. 點擊 Consumable products ，可以看到購買消耗型商品的主頁。調用obtainProductInfo接口，獲取此類商品的詳細信息。
   
2. 點擊 5 gems ，Demo會調用createPurchaseIntent接口，跳轉至華為應用內支付收銀臺。
   
3. 付款成功后，Demo會增加用戶的鉆石數量，然后調用consumeOwnedPurchase接口，通知華為應用內支付服務端用戶已完成消耗。
   
   注意：如果付款成功后出現異常（如網絡錯誤或流程終止），Demo將在您重新進入頁面時嘗試更新鉆石數量。（調用obtainOwnedPurchases接口，獲取已購消耗型商品的購買數據。調用consumeOwnedPurchase接口，消耗該商品。）
4. 點擊 History ，Demo會調用obtainOwnedPurchaseRecord接口，獲取購買歷史。
   

購買非消耗型商品

Demo以hidden level商品為例，演示非消耗型商品購買。

1. 點擊 Non-consumable product ，可以看到購買非消耗型商品的主頁。調用obtainOwnedPurchases接口，獲取非消耗型商品。
2. 如果你還沒購買 hidden level ，可以看到如下圖所示頁面。點 hidden level ，開始購買，步驟和購買消耗型商品一致。
   
3. 購買成功后（或之前已購買hidden level商品），Demo將顯示hidden level已經購買。
   

鴻蒙開發知識更新在[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]前往參考。

購買訂閱型商品

Demo以Service-One和Service-Two為訂閱群組進行演示，每個訂閱組包含2個訂閱選項。

1. 點擊 Auto-renewable subscription ，可以看到訂閱型商品的主頁。調用obtainOwnedPurchase接口，獲取購買的訂閱商品信息。用戶已訂閱的商品將顯示為ACTIVE。
   

2. 點擊其中一個BUY按鈕，Demo將調用createPurchaseIntent接口，開始購買。
   
   注意：目前訂閱商品付款方式僅支持支付寶。

3. 系統將提示您授權自動扣費協議。購買成功后，華為應用內支付服務將顯示購買結果。
   

4. 點擊 Manage Subscription ，演示應用將跳轉至訂閱管理頁面。該頁面顯示所有訂閱商品，包括已過期的商品。
   

5. 在訂閱管理頁面點擊 Happy Subscribe ，可以編輯訂閱商品，選擇同一訂閱組中的其他訂閱商品，或點擊 UNSUBSCRIBE ，取消訂閱該商品。訂閱商品在到期前一直有效。
   

   審核編輯 黃宇