Android 實作 IAP 內購式商品 (Selling In-app Products)(2/2)

In-app Billing

本篇文章使用 Version 3 API。本篇為實戰篇，概念篇請看 In-app Billing(App內付款) 概念。

準備要使用 In-app Billing 的應用程式

下載 Library

打開 Android SDK Manager，拉到最下方的 Extras，找到 Google Play Billing Library 勾選後安裝。之後就會在你的 Android SDK 目錄中找到該 Library，位置如下：

/{你的SDK目錄}/extras/google/play_billing/in-app-billing-v03

在開發者控制台新增 App

當你在開發者控制台新增一個 App 時，會產生一個公開金鑰，只有在第一次建立 App 時才需要產生這個金鑰，之後會用在你的 App 裡，用來和 Google Play 通訊。

執行步驟：

1. 登入開發者控制台，你必須同時擁有 Google Checkout 帳戶。
2. 點選"體驗新版介面"進入新的開發者控制台。
3. 在"所有應用程式"頁面中，
   1. 點選"新增應用程式"
   2. 輸入應用程式名稱
   3. 點選"準備商店資訊"
4. 在"服務和API"頁面，記下由 Google Play 產生的 public license key，必須在應用程式中加入這組鑰匙。

在專案中加入 In-app Billing Library

要使用 Version 3 API 必須在專案中加入 IInAppBillingService.aidl 檔，透過它來和 Google Play 服務溝通。這個檔案可以在之前下載的 Library 中找到。以下選擇一種情況來使用，是新專案或在已有專案中使用。

新專案的執行步驟：

1. 在 Eclipse 中 Import -> Android -> Existing Android Code Into Workspace，找到 Library 目錄中的 in-app-billing-v03/samples 目錄之下的 TrivialDrive，將它滙入 Eclipse 專案中。在該專案按右鍵，Refactor -> Rename 改成你的專案名稱。
2. 打開 AndroidManifest.xml 檔，修改 Package 屬性的值為你自己的專案。
3. 接下要修正程式碼中的 Import 部份。
4. 將在開發者控制台取得的 Public Key 加到 MainActivity.java 中。

現有專案的執行步驟：

1. 複製 IInAppBillingService.aidl 檔案到你的專案(在Eclipse 中 Import 到 /src 目錄)。
2. 建置(Buile)你的專案，應該會在 /gen 目錄中看到自動產生的 IInAppBillingService.java。
3. 在專案中加入 Sample 專案中 /util 目錄下的所有檔案，記得修改 package 名稱。

設定權限

在 AndroidManifest.xml 中的 permission 加入：

<uses-permission android:name="com.android.vending.BILLING" />

連結到 Google Play

你必須綁定 (bind) Activity 到 Google Play 的 In-app Billing 服務，利用它來送出請求給 Google Play。在範例檔中提供了數個簡便的類別，去掌控綁定到 In-app Billing 服務的任務，所以你不必去處理網路連線的問題。

在 onCreate 中建立一個 IabHelper 物件，用來設定和 Google Play 的同步通訊。

安全性建議：強烈建議不要直接把 Public Key 寫在程式碼中，而應該在執行時期從加密過的字串中取得。這可避免被惡意的修改APK檔中的 Public Key 。

之前在開發者控制台取得 Public Key 就是被編碼過的金鑰，利用 IabHelper 來取得還原後的 Public Key，程式碼如下：

IabHelper mHelper;

@Override
public void onCreate(Bundle savedInstanceState) {
   // ...
   String base64EncodedPublicKey = "被編碼過的 PUBLIC_KEY";

   // compute your public key and store it in base64EncodedPublicKey
   mHelper = new IabHelper(this, base64EncodedPublicKey);
}

接下來處理服務的綁定。呼叫 IabHelper 的 startSetup 方法，因為設定是非同步的，所以要建立一個設定完成的偵聽器，當 IabHelper 設定完成後，該偵聽器會被呼叫。在設定的同時，會一併檢查是否支援 In-app Billing API Version 3，程式碼如下：

mHelper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
   public void onIabSetupFinished(IabResult result) {
      if (!result.isSuccess()) {
         // Oh noes, there was a problem.
         Log.d(TAG, "Problem setting up In-app Billing: " + result);
      }            
         // Hooray, IAB is fully set up!  
   }
});

如果設定成功，就可使用 mHelper(IabHelper) 和 Google Play 服務做溝通。可以在 App 啟動時去查詢使用者擁有哪些內購式商品，然後記得在結束 Activity 時，要去釋放 mHelper ，如下：

@Override
public void onDestroy() {
   if (mHelper != null) mHelper.dispose();
   mHelper = null;
}

建立可以讓 App 內購的商品

在開發者控制台建立可被購買的數位商品，步驟如下：

1. 建立一個簽名(signed)過的APK檔，也就可以發佈到 Google Play 的應用程式。
2. 在開發者控制台打開你早先建立的應用程式。
3. 切換到 APK 頁面，然後上傳簽名過的 APK 檔，BUT！暫時不要發佈。
4. 切換到"應用程式內產品"頁面。
5. 點選"新增產品"，選擇"商品類型"，輸入產品 ID，這個 ID 就是 SKU，是個唯一值不能重覆。
6. 完成產品資訊的填寫並儲存後，將它啟用。現在你的 App 就可以購買該商品了。

查詢可購買的商品

你可以在程式碼中撰寫查詢和這個 App 相關的商品資訊，包含產品名稱、類型、說明和價格，這可讓你列出使用者尚未擁有並可購買的商品清單。
當要執行查詢時，必須明確指定產品ID，可以在開發者控制台的"應用程式內產品"頁面看到產品清單，在"名稱/ID"這個欄位即為該產品的ID。
要取得產品資料可以使用 mHelper(IabHelper) 物件的 queryInventoryAsync(boolean, List, QueryInventoryFinishedListener) 方法。

