メインコンテンツまでスキップ

mobage.oauth

概要​

このモジュール中の機能は主にMobage Connectとの連携用として用いられます。

機能一覧​

mobage.oauthモジュールには以下のメソッドがあります。

メソッド​

mobage.oauth.getConnectedStatus​

ユーザーにUIを表示する事無く、ログイン状態及びインストール状態を調べる為のメソッドです。ログインかつインストール状態の際には暗黙的なAuthorization Requestを行います。結果は指定した Callback関数に対して渡されます。

構文​

mobage.oauth.getConnectedStatus (params , cb);

パラメータ​

params​

Object 型のパラメータです。以下に示したプロパティを設定する事が出来ます。

propertytitletyperequireddescription
stateStatestringtrueゲームサーバーで生成しセッションと紐づけたstate文字列を指定して下さい。
scopeScopearrayfalse認可を求める Scope の値を配列として指定して下さい。現状Scopeとして指定出来る値はopenidとcommon_apiのみです。
responseTypeResponse typearrayfalseResponse typeの値を配列として指定して下さい。現状Response typeとして指定出来る値はtoken, code, id_tokenのみです。

cb​

Function 型のパラメータです。

説明​

ゲームサーバーが発行するログインセッションが無い場合にUserAgentのログイン及びインストール状態を暗黙的に調べる為の機能です。このメソッドを呼び出してもユーザーに何かUIが表示される事は無く、また他のメソッドのようにボタンクリック時などのイベントハンドラ内で実行しなくとも構いません。 またcb引数のFunctionは前項で説明したCallback関数です。このCallback関数のerror, result引数はObjectで、共に同じフィールドを持ちます。

login​

Boolean 型のプロパティで、UserAgentがMobage Connectにログインしているかどうかに応じた値が設定されています。

connected​

Boolean 型のプロパティで、UserAgentがこのClientをインストールしているかどうかに応じた値が設定されてります。

response​

Object 型のプロパティで error 引数の場合は error, error_descriptionプロパティが設定されています。result引数の場合はcode, state, session_stateプロパティが設定されています。
 
Callback関数に渡されるerrorプロパティ一覧

errordescription
invalid_requestリクエストパラメータに誤りがある場合
login_requiredUserAgent が Mobage Connect にログインしていない場合
access_deniedMobage Connect サーバーまたはユーザーによって認可が拒否された場合
unauthorized_clientMobage Connect サーバーが認識する妥当な Client ではない場合
consent_required同意画面を表示してインストールに同意する必要がある場合
server_errorMobage Connect サーバー側でシステムエラーが起きた場合

error, result オブジェクト双方に login, connected プロパティが存在するので、実際にはこの値を見てハンドリングする事になります。

例​

インストール状態の場合はゲームサーバーが新規にログインセッションを発行し、Mobage Connectにログインしていてインストールはしていない状態の際にインストールボタンを表示させるような分岐を行う際の例を以下に示します。

var params = {
state : state , responseType : [" token", "code "]
};
var cb = function (error , result)
{
if (error)
{
if (error.login) {
// ロ グ イ ン 状 態 の 場 合 は イ ン ス トー ル ボ タ ン を 出 す
showInstallButton (error );
}
// ゲ ス ト プ レ イ の 継 続
return;
}
// ゲー ム サー バー で ロ グ イ ン セッ ショ ン 発 行 手 続 き を 行 う
startSession (result.response );
};
mobage.oauth.getConnectedStatus (params , cb);

各レスポンスに対するステータスについて​

mobage.oauth.getConnectedStatus() メソッドのレスポンスは、ユーザーの状態によって下記のように変化します。

\Mobage Connect へログインしているMobage Connect へログインしていない
ゲームをインストールしているresult レスポンスが返る, "login":true, "connected":true が返るー
ゲームをインストールしていないerror レスポンスが返る, "login":true, "connected":false が返るerror レスポンスが返る, "login":false, "connected":false が返る

mobage.oauth.connect​

ユーザーにインストールの同意や必要であれば Mobage Connectへのログインを求めるUIを表示し、その実行結果としてログイン状態、インストール状態などをCallback関数に返します。

備考

このメソッドはクリックイベントなどのブラウザによって開始されたイベントハンドラの中で呼び出して下さい。

構文​

mobage.oauth.connect(params , cb);

パラメータ​

params​

Object型のパラメータです。以下に示したプロパティを設定する事が出来ます。

propertytitletyperequireddescription
stateStatestringtrueゲームサーバーで生成しセッションと紐づけたstate文字列を指定して下さい。
scopeScopearrayfalse認可を求める Scope の値を配列として指定して下さい。現状Scopeとして指定出来る値はopenidとcommon_apiのみです。指定しない場合はopenidとcommon_apiの両方が指定された事になります。
responseTypeResponse typearrayfalseResponse typeの値を配列として指定して下さい。現状 Response typeとして指定出来る値はtoken, code, id_tokenのみです。
loginCustomThemeログイン画面用カスタムテーマstringfalseログイン画面用にカスタマイズされたカスタムテーマを文字列で指定できます。カスタムテーマはデベロッパーサイトで指定してください。 ※ JS SDK 3.1.0 より指定できます。
loginAppearanceVersionログイン画面用カスタムテーマのバージョンnumberfalseログイン画面用にカスタマイズされたカスタムテーマのバージョンを指定できます。カスタムテーマのバージョンはデベロッパーサイトでご確認ください。※ JS SDK 3.1.0 より指定できます。
authCustomThemeNBPF 認可画面用カスタムテーマstringfalseNBPF 認可用にカスタマイズされたカスタムテーマを文字列で指定できます。カスタムテーマはデベロッパーサイトで指定してください。※ JS SDK 3.1.0 より指定できます。
authAppearanceVersionNBPF 認可画面用カスタムテーマのバージョンnumberfalseNBPF 認可画面用にカスタマイズされたカスタムテーマのバージョンを指定できます。カスタムテーマのバージョンはデベロッパーサイトでご確認ください。※ JS SDK 3.1.0 より指定できます。
requestType認可リクエストのタイプstringfalse認可リクエストのタイプを指定します。 redirect を指定すると画面遷移による認可リクエストを送信します。※ JS SDK 3.9.0 より指定できます。
easyRegistrationかんたん会員生成フラグbooleanfalse認可リクエスト時のかんたん会員登録有無を指定します。 true を指定するとかんたん会員登録が行われます。※ SP Web 版では JS SDK 3.9.0 より指定できます。

cb​

Function型のパラメータです。

説明​

このメソッドはUIを表示した上でユーザーにインストールの同意やログインを求める為のメソッドです、上で説明したmobage.oauth.getConnectedStatus()とほぼ同じインターフェースですが、 
このメソッドはログイン状態ではない、またはインストール状態でない場合に必ずUIが表示されます。 また特にログイン状態ではない場合にはセキュリティ上の観点から新しいタブ上でログインフォームが表示されます。 
ログイン状態でインストールしていない場合は画面上にオーバーレイする形で同意画面が表示されます。

例​

このメソッドはwindow.open()によって新しいタブが開かれる場合があるので、クリックイベントなどのブラウザによって開始されたイベントハンドラなどの中で呼び出す必要があります。 この際に XMLHttpRequest などの非同期処理のコールバックなどから呼び出すとwindow.open()の呼び出し時にブラウザのポップアップブロック等によって新しいwindowの作成に失敗する場合があります。 インストール用のボタンをクリックした際に、このメソッドを呼び出しゲームサーバーのログインセッションを開始する例を以下に示します。

var installButton = document.getElementById (" installButton ");
installButton.addEventListener (" click", function(evt) {
var params = {
state: state ,
responseType : [" token", "code "],
authCustomTheme: "new_theme_1",
authAppearanceVersion: 1,
loginCustomTheme: "new_theme_1",
loginAppearanceVersion: 1
};
var cb = function(error , result) {
if (error) {
// ゲ ス ト プ レ イ の 継 続
return;
}
// ゲー ム サー バー で ロ グ イ ン セッ ショ ン 発 行 手 続 き を 行 う
startSession (result.response );
};
mobage.oauth.connect(params , cb);
}, false );

mobage.oauth.disconnect​

ユーザーにこのClientをアンインストールする為のUIを表示し、その実行結果をCallback関数に返します。

構文​

mobage.oauth. disconnect (params , cb);

パラメータ​

params​

Object型のパラメータです。以下に示したプロパティを設定する事が出来ます。

propertytitletyperequireddescription
themeテーマstringfalseプリセットされたデザインテーマです。現状は default または dark から選択します。省略された場合は default になります。

cb​

Function型のパラメータです。
 
このCallback関数のerror引数はObjectで、プロパティとしてerror, error_descriptionを持ちます。

Callback関数に渡されるerrorプロパティ一覧

errordescription
not_connectedインストール状態ではない場合
user_canceledユーザーによってアンインストールがキャンセルされた場合
server_errorMobage Connect サーバー側でシステムエラーが起きた場合

説明​

このメソッドはユーザーにこのClientをアンインストールする為のUIを表示した上でその実行結果を返します。

備考

ユーザー保護のため、この機能を必ずゲーム中に組み込んで下さい。

例​

ゲームをアンインストールする例を以下に示します。

var disconnectButton = document.getElementById (" disconnectButton ");
disconnectButton.addEventLister (" click", function (evt)
{
var params = {
theme : "default"
};
var cb = function (error , result)
{
if (! error) {
window.alert (" ア ン イ ン ス トー ル が 完 了 し ま し た。 ");
// ゲー ム サー バー の セッ ショ ン を 非 ロ グ イ ン 状 態 と す る
restartSession ();
}
};
}, false );

mobage.oauth.logout​

このメソッドはMobage ConnectからUserAgentをログアウトさせる為のUIを開くメソッドです。戻り値はCallback関数経由で受け取ります。
通常、ログアウトが成功した場合は明示的にゲームサーバー上からもUserAgentをログアウトさせる必要があります。

構文​

mobage.oauth.logout(params , cb);

パラメータ​

params​

Object型のパラメータです。以下に示したプロパティを設定する事が出来ます。

cb​

Function型のパラメータです。

params​

Object型のパラメータです。以下に示したプロパティを設定する事が出来ます。

propertytitletyperequireddescription
themeテーマstringfalseプリセットされたデザインテーマです。現状はdefaultまたはdarkから選択します。省略された場合はdefaultになります。

このCallback関数のerror引数はObjectで、プロパティとしてerror, error_descriptionを持ちます。成功時のresult引数には特にプロパティはありません。

Callback関数に渡されるerrorプロパティ一覧

errordescription
not_loginログイン状態ではない場合
user_canceledユーザーによってアンインストールがキャンセルされた場合
server_errorMobage Connect サーバー側でシステムエラーが起きた場合

ゲームから明示的にMobage Connect上のUserAgentのログインセッションを破棄させたい場合に使います。またこの際には通常、ゲームサーバーが発行するログインセッションも破棄させる必要があります。

例​

Mobage Connectでログアウトさせ、成功した場合にゲームサーバーのログインセッションを破棄する例を以下に例を示します。

var logoutButton = document.getElementById (" logoutButton ");
logoutButton . addEventLister (" click", function (evt)
{
var cb = function (error , result)
{
if (error)
{
 window.alert (" Error Code: " + error.error   + ", Error Description : " + error. description );
 return;
}
// ゲー ム サー バー の ロ グ イ ン セッ ショ ン を 破 棄 す る
revokeSession ();
};
mobage.oauth.logout ({
theme : "dark"
}, cb);
}, false );

更新履歴​

  • 2020/07/20
    • mobage.oauth.connect() のパラメータに requestType / easyRegistration を追記