单点退出关联(必须实装)
必须实装“单点退出关联”。
必须的理由是如果没有实装“单点退出关联”,那么当用户 A 在 Mobage 本体中未参与游戏而退出后又以用户 B 的身份登录 Mobage 时,会造成“在游戏内是用户 A”而“在Mobage 本体中是用户 B”的混乱状态。
概要
Mobage Connect 上的用户退出游戏时,Game Server 进行 单点退出 的结构。
每次向Mobage Connect 发送 Authorization Request ,Authorization Response 会反馈 session_state 值。
如果此 Authorization Response 的 session_state 值有变化,那么可以在Mobage Connect 上判断用户已退出游戏。
在Mobage JavaScript SDK 中,使用此 session_state 参数,可确认Mobage Connect 端的登录状态有无更改。
为此开发登录状态更改确认和 单点退出关联 功能。
要创建文件的列表
在本教程中,要创建的文件如下所述。
| 文件名 | 概要 |
|---|---|
| config.php | 各种设置值的汇总 |
| login_hybrid.php | 调用单点退出关联处理的JavaScript |
| main.js | 进行单点退出关联处理 |
| logout.php | 注销Game Server 中保持的 Login Session |
开始教程之前
本教程在以下教程结束的前提下进行。
在以下教程中,如未创建文件,请先完成。
开发的步骤
为了实现单点退出关联处理,按以下2大步骤进行。
监控 Mobage Connect 登录会话的变更
使用 Mobage JavaScript SDK ,实现对 session_state 参数有无更改的监控处理。
将通过会话保持的 session_state植入HTML中
如下所述,将通过 Game Server 在登录会话中绑定保持的 session_state 植入HTML中。
mobage-jssdk-sample-login/hybrid_flow/login_hybrid.php
| 19 20 21 | <?php if``(isset(``$_SESSION``[``'session_state'``])): ?> data-session-state=``"<?php echo $_SESSION['session_state'] ?>" <?php endif``; ?> |
读入通过 JavaScript植入的 session_state
通过 JavaScript 处理,读入 HTML中植入的 session_state参数。
mobage-jssdk-sample-login/main.js
| 25 26 27 28 29 30 31 32 | var html = document.getElementsByTagName(``'html'``)[0]; clientData = { clientId : html.dataset.clientId, redirectUri : html.dataset.redirectUri, state : html.dataset.state, sessionState : html.dataset.sessionState }; |
监控session_state 参数的变更
在等待mobageReady 事件的事件监听器中,对mobage.event.subscribe() 方法的 oauth.sessionStateChange 事件进行监控,如下所述等待session_state 的变化。
此事件监听器的 result 参数为 changed 时,表示Mobage Connect 的登录会话已有更改,需要注销Game Server 中保持的 Login Session。
mobage-jssdk-sample-login/main.js
| 25 26 27 28 29 30 31 32 33 | if (clientData.sessionState) { mobageLogoutButton.style.cssText = 'visibility:visible'``; mobage.event.subscribe(``'oauth.sessionStateChange'``, clientData.sessionState, function``(result) { if (result == 'changed'``) { location.href = '../others/logout.php'``; } }); getMyInformation(); } |
注销 Game Server 的登录会话
Mobage Connect 中的登录会话变更确认完成后,注销 Game Server 中保持的 Login Session。
请设计时注意在Game Server 中注销 Login Session 后,引导用户进入下一操作,例如显示使用其他帐号进行登录的画面等。
开发的代码
本教程开发的代码可从 Github 克隆。
$ git clone https:``//github.com/DeNADev/mobage-jssdk-sample-login.git |
更新履历
- 2018/07/13
- 规定必须实装“单点退出关联”。
- 2014/07/08
- 新建