跳到主要内容

【选项】不使用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

24document.addEventListener(``'mobageReady'``, function``() {

Login Session 的确认​

使用Session Storage ,开发登录会话管理功能。
如下所述,进行有无登录会话的询问。

mobage-jssdk-sample-login/client_flow/client.js

94 95 96 97function 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 33var 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 76function 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

42mobage.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 53mobage.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 67mobageLoginButton.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 88function writeSession(result) { var session  = { session_state : result.response.session_state }; window.sessionStorage.setItem(``"session"``, JSON.stringify(session)); }

动作确认​

下面,将开发的程序配置于 Game Server 。

文件名URL
login_client.htmlhttp://localhost/mobage-jssdk-sample-login/client_flow/login_client.html
client.jshttp://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