Skip to main content

5章 課金機能を実装する

info

本チュートリアルで作成するサンプルコードは Unity Tutorial Sample Download からダウンロードできます。

warning

Android ゲームポイント対応に伴い、Android の場合、Mobage 配信版では『モバコイン』、Google Play 配信版は『ゲームポイント』となります。詳細は以下 URL をご確認ください。

https://docs.mobage.com/display/JPSA/AndroidGPUnity

モバゲーのアプリケーションでは課金機能が大きく

の機能に分かれています。

IAB / IAP を利用した モバコイン / ゲームポイント の購入​

IAB / IAP の実装は Mobage Native SDK 内に実装されていますのでクライアントアプリケーションを開発する際には、Mobage Native SDK を導入するのみとなります。 独自に IAB / IAP の実装は行わないでください 。

info

IAB : Android In-App Billing による決済サービス
IAP : iOS In-App Purchase による決済サービス

Unity​

Unity で モバコイン / ゲームポイント の購入画面を表示させるには下記のように実装を行います。

MobageService.showBankUI(
() => {
print("onDismiss showBankUI");
// ゲームポイント購入後の処理を実装する。
// getBalance API を使用して、ゲームポイントの残高を更新する。
}
);

また、Android / iOS での挙動は下記のようになります。

note

下記を展開すると詳細が表示されます。

Android での動作

info

本チュートリアルで作成するサンプルコードは Unity Tutorial Sample Download からダウンロードできます。

warning

Production 環境でのモバコイン利用は基本的に禁止となります。『ゲームポイント』をご利用ください。詳細は以下 URL をご確認ください。

https://docs.mobage.com/display/JPSA/AndroidGPUnity

Sandbox 環境でのモバコイン付与​

note

Sandbox 環境では IAB のテストを行う事はできません。また、アイテム課金テストの為にはモバコインが必要です。

Android で showBankUI を行うと、下記のような画面が表示されます。
 

 
付与するモバコイン数を選択して "コインを足す" を押下するとテスト用のモバコインを付与する事ができます。ゲームに戻るには画面下部の "ゲームにもどる" を押下してください。ゲームに戻った際に上記コードの onDismiss() メソッドが呼び出されます。

iOS での動作

info

本チュートリアルで作成するサンプルコードは Unity Tutorial Sample Download からダウンロードできます。

Sandbox 環境でのゲームポイント入手方法​

iOS で showBankUI を行うと、下記のような画面が表示されます。
 

 
テスト用のゲームポイントを付与する際は "VirtualCurrency付与" を選択し、下記画面を開きます。
 

アプリケーションを選択して "Add" を押下するとテスト用のゲームポイントを付与する事ができます。ゲームに戻るには画面下部の "ゲームにもどる" を押下してください。ゲームに戻った際に上記コードの onDismiss() ブロックが呼び出されます。また、iOS アプリケーションの場合 Apple Sandbox にて IAP のテスト購入を行う事ができます。IAP のテストを行う為にはiTunes Connect への登録、Mobage Developers に IAP の情報を設定、Xcode の設定を行う必要が有ります。正常に登録・設定が完了している場合は下記のようにゲームポイントを購入する事ができます。
 

Production 環境でのゲームポイント購入方法​

Production 環境でも Sandbox 環境の場合と同様の実装を行う事でゲームポイントの購入画面を表示させる事ができますが IAP 関連の設定を一切行っていないため下記のような画面が表示されます。


 
Sandbox 環境と同様に IAP のテストを行う為にはiTunes Connect への登録、Mobage Developers に IAP の情報を設定、Xcode の設定を行う必要が有ります。正常に登録・設定が完了している場合は下記のようにゲームポイントを購入する事ができます。

iOS の設定・注意点

info

本チュートリアルで作成するサンプルコードは Unity Tutorial Sample Download からダウンロードできます。

iTunes Connect への登録​

