鴻蒙開發(fā)學(xué)習(xí)：【華為支付服務(wù)客戶端案例】

簡介

華為應(yīng)用內(nèi)支付服務(wù)（HUAWEI In-App Purchases）支持3種商品，包括消耗型商品、非消耗型商品和訂閱型商品。

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

本Demo將基于這3種商品來演示華為應(yīng)用內(nèi)支付服務(wù)的接入過程和功能。

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

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

開發(fā)準(zhǔn)備

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

環(huán)境要求

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

運行結(jié)果

Demo運行后，會出現(xiàn)如下頁面。

購買消耗型商品

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

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

購買非消耗型商品

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

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

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

購買訂閱型商品

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

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

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

3. 系統(tǒng)將提示您授權(quán)自動扣費協(xié)議。購買成功后，華為應(yīng)用內(nèi)支付服務(wù)將顯示購買結(jié)果。
   

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

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

   審核編輯 黃宇