• 參數1：是否可以檢索產品資料
• 參數2：想要查詢的一個或多個產品的ID
• 參數3：偵聽查詢完成事件

程式碼如下：

List additionalSkuList = new List();
additionalSkuList.add(SKU_APPLE);
additionalSkuList.add(SKU_BANANA);
mHelper.queryInventoryAsync(true, additionalSkuList, mQueryFinishedListener);

如果查詢成功，結果會儲存在 Inventory 物件中回傳給偵聽器。以下程式碼展示如何從結果中取得產品的價格：

IabHelper.QueryInventoryFinishedListener mQueryFinishedListener = new IabHelper.QueryInventoryFinishedListener() {
   public void onQueryInventoryFinished(IabResult result, Inventory inventory)   
   {
      if (result.isFailure()) {
         // handle error
         return;
       }

       String applePrice =
          inventory.getSkuDetails(SKU_APPLE).getPrice();
       String bananaPrice =
          inventory.getSkuDetails(SKU_BANANA).getPrice();

       // update the UI 
   }
}

購買內購式商品

要讓使用者購買某項內購式商品，要在程式內呼叫 mHelper(IabHelper) 物件的 launchPurchaseFlow(Activity, String, int, OnIabPurchaseFinishedListener, String) 方法，必須在 Activity 的主執行緒中呼叫，該方法的參數說明：

• 參數1：目前這個 Activity 本身。
• 參數2：產品ID(SKU)。
• 參數3：請求碼，任意正整數。Google Play 會回傳這個請求碼給 Activity 的 onActivityResult 。
• 參數4：偵聽完成事件。
• 參數5：用來附加其他資訊的字串，可以是空的。好的做法是，傳送一組字串，讓應用程式可以識別這個購買商品的使用者。

使用範例碼：

mHelper.launchPurchaseFlow(this, SKU_GAS, 10001, mPurchaseFinishedListener, "bGoa+V7g/yqDXvKRqq+JTFn4uQZbPiQJo4pf9RzJ");

如果購買成功，Google Play 會將資料儲存在 Purchase 物件中回傳，然後偵聽就會收到，程式碼如下：

IabHelper.OnIabPurchaseFinishedListener mPurchaseFinishedListener = new IabHelper.OnIabPurchaseFinishedListener() {
   public void onIabPurchaseFinished(IabResult result, Purchase purchase) 
   {
      if (result.isFailure()) {
         Log.d(TAG, "Error purchasing: " + result);
         return;
      }      
      else if (purchase.getSku().equals(SKU_GAS)) {
         // consume the gas and update the UI
      }
      else if (purchase.getSku().equals(SKU_PREMIUM)) {
         // give user access to premium content and update the UI
      }
   }
};

為了安全性，建議去檢查回傳的附加字串(參數5)是否相符。

查詢已購買產品

當整個購買流程結束後，購買的資料會被本地端快取，讓應用程式可以頻繁的查詢，例如 App 啟動時，或 resume 時。

查詢時一樣呼叫 mHelper(IabHelper) 物件的方法 queryInventoryAsync(QueryInventoryFinishedListener)，參數是偵聽完成事件的偵聽器。程式碼如下：

mHelper.queryInventoryAsync(mGotInventoryListener);

IabHelper.QueryInventoryFinishedListener mGotInventoryListener = new IabHelper.QueryInventoryFinishedListener() {
   public void onQueryInventoryFinished(IabResult result,
      Inventory inventory) {

      if (result.isFailure()) {
        // handle error here
      }
      else {
        // does the user have the premium upgrade?
        mIsPremium = inventory.hasPurchase(SKU_PREMIUM);        
        // update UI accordingly
      }
   }
};

測試應用程式

因為 Google 不允許使用開發者帳號直接購買內購式商品，所以開發者必須在原本的帳號之下建立一個測試帳號，如此才能購買已上傳但未發佈的 App。

在開發者控制台新增一個(或多個)測試帳號。進入開發者控制台->設定->帳戶詳細資料，找到"授權測試"項目，新增測試用 Gmail 帳戶。

透過 adb 的方式安裝已簽署過的 APK 檔(此APK是已經上傳到開發者控制台的那個)。這裡要注意的是，裝置的 Android 版本必須是 2.2 版 (level 8) 以上，裝置中的 Google Play App 必須是 3.9.16 版以上。

要安裝 APK 到裝置使用以下指令：
adb install apk檔路徑
建議讓環境單純，關掉所有模擬器，只接一台裝置到 usb，使用 adb devices 是否有查到一台裝置，然後再使用上面的指令。

Google 有限制可購買商品的帳號不能是開發者帳號，也就是說如果你用你的開發者帳號去測試購買商品時，會出現"內容發佈者無法購買這項商品"的訊息，你必須使用測試帳號來登入你的裝置，才能用這個測試帳號來購買。我自己的實驗是，手機無解，因為手機不能多帳戶切換，最不麻煩的做法是剛好你朋友有 Android 手機，把它加為測試帳戶，利用它的裝置來測這樣最容易，但他的帳號必須有設定信用卡資料。

然後很重要的事，當你用測試帳戶購買商品成功後，記得在開發者控制台將此次的購買退款，否則這些購買行為都會成立，是要真的付錢的，如果你用朋友的帳戶測試，他應該會殺了你 XD。

參考資料： Selling In-app Products

本文網址：http://blog.tonycube.com/2013/05/android-iap-selling-in-app-products22.html
由 Tony Blog 撰寫，請勿全文複製，轉載時請註明出處及連結，謝謝 😀