跳到主要内容

用语集

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
sandboxhttps://sb-connect.mobage.jp/connect/1.0/services/authorize
servicehttps://connect.mobage.jp/connect/1.0/services/authorize

Token Endpoint​

使用 API 时,获得 Access Token 所需的端点。各环境中的 Token Endpoint 如下。

环境URI
sandboxhttps://sb-connect.mobage.jp/connect/1.0/api/token
servicehttps://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 是指后端访问服务。进行游戏币扣除等处理。