【选项】不使用GameServer直接登录(Client-Side流程)
- 概要
- 要创建文件的列表
- 开始教程之前
- 开发的步骤
- 动作确认
- 开发的代码
概要
对无需 Game Server 的休闲游戏,不使用 PHP 等脚本语言,只需使用 HTML 文件和 JavaScript 就能进行实装的流程就是 Client-Side 流程 。
它不像 Hybrid 流程和 Authorization Code Grant 流程那样在 Game Server 中进行登录会话管理,而是使用 Client-Side Storage进行用户数据管理。
在本教程中,使用 SessionStorage进行开发。
要创建文件的列表
在本教程中,要创建的文件如下所述。
| 文件名 | 概要 |
|---|---|
| login_client.html | 调用下述 JavaScript 和 Mobage JS SDK |
| client.js | 不使用 Game Server 直接登录 Mobage Connect |
开始教程之前
本教程在以下教程结束的前提下进行。
如果以下教程未完成,请先完成。
开发的步骤
本教程按以下3个步骤进行。
- 确认 Login Session 并发行 state 值
- 确认 Mobage Connect 的登录状态和游戏的安装状态
- 显示登录/安装键并执行
- 保存 Login Session
Client-Side 流程的顺序图如下所述。
确认 Login Session 并发行 state 值
在 Client-Side 流程中,使用 Client-Side Storage 进行登录会话管理。
确认 Client-Side Storage ,如果在非登录状态,则新发行 state 值。
mobage.init() 的调用准备
将想要发送至 mobage.init() 的设置值(Client ID, Redirect URI)记载于html中。
在此将以下的 YOUR_CLIENT_ID 和 YOUR_REDIRECT_URI 替换成自身的设置值。
mobage-jssdk-sample-login/client_flow/login_client.html
| 2 3 4 5 | <``html lang``=``'ja' data-client-id``=``"YOUR_CLIENT_ID" data-redirect-uri``=``"YOUR_REDIRECT_URI" > |
Mobage JS SDK 的读入
读入 Mobage JS SDK,同时读入写有登录处理逻辑的 JavaScript程序。
mobage-jssdk-sample-login/client_flow/login_client.html
| 19 20 21 22 23 24 25 26 27 28 | <``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.X.X.X.min.js'; document.getElementsByTagName('script')[0].parentNode.appendChild(script); })(); </``script``> <``script type``=``'text/javascript' src``=``"./client.js"``></``script``> |
mobageReady 事件的调用
非同步执行的 JavsScript SDK 读入完成后,会调用 "mobageReady" 事件。
mobage-jssdk-sample-login/main.js
| 24 | document.addEventListener(``'mobageReady'``, function``() { |
Login Session 的确认
使用Session Storage ,开发登录会话管理功能。
如下所述,进行有无登录会话的询问。
mobage-jssdk-sample-login/client_flow/client.js
| 94 95 96 97 | function isLoggedIn () { var session = readSession(); return session ? true : false``; } |
新发行 state 值
无登录会话时,生成 "state" 值(8个字以上256个字以内的字符串)。
mobage-jssdk-sample-login/client_flow/client.js
| 28 29 30 31 32 33 | var state, session_state; state = generateState(); if (isLoggedIn ()) { var session = readSession(); session_state = session.session_state; } |
mobage-jssdk-sample-login/client_flow/client.js
| 72 73 74 75 76 | function generateState() { // Transfer Random number to Strings(0-9a-z), and slice 16 words from backward. var state = 'mobage-connect_' + Math.random().toString(36).slice(-16); return state; } |
确认 Mobage Connect 的登录状态和游戏的安装状态
使用 Mobage JS SDK 的 mobage.oauth.getConnectedStatus 方法,确认 Mobage Connect 的登录状态 和游戏的安装状态。
此处理的顺序图如下所述。
mobage.init() 的调用
使用 Mobage Developers Japan(开发者网站)中的设置值,调用 mobage.init()方法,进行 Mobage JS SDK 的初始化。
为使用 Mobage JS SDK功能,必须调用此方法。
mobage-jssdk-sample-login/client_flow/client.js
| 42 | mobage.init({ clientId: clientData.clientId, redirectUri: clientData.redirectUri }); |
mobage.oauth.getConnectedStatus() 方法的调用
为确认登录状态和安装状态,执行 mobage.oauth.getConnectedStatus 方法。
mobage-jssdk-sample-login/client_flow/client.js
| 46 47 48 49 50 51 52 53 | mobage.oauth.getConnectedStatus(params, function``(err, result) { if (result) { showLogoutButton(); getMyInformation(); } else { showLoginButton(); } }); |
执行此方法时,不会显示新的 window。
用户未登录 Mobage Connect 时,会立即向 callback 传递错误响应。
用户未安装 Client 应用时,也会立即向 callback 传递错误响应。
mobage.oauth.getConnectedStatus() 方法的响应
根据用户的状态,mobage.oauth.getConnectedStatus() 方法的响应变化如下所述。
| \ | 已登录 Mobage Connect | 未登录 Mobage Connect |
| 已安装游戏 | 反馈 result 响应 | 反馈 error 响应 |
| 未安装游戏 | 反馈 error 响应 | 反馈 error 响应 |
反馈 result 响应时
此时,向Redirect Endpoint发送 code, state, session_state。
另外,隐藏登录键,以免此后调用 mobage.oauth.connect 方法。
反馈 error 响应时
此时,显示登录键,以供此后可调用 mobage.oauth.connect 方法。
显示登录/安装键并执行
当“未登录 Mobage Connect ”或“未安装游戏”时,调用 mobage.oauth.connect()方法。调用 mobage.oauth.connect() 方法后,会对用户显示登录表或同意安装游戏画面。用户输入必要的信息,在 Callback函数执行完毕后,保存 Login Session。
以上处理的顺序图如下所述。

设置登录/安装键
为了让用户进入登录状态及安装状态,设置安装键。对 mobage登录键进行定义,通过按键的'click'事件,保证 mobage.oauth.connect 方法被执行。 mobage.oauth.connect 方法成功时,作为 Login Session保存至 Session Storage。
mobage-jssdk-sample-login/client_flow/client.js
| 55 56 57 58 59 60 61 62 63 64 65 66 67 | mobageLoginButton.addEventListener(``'click'``, function``() { mobage.oauth.connect({ state: clientData.state }, function``(err, result) { if (err) { console.log(``'login failed: error = '``, err); } else { console.log(``'result:'``, result); console.log(``'mobage.oauth.connect is OK(login success)'``); writeSession(result); getMyInformation(); } }); }); |
此 connect() 方法在点击事件等通过浏览器开始的事件处理程序中进行调用。
如果无用户操作直接调用脚本(非同步处理等),可能会因为浏览器的阻止弹出功能而不能打开 window。
保存 Login Session
Mobage Connect 的登录状态和游戏的安装状态得到确认后,将 Login Session 保存至 Session Storage 。
将 session_state 保存为 Login Session
Session Storage 中储存的 session_state 用于单点退出关联。
mobage-jssdk-sample-login/client_flow/client.js
| 83 84 85 86 87 88 | function writeSession(result) { var session = { session_state : result.response.session_state }; window.sessionStorage.setItem(``"session"``, JSON.stringify(session)); } |
动作确认
下面,将开发的程序配置于 Game Server 。
| 文件名 | URL |
|---|---|
| login_client.html | http://localhost/mobage-jssdk-sample-login/client_flow/login_client.html |
| client.js | http://localhost/mobage-jssdk-sample-login/client_flow/client.js |
上述配置完成后,请访问http://localhost/mobage-jssdk-sample-login/client_flow/login_client.html。
会显示以下登录键。

按登录键,会在新 Window 中显示以下登录表。
(或覆盖显示同意安装游戏确认画面。)

输入必要事项并成功登录 Mobage Connect 后,会显示通过 People API 获取的 Mobage 用户昵称

开发的代码
本教程开发的代码可从 Github 克隆。
$ git clone https:``//github.com/DeNADev/mobage-jssdk-sample-login.git |