iTunes Connect へアプリケーションの登録手順は下記となります。

  1. iTunes Connect へアクセス
  2. (初回必須)Contacts, Tax, and Banking の設定
  3. アプリケーションの登録
  4. [In App Purchase の登録](../../../Native/Topic_Native/How_to_Upload_Your_Application_to_iTunes_Connect_Native/#HowtoUploadYourApplicationtoiTunesConnect_ja-InAppPurchase の登録)

また、Apple Sandbox で課金を行う為には専用のテストユーザーを作成する必要が有ります。テストユーザーの作成手順は下記となります。

  1. Test User の登録

アプリケーションの登録とテストユーザーの作成が完了したら、iOS 端末から iTunes Store & App Store にテストユーザーでログインします。

  1. Test User を用いた課金テストの手順

上記手順が完了すると iTunes Connect の "Manage Your Apps" > "登録したアプリケーション" で登録した情報が確認できますので下記情報をメモしてください。

  • "App Information" > "Identifiers" の Bundle ID

  • "Manage In-App Purchases" > 各 Item の Puroduct ID

  • "Manage In-App Purchases" > 各 Item の Tier

  • "Manage In-App Purchases" > 各 Item の Display Name

    IAP 登録サンプル​
    Bundle IDcom.mobage.example
    Product IDTierDisplay Name
    com.mobage.example.Tier1Tier1TP-Aセット
    com.mobage.example.Tier2Tier2TP-Bセット
    com.mobage.example.Tier3Tier3TP-Cセット
    com.mobage.example.Tier60Tier60TP-Dセット
    info

Display Name は課金時のダイアログに表示されます。 :::

Mobage Developers に IAP の情報を登録​

iTunes Connect への登録が完了したら、次に Mobage Developers に iTunes Connect に登録した値を設定します。
ダッシュボード > アプリケーション > MobageExample > Mobage > iOS タブ > 情報を変更
を選択して下記画面を開きます。
 

 
各項目に先程メモした情報を記述します。

項目設定値
CFBundleIdentifiercom.mobage.example
Tier項目設定値
Tier1Product IDcom.mobage.example.Tier1
Display NameTP-Aセット
Tier2Product IDcom.mobage.example.Tier2
Display NameTP-Bセット
Tier3Product IDcom.mobage.example.Tier3
Display NameTP-Cセット
Tier60Product IDcom.mobage.example.Tier60
Display NameTP-Dセット
項目設定値
ゲームポイント名称TestPoint
ゲームポイント単位TP
info

ゲームポイント名称/単位は showBankUi 時に表示されます。

入力が完了したらページ最下部の "入力内容確認" を押下し内容を確認後 "この内容で登録する >>" を押下して登録を完了させてください。
 

Xcode の設定​

最後に Xcode の設定を行います。
プロジェクト > TARGETS (MobageExample) > Info > Custom iOS Target Properties を開き下記画面を表示させてください。
 

 
Bundle identifier を iTunes Connect の Bundle ID (Mobage Developers の CFBundleIdentifier) に設定した値に書き換えます。
 

 
次に、プロジェクト > TARGETS (MobageExample) > Build Settings を選択し "Code Signing" で検索し下記画面を表示させます。
 

 
Provisioning Profile で Bundle identifier に対応した Provisioning Profile を選択します。

エラーチェックポイント​

「Unknown key iTunes Storeに接続できません。ネットワーク接続を確認してください。」
「システムエラー 商品情報が見つかりません。管理者にお問い合わせください。」
「テストユーザーアカウントではありません。 Sandbox 環境で新規アカウントを作成してください。」
などと表示される場合は

のいずれかの設定に間違いがある可能性が高いです。下記に間違えやすいチェックポイントをまとめましたのでご確認ください。

テストユーザー関連​
  • テストユーザーでログインしているか
  • テストユーザーは Japan App Store に設定されているか
  • Japan App Store にログインしているか
Provisioning Profile 関連​
  • Provisioning Profile の Bundle identifier と Mobage Developers の CFBundleIdentifier、iTunes Connect の Bundle ID が一致しているか
  • Provisioning Profile は Developer 用か(App Store 用ではデバックで来ません)
Product ID 関連​
  • iTunes Connect に設定した Product ID と Mobage Developers の Product ID は一致しているか
  • Tier が一致しているか
その他​
  • iOS シミュレーターでは動作しませんので実機でご確認ください

モバコイン / ゲームポイント を消費してゲーム内アイテムの購入​

モバコイン / ゲームポイント を消費してゲーム内のアイテムを購入する処理は Mobage Unity SDK, RESTful API を利用してクライアントアプリケーションと Game Server で実装を行います。実装方法は下記をご参考ください。

更新履歴​

  • 2014/02/18
    • 初版作成
  • IAB / IAP を利用した モバコイン / ゲームポイント の購入
    • Unity
  • Sandbox 環境でのモバコイン付与
  • Sandbox 環境でのゲームポイント入手方法
  • Production 環境でのゲームポイント購入方法
  • iTunes Connect への登録
  • Mobage Developers に IAP の情報を登録
  • Xcode の設定
  • エラーチェックポイント
  • モバコイン / ゲームポイント を消費してゲーム内アイテムの購入
  • 更新履歴