簡(jiǎn)介

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

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

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

本demo僅演示商品購(gòu)買(mǎi)過(guò)程，并未實(shí)際使用購(gòu)買(mǎi)的商品。

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

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

1. 檢查Android Studio開(kāi)發(fā)環(huán)境是否準(zhǔn)備就緒。如果是，則使用Android Studio打開(kāi)示例代碼工程路徑下的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)中。
   • 添加證書(shū)文件，在應(yīng)用級(jí)build.gradle文件中添加配置。
   • 修改示例工程中應(yīng)用級(jí)build.gradle文件中的applicationId為您自己的應(yīng)用包名。
   • 將CipherUtil類(lèi)中的PUBLIC_KEY替換為創(chuàng)建應(yīng)用的公鑰。獲取公鑰詳情，參考查詢(xún)支付服務(wù)信息。
   • 將本demo中的商品替換為你的商品。
6. 在Android設(shè)備或模擬機(jī)上運(yùn)行該示例代碼。

環(huán)境要求

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

運(yùn)行結(jié)果

Demo運(yùn)行后，會(huì)出現(xiàn)如下頁(yè)面。

購(gòu)買(mǎi)消耗型商品

以游戲中的 gem ，演示消耗型商品購(gòu)買(mǎi)。

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

購(gòu)買(mǎi)非消耗型商品

Demo以hidden level商品為例，演示非消耗型商品購(gòu)買(mǎi)。

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

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

購(gòu)買(mǎi)訂閱型商品

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

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

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

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

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

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

   審核編輯 黃宇