Skip to main content

Mobage JS SDKのセットアップ

Mobage Developersで登録​

Mobage JS SDKを利用するためには、Mobage Developersにて下記の情報を登録する必要があります。

warning

sandbox 向けの URL 設定時には独自に Basic/Digest 認証などを導入し、開発関係者及び Mobage 審査アカウント以外から閲覧出来ないように Web サーバーの設定を行う必要があります。設定した Basic 認証の ID / Password は Mobage 審査申請時にデベロッパーサイトから申請する必要があります。

項目内容
Client URIMobage Developers で登録できます。アプリケーションのトップページを表すURIです。ShortCut Widgetの遷移先として用いられる、Mobageからの遷移時のリンク先となります。
Client Origin URIMobage Developers で登録できます。Mobage Connect サーバー及び Widget Service サーバーから、クロスドキュメントメッセージを受け付けられる origin のホワイトリストです。
Redirect URIMobage Developers で登録できます。Mobage Connect サーバーからの Authorization Response を受け取る為のURIです。

Mobage Developers「アプリケーション情報」の上部タブから「SPWeb」を選択し、「Mobage Connect 情報」の「情報を変更」をクリックし、上記の情報を入力しましょう。

なお、下記の情報を登録しなければならない場合があります。

項目内容
Post Logout Redirect URIMobage Connect サーバーでユーザーがログアウトした際に、リダイレクトする Game Server 上の URI です。JavaScript SDK の機能 (mobage.oauth.logout) を利用する場合、登録する必要はありません。
Post Uninstall Redirect URIMobage Connect サーバーでユーザーがGameをアンインストールした際に、リダイレクトする Game Server 上の URI です。JavaScript SDK の機能(mobage.oauth.disconnect)を利用する場合、登録する必要はありません。
CDN Sub DomainCDN(Contents Delivery Network)用のサブドメイン設定です。
Subscriber Callback URLPlatformからのリクエストを受ける為のURLです。現在はアイテム購入非同期確認処理のURLを指定出来ます。

Mobage JS SDKの取得​

これらの情報を登録すると、Mobage JS SDKを利用できるようになります。ClientアプリケーションのHTML上にJavaScriptコードを埋め込み、SDKのロードと初期化を行います。なお、Mobage JS SDKは以下のようなCDN(Contents Delivery Network)上に保存されています。

環境URI
開発用SDKhttps://cdn-sb-connect.mobage.jp/jssdk/mobage-jssdk-client.3.10.2.min.js
本番用SDKhttps://cdn-connect.mobage.jp/jssdk/mobage-jssdk-client.3.10.2.min.js

 
Mobage JS SDKの呼び出しを行うために、Client ID が必要となります。
Mobage Developers「アプリケーション情報」の上部タブから「SPWeb」を選択し、「Mobage Connect情報」にて以下のように Client ID を確認しましょう。
 

 
Client ID を確認したら、以下のようなコードを埋め込んで Mobage JS SDK を呼び出します。
 
なお、Mobage JS SDK は、下記のようにページの最下部(最後の の直前)で読み込む必要があります。そうしないと動作が保証されません。
 
また、ここでは Mobage JS SDK の読み込み中にブラウザのレンダリングが止まらないように非同期的にロードしていますがこちらは必須ではありません。

<body>
 
<!-- 省略 -->
 
<script type='text/javascript'>
(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.3.10.2.min.js';
document.getElementsByTagName('script')[0].parentNode.appendChild(script);
})();
 
document.addEventListener ("mobageReady", function () {
mobage.init({
clientId: "[YOUR CLIENT ID]",
redirectUri: "https://sandbox.example.com/login_cb",
contentOrigin: "`https://example.sb-cdn.pf.mobage.jp"`
});
});
</script>
</body>
warning

上記コードは、特に Mobage JS SDK を呼び出さない場合でも毎回実装する必要があります。

  • Mobage Developersで登録
  • Mobage JS SDKの取得