Android

HOME
Android
Android アプリ内課金を使って無料版アプリをプレミアム版にアップグレードするアプリを開発する手順

2014年3月1日 / 最終更新日 : 2014年3月1日矢木浩人 Android

Android アプリ内課金を使って無料版アプリをプレミアム版にアップグレードするアプリを開発する手順

Google Play In-app Billing

1.概要

Google Play のサービスで、アプリケーション内からデジタルコンテンツを販売出来る。

ダウンロード可能な写真のようなものから、ゲームのレベルや機能などの仮想コンテンツまで幅広いコンテンツを販売出来る。

販売方法には

標準型(one-time billing)
購読型(recurring, automated billing)

があり、どちらの方法でも、Google Play が管理するためアプリケーションが直接金銭取引に関与する必要はない。バックエンドサービスが購買に利用される。

Google Play を通して公開されているアプリケーションならこれらを行うことができる。

行うのには、Google Play Developer アカウントおよび Google Wallet マーチャントアカウント以外に特別なアカウントは必要ない。

2.準備

2.1 サービスインターフェースの追加

IInAppBillingService.aidl をアンドロイドプロジェクトに追加する必要がある。

Android SDK Managerを立ち上げて、Extras の中にある、Google Play Billing Library にチェックを入れてインストールを実施

インストールが完了すると、<sdkディレクトリ> の以下のフォルダに、IInAppBillingService.aidlがあるので、自分のプロジェクトに取り込む。

<sdkディレクトリ>\extras\google\play_billing\samples\TrivialDrive\src\com\android\vending\billing

Eclipse の場合、src ディレクトリに com\android\vending\billing というパッケージが作成されるようにインポートすればよい。

取り込んだあとは、以下のように com\android\vending\billing と、自分のアプリ(info\typea\eitangoroid2) がsrc ディレクトリに並ぶ形になる。

また、gen ディレクトリ配下の com\android\vending\billing に、IInAppBillingService.java が自動生成される。

2.2 ヘルパークラスの取り込み

また上記ライブラリをインストールすると、サンプルアプリケーション TrivialDrive が、以下のフォルダに含まれている。(新規にアプリを作成する場合、これをリファクタリングで名前変更すればよいようだ)

<SDKディレクトリ>extras\google\play_billing\samples\TrivialDrive\src\com\example\android\trivialdrivesample

この中の util ディレクトリにヘルパークラスが含まれているので、フォルダごと自分のアプリケーションに取り込む。自分はすでにutil パッケージが存在したので、配下に billing パッケージを作成しその中にクラス群を取り込んだ。

取り込んだ後、取り込んだクラスのパッケージを適宜変更する。

2.3 ライセンスキー

ここまでで、一旦APKファイルを作成し、アップロードすると、アプリ内課金を行うのに必要な、ライセンスキーが得られる、これはデベロッパーコンソールの、サービスとAPIに記載されている。

このライセンスキーをプログラムにハードコーディングしないことをセキュリティ的に強く推奨されている。

ライセンスキー全体を、部分から実行時に生成するか、暗号化しておくことが推奨されているので、Base64 風のでたらめな文字列の中にライセンスキーを埋め込み、実行時に取り出すようにしてみる。

以下は、PythonででたらめなBase64風文字列を作成する例。実行時に特定の位置を切り出して利用するようにしてみる。

>>> import string
>>> from random import choice
>>> print "".join([choice(string.ascii_lowercase + string.ascii_uppercase + string.digits + '+/') for i in range(200)])
b7XWPqVG0+FWMDWqJui8qI9f400dUMm3mzATE4ToLAKMK3sWTU3nnnF6GkepBlnh8P+nQMDL/PmJJLajB6EnouXl1KleMsgMro1mshOnbOm/JwprEb55c2al3sodwqWIRNRYVJHvIjmjH4jP9dzYfhkkOCM7CAV+ncvU1uErSvYzb+lf9O9py0ad20vVgyElXTzD2rt8

2.4 パーミッション設定

以下のパーミッションを AndroidManifest.xml に追加

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

3.Google Playとの接続

Google Play と接続するために、アプリ内課金リクエストをGoogle Play へアプリケーションから送信する必要がある。上記で取り込んだ、util パッケージにヘルパークラスがあり、同期接続を行うには、 IabHelper クラスのインスタンス化を Activity の onCreate で行う

3.1 Google Play のアプリ内課金サービスに接続する例

onCreate() で接続

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    
    String publicKey = getString(R.string.publicKey);
    billingHelper = new IabHelper(
                        this, 
                        publicKey.substring(111 /*キーの前に付与したダミーの桁*/,
                            publicKey.length()-999 /*キーの後ろに付与したダミーの桁*/));
    // 製品版の場合、false とする
    billingHelper.enableDebugLogging(true);
    billingHelper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
           public void onIabSetupFinished(IabResult result) {
              if (!result.isSuccess()) {
                 Log.d(Eitangoroid2Application.TAG, "Problem setting up In-app Billing: " + result);
              }            
                 // Hooray, IAB is fully set up!  
           }
        });
}

onDestroy() で破棄する

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

一旦、実行すると接続に成功したことを LogCatで確認出来た。

4.商品の登録

Google Play に接続までできたので、実際に販売する商品を登録する必要がある。

登録はデベロッパーコンソールから行う。

アプリ内アイテムを選択し

新しいアイテムを追加

今回は、無料版をアップグレードさせるつもりなので、管理対象のアイテムを選び、ユニークなアイテムIDを登録する。このIDは後で変更出来ないとのこと。

アプリ内サービスIDのガイドライン

サービス ID は、同じアプリのすべてのアイテムにわたって固有でなければならず、後で再利用することもできません。

とりあえず、適当に説明を書いて保存する。

5.製品の問い合わせ

作成した商品をGoogle Play に問い合わせてみる。先ほど、onCreate() に追加したブロックから、queryInventoryAsync() を使って問い合わせ。結果はmGotInventoryListener で受け取る。

SKU_PREMIUM_UPGRADE は、商品に付与したサービスID。

billingHelper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
       public void onIabSetupFinished(IabResult result) {
          if (!result.isSuccess()) {
             Log.d(Eitangoroid2Application.TAG, "Problem setting up In-app Billing: " + result);
          }            
          Log.d(Eitangoroid2Application.TAG, "// Hooray, IAB is fully set up!  : " + result);
          
          billingHelper.queryInventoryAsync(
                  true, 
                  Arrays.asList(new String[]{SKU_PREMIUM_UPGRADE}),
                  mGotInventoryListener);   
       }
    });

結果を受け取ることができたらログに出力。

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

      if (result.isFailure()) {
          // handle error here
          return;
      }
      else {
          // does the user have the premium upgrade?
          //mIsPremium = inventory.hasPurchase(SKU_PREMIUM);        
          // update UI accordingly
          SkuDetails skuDetails = inventory.getSkuDetails(SKU_PREMIUM_UPGRADE);
          if (skuDetails == null) {
              Log.i(Eitangoroid2Application.TAG,"skuDetails is null");
          } else {
              Log.i(Eitangoroid2Application.TAG, 
                      String.format("%s %s", skuDetails.getDescription(),skuDetails.getPrice()));
          }
          isPremium = inventory.hasPurchase(SKU_PREMIUM_UPGRADE);
      }
   }
};

アプリを実行し、LogCatで商品情報が取得できたことを確認。

6.製品の購入

製品購入のコードを書く。自アプリでは、onOptionItemSelected で購入させる。launchPurchaseFlow()を呼び出す。下例で、10001 としている箇所には、任意の数値を指定すると、Google Playがこの値を結果として返してくる。

@Override
public boolean onOptionsItemSelected(MenuItem item) {
 
 boolean ret = true;
 switch(item.getItemId()) {
 case R.id.action_upgrade:
     billingHelper.launchPurchaseFlow(
             this, 
             SKU_PREMIUM_UPGRADE, 
             10001, 
             mPurchaseFinishedListener);
     
     break;
 default:
     ret =  super.onOptionsItemSelected(item);
 }
 return ret;
}

// TODO に、購入が成功した場合のコードを記述する

IabHelper.OnIabPurchaseFinishedListener mPurchaseFinishedListener 
   = new IabHelper.OnIabPurchaseFinishedListener() {
   public void onIabPurchaseFinished(IabResult result, Purchase purchase) 
   {
      if (result.isFailure()) {
         Log.d(Eitangoroid2Application.TAG, "Error purchasing: " + result);
         return;
      } else if 
          (purchase.getSku().equals(SKU_PREMIUM_UPGRADE)) {
          
         // TODO
      }
   }
};