【重要】Android ゲームポイント対応について
Android ゲームポイント対応概要
2015 年 12 月初旬より、Mobage Native / Unity SDK for Android、Shell App Framework for Android、Shell App SDK for Android におきまして、Google Play 配信版に限り、モバコインを廃止し、Android ゲームポイントの導入を行います。
Android ゲームポイントの導入は、2015 年 6 月 25 日に Google Play デベロッパープログラムポリシーへ「アプリ内の仮想通貨は、その通貨を最初に購入したアプリ内でのみ使用する必要があります」の条文が追加されたことにより、モバコインがこの条文に該当するためです。
モバコインを廃止し Android ゲームポイントを導入するにあたり、恒久的に以下の対応が必要になります。
- デベロッパーサイトで「Android ゲームポイント」名を設定する必要があります。
- SPWeb 版では「モバコイン」表記、Shell App Framework 版では「Android ゲームポイント」表記となるため、仮想通貨名を出し分ける実装をしなければなりません。
- Android と iOS のゲームポイントは OS をまたいで共通で使用できる仮想通貨ではありません。
- Android アプリのゲームポイントは Android 専用、iOS アプリのゲームポイントは iOS 専用になります。ゲームポイント名称も Android と iOS で別々に異なるものを設定可能です。
- Google Play 配信版の「モバコイン」対応 SDK から「Android ゲームポイント」対応の SDK に入れ替える際のアップデートの注意点については、以下のニュース記事をご確認ください。
デベロッパーサイトでの Android ゲームポイント名の設定方法
「ゲームポイント名称」および「ゲームポイント単位」を設定しないで、Shell App SDK 1.4.0 以降の課金処理を動作させた場合、課金処理が正しく動作しませんのでご注意ください。
デベロッパーサイトより、アプリケーションを選択して Android の「ゲームポイント名称」および「ゲームポイント単位」を設定します。対象アプリケーションの「Android」タブの「項目情報」の「情報を変更」ボタンをクリックしてください。
遷移先画面の「ゲームポイント利用」に「はい」を設定し、「ゲームポイント名称」と「ゲームポイント単位」を設定します。
画面一番下の「入力内容確認」ボタンをクリックし、確認画面に遷移後、「この内容で登録する」ボタンをクリックすると登録完了です。
Android ゲームポイント対応の実装方法
上記対応を行うためには、下記に従い実装を行なってください。今後、常に「モバコイン」と「Android ゲームポイント」の仮想通貨名の出し分け実装が必要になります。
対応 SDK
対応バージョンは Shell App SDK 1.4.0 になります。
Android ゲームポイント表記とモバコインの表記を出し分ける方法
サーバーに仮想通貨名を送信する場合、iOS と Android の判別も行わなくてはならないことにご注意ください。
Shell App SDK には、Mobage 配信版は存在しませんので、SPWeb 版(モバコイン表記)と Shell App SDK(Android ゲームポイント表記)のみ判別を行ない、仮想通貨名の出し分けを行なってください。
また、Shell App SDK には、Shell App SDK のバージョン情報を取得する API が用意されておりますが、取得したバージョン情報(1.4.0 以上)もしくは VersionCode や VersionName による仮想通貨名の出し分けを行なってください。
(function() {
var script = document.createElement('script');
script.type = 'text/javascript';
script.async = true;
script.src = 'https://cdn-sb-connect.mobage.jp/jssdk/mobage-jssdk-client.2.XX.X.min.js'; // ※1
document.getElementsByTagName('script')[0].parentNode.appendChild(script);
})();
// mobage オブジェクトの準備ができるまでは、SPWeb 版(モバコイン表記)として
// 振る舞ってください。
document.addEventListener ("mobageReady", function () {
mobage.init({
clientId: "[YOUR CLIENT ID]", // ※2
redirectUri: "https://sandbox.example.com/login_cb" // ※2
contentOrigin: "`https://example.sb-cdn.pf.mobage.jp"` // ※2
});
var env = mobage.platform.getSDKName();
if (env.indexOf("mobage-shellapp-sdk") == -1) {
// SPWeb 版の処理。仮想通貨名「モバコイン」を変数にいれたり、サーバーに送信する等。
// サーバーに送信する場合は、User Id ごとに Shell App SDK の判別を
// 管理せずにセッションごとに管理してください。
}else{
// Google Play 配信用の処理。Android ゲームポイント名を変数にいれたり、サーバーに送信する等。
// サーバーに送信する場合は、User Id ごとに Shell App SDK の判別を
// 管理せずにセッションごとに管理してください。
}
});
※1: タイトルごとに適切なバージョンの Mobage JS SDK をロードしてください。Shell App SDK 1.4.0 の場合は、Mobage JS SDK 2.18.0 以降を使用する必要があります。
※2: Mobage Developers の「Mobage Connect 情報」をご確認の上、適切な ID・URI を記載してください
各マーケット版の確認方法
マーケットは Google Play 配信版のみなので、判別する必要はありません。
更新履歴
- 2015/10/13
- 新規作成