用语集
- Mobage JS SDK
- Mobage Connect 服务器
- Widget Service 服务器
- Access Token
- Refresh Token
- Proxy Server 模式
- Connect 模式
- Client ID
- Client Secret
- Client URI
- Client Origin URI
- Redirect URI
- Post Logout Redirect URI
- Post Uninstall Redirect URI
- CDN Sub Domain
- Subscriber Callback URL
- Authorization Endpoint
- Token Endpoint
- Hybrid 流程
- Authorization Code Grant 流程
- Client-Side 流程
- mobage.oauth.getConnectedStatus()
- mobage.oauth.connected()
- Protected Endpoint
- Session Start Endpoint
- Redirect Endpoint
- JSON Web Token (JWT)
- Bank API
- Payment 服务
Mobage JS SDK
在Mobage Platform 上开发智能手机浏览器用游戏的新开发环境。使用 JavaScript ,可使用 Mobage 提供的各种功能。
Mobage Connect 服务器
基于 OAuth 2.0 / OpenID Connect 1.0 的验证服务器。提供与 Mobage 进行 ID 关联的功能,并提供执行 Social API 所需的 token 的管理功能。
Widget Service 服务器
提供物品收费功能等 UI 的服务器。从Mobage JS SDK 调用。
Access Token
调用 RESTful API 时所需的令牌。格式为 OAuth 2.0 的 Bearer Token 。在 Mobage Connect 中15分钟有效。
Refresh Token
再发行 Access Token 所需的令牌。在 Refreshing an Access Token - RFC6749 中有使用方法的定义。在 Mobage Connect 中90日有效。
Proxy Server 模式
请求不直接从 User Agent 发送至 Game Server ,而是通过 Proxy Server (Gadget Server) 的模式。详情请见“原有验证模式的特点”。
Connect 模式
请求直接从 User Agent 发送至 Game Server,使用 Mobage Connect 服务器 进行的验证模式。详情请见“新验证系统的特点”。
Client ID
可在 Mobage Developers Japan(开发者网站)中发行。供 Mobage JS SDK 和 Mobage Connect 服务器识别的 Client 应用软件标识符 (例:12000129-4)
Client Secret
可在 Mobage Developers Japan(开发者网站)中发行。与 Client ID 配对的 Secret 。
Client URI
可在 Mobage Developers Japan(开发者网站)中注册。表示 Client 应用软件首页的 URI。用作快捷微件的跳转目标或从 Mobage 上跳转时的链接目标。要使用 Mobage JS SDK,需要进行注册。
Client Origin URI
可在 Mobage Developers Japan(开发者网站)中注册。可从 Mobage Connect 服务器和 Widget Service 服务器接收交叉文档信息的 origin 白名单。要使用 Mobage JS SDK,需要注册 1 个以上。
Redirect URI
可在 Mobage Developers Japan(开发者网站)中进行注册。从 Mobage Connect 服务器接收 Authorization Response 所需的 URI。要使用 Mobage JS SDK,需要注册 1 个以上。
Post Logout Redirect URI
可在 Mobage Developers Japan(开发者网站)中进行注册。用户从 Mobage Connect 服务器退出时,在 Game Server 上进行重定向的 URI。使用 Mobage JS SDK 的功能 (mobage.oauth.logout) 实装 logout 功能时无需注册。
Post Uninstall Redirect URI
可在 Mobage Developers Japan(开发者网站)中进行注册。用户通过 Mobage Connect 服务器卸载 Game 时在 Game Server 上进行重定向的 URI 。使用 JavaScript SDK 的功能 (mobage.oauth.disconnect) 实装 Uninstall 功能时无需注册。
CDN Sub Domain
设置 CDN 用子域名。从 Mobage JS SDK 使用时,请参见这里。
Subscriber Callback URL
设置从Platform 接收事件所需的 URL 。目前可指定购买物品时的非同步确认处理所需的 URL 。
Authorization Endpoint
Client 应用软件获得用户验证所需的端点。各环境中的 Authorization Endpoint 如下。
| 环境 | URI |
| sandbox | https://sb-connect.mobage.jp/connect/1.0/services/authorize |
| service | https://connect.mobage.jp/connect/1.0/services/authorize |
Token Endpoint
使用 API 时,获得 Access Token 所需的端点。各环境中的 Token Endpoint 如下。
| 环境 | URI |
| sandbox | https://sb-connect.mobage.jp/connect/1.0/api/token |
| service | https://connect.mobage.jp/connect/1.0/api/token |
Hybrid 流程
不是从游戏画面跳转至登录认证画面,而是在游戏画面之外的新Window中打开登录认证画面的流程。基本上建议采用 Hybrid 流程。详情请见这里。
Authorization Code Grant 流程
使用 Game Server ,按原有方式进行画面跳转的流程。用户从游戏画面跳转至登录认证画面,在登录认证画面中完成输入并通过验证后,页面跳转,返回至原来的游戏画面。详情请见这里。
Client-Side 流程
不使用 Game Server 的休闲游戏用流程。不进行 Game Server 的登录会话管理,因此使用 Client-Side Storage 进行用户数据管理。登录认证画面与 画面不跳转直接登录的流程 同样,在游戏画面之外打开新 Window 。详情请见这里。
mobage.oauth.getConnectedStatus()
不向用户显示 UI,检查登录状态和安装状态所需的方法。处于登录且安装状态时,默认进行 Authorization Request 。结果传递给指定的 Callback 函数。详情请见这里。
mobage.oauth.connected()
如果需要用户同意安装,则显示请求登录 Mobage Connect 的 UI,向 Callback 函数反馈登录状态、安装状态等执行结果。详情请见这里。
Protected Endpoint
只有带有游戏登录会话的 UserAgent 才能进行浏览的端点。设置在 Game Server 端。
Session Start Endpoint
发送 Authorization Request 前,保存 Protected Endpoint 的 URI,生成 state 值并开始会话,绑定至会话数据所需的端点。设置在 Game Server 端。
Redirect Endpoint
接收 Authoirization Response,登录处理前进行验证,如果正确,则发行登录会话并重定向至 Protected Endpoint 的端点。
JSON Web Token (JWT)
Mobage JS SDK 中使用的 JSON Web Token (JWT) ,是目前 IETF 正在制定的规范,截止到本书编写时,最新规范是 JSON Web Token (JWT) draft-ietf-oauth-json-web-token-15。详情请见这里。
Bank API
是指物品收费(结算服务)中使用的 RESTful API。Bank API 中有 Bank Debit API 和 Bank Inventory API 。
Payment 服务
在物品收费(结算服务)中使用的 mobage.ui.open('payment') 的 Widget 是指后端访问服务。进行游戏币扣除等处理。