跳到主要内容

定制主题功能

概要​

在Mobage JS SDK中, 购买画面、登录画面、NBPF 验证画面等符合游戏世界观的UI,可以通过编写CSS来实现。

在此,就以下项目进行解说:

  • 在开发者网站中的 Custom Theme 设置方法
  • 使用mobage.ui.open() 方法,调用定制的物品购买画面
  • 使用mobage.ui.open() 方法,调用定制的游戏点数购买画面(仅限Shell App SDK )
  • 使用mobage.oauth.connect() 方法,调用定制的登录画面

教程前序​

  • 定制物品购买画面的前提是已完成以下物品购买教程。
  • 定制登录画面的条件是已完成登录的实现。

实现的步骤​

按以下几大步骤,进行物品购买画面、登录画面的 CSS 定制。

  1. 在 Mobage Developers Japan 中设置 Custom Theme
  2. 指定物品购买画面、登录画面的定义主题

在 Mobage Developers Japan 中设置 Custom Theme​

设置自定义主题用的 CSS URL。

  • 从仪表盘的左菜单,打开“应用软件”>“应用软件列表”画面。

  • 从“应用软件列表”中,选择当前开发的应用软件。

  • 在显示页面的左菜单中,选择“Mobage Connect信息”。

  • 在Mobage Connect 信息中,选择“Custom Theme 设置”。

  • 指定 CSS URL 。

  • 设置的 CSS URL 会与 Service Version 一起被保存。
    ¥

    信息

可在Service 的 payment, login, authorize, choose_product 中分别设置 Custom Theme 。choose_product 是在 NBPF SPWeb 中不能使用的 Shell App SDK 的专用 Custom Theme 。 :::

在 mobage.ui.open 中调用物品购买画面的定义主题 ※ JS SDK 2.15.0 以后​

使用Mobage JS SDK 的 mobage.ui.open() 方法,可指定定制的物品购买画面。

注意

开发者网站上的标识符 payment 为物品购买画面。
指定主题时,可在 payment 对象中指定以下要素。

  • customTheme
  • 指定物品购买画面用主题
  • appearanceVersion
  • 指定物品购买画面用主题的版本
mobage.ui.open( "payment"``, { transactionId: result.id, customTheme: "new_theme_1"``, appearanceVersion: 1 }, function``(error , result) { // handle callback } );

在 mobage.ui.open 中调用游戏点数购买画面的定义主题 ※ JS SDK 3.2.0 以后​

使用Mobage JS SDK 的 mobage.ui.open() 方法,可指定定制的物品购买画面。

注意

开发者网站上的标识符 choose_product 为游戏点数购买画面。
指定主题时,可在 payment 对象中指定以下要素。

  • chooseProductCustomTheme
    • 指定游戏点数购买画面用主题
  • chooseProductAppearanceVersion
    • 指定游戏点数购买画面用主题的版本
mobage.ui.open( "payment"``, { transactionId: result.id, customTheme: "new_theme_1"``, appearanceVersion: 1, chooseProductCustomTheme: "new_theme_1"``, chooseProductAppearanceVersion: 1 }, function``(error , result) { // handle callback } );

在 mobage.oauth.connect 中调用登录画面、NBPF验证画面、会员注册画面的定义主题 ※ JS SDK 3.1.0 以后​

使用Mobage JS SDK 的 mobage.oauth.connect() 方法,可指定定制的登录画面、NBPF 验证画面。
主题的指定方法因 JS SDK 的版本而异。

使用JS SDK 3.4.0 以后的版本时​

注意

开发者网站上的标识符 login 为登录, authorize 为NBPF验证, register 为会员注册, pincode 为PIN码输入画面。

  • CustomTheme
    • 指定登录、NBPF验证、会员注册、PIN码输入画面用主题
  • appearanceVersion
    • 指定登录、NBPF验证、会员注册、PIN码输入画面用主题的版本
var installButton = document. getElementById (``"installButton "``); installButton . addEventListener (``"click"``, function``(evt) { var params = { state: state , responseType : [``"token"``, "code"``], customTheme: "new_theme_1"``, //  指定登录、NBPF验证、会员注册、PIN码输入用主题 appearanceVersion: 1, //  指定登录、NBPF验证、会员注册、PIN码输入画面主题的版本 }; var cb = function``(error , result) { if (error) { // 继续访客试玩 return``; } // 在游戏服务器执行登录会话发行手续 startSession (result.response ); }; mobage.oauth.connect(params , cb); }, false );

使用JS SDK 3.3.0 之前的版本时​

注意

开发者网站上的标识符 login 为登录画面,authorize 为 NBPF 验证画面。

  • loginCustomTheme
    • 指定登录画面用主题
  • loginAppearanceVersion
    • 指定登录画面用主题的版本
  • authCustomTheme
    • 指定NBPF 验证画面用主题
  • authAppearanceVersion
    • 指定NBPF 验证画面用主题的版本
var installButton = document. getElementById (``"installButton "``); installButton . addEventListener (``"click"``, function``(evt) { var params = { state: state , responseType : [``"token"``, "code"``], loginCustomTheme: "new_theme_1"``, // 指定登录画面用主题 loginAppearanceVersion: 1, // 指定登录画面用主题的版本 authCustomTheme: "new_theme_1"``, // 指定NBPF 验证画面用主题 authAppearanceVersion: 1 // 指定NBPF 验证画面用主题的版本 }; var cb = function``(error , result) { if (error) { // 继续访客试玩 return``; } // 在游戏服务器执行登录会话发行手续 startSession (result.response ); }; mobage.oauth.connect(params , cb); }, false );

在 mobage.ui.open 中调用用户升级画面的定义主题 ※ JS SDK 3.4.0 以后​

使用Mobage JS SDK 的 mobage.ui.open() 方法,指定定制的好友邀请服务。

注意

开发者网站上的标识符 upgrade 为用户升级画面。
指定主题时,可在 upgrade 对象中指定以下要素。

  • customTheme
    • 指定用户升级画面用主题
  • appearanceVersion
    • 指定用户升级画面用主题的版本
mobage.ui.open( "user_upgrade"``, { requiredGrade: 2, customTheme: "new_theme_1"``, appearanceVersion: 1 }, function``(error , result) { // handle callback } );

在 mobage.ui.open 中调用好友邀请服务的定义主题 ※ JS SDK 3.3.0 以后​

使用Mobage JS SDK 的 mobage.ui.open() 方法,可指定定制的好友邀请服务。

注意

开发者网站上的标识符 invitation 为好友邀请服务。
指定主题时,可在 invitation 对象中指定以下要素。

  • customTheme
    • 指定好友邀请服务用主题
  • appearanceVersion
    • 指定好友邀请服务主题的版本
mobage.ui.open( "invitation"``, { customTheme: "new_theme_1"``, appearanceVersion: 1 }, function``(error , result) { // handle callback } );

注意事项​

  • 建议在Android 终端或 iOS 终端上进行动作验证。
  • 请准备https 环境,用于指定 CSS URL。
  • SSL 证书有缺陷时,可能无法从应用中获取 CSS ,因此请使用可信任机构发行的证书。

更新履历​

  • 2016/04/15
    • 随定义主题中会员注册、PIN码输入、用户升级画面的添加而做出补充
    • 由于从JS SDK 3.4.0 调用登录画面主题的方法有更改,故补充
  • 2016/01/27
    • 随定义主题中游戏点数购买画面的添加而做出补充
  • 2015/12/22
    • 随Custom Theme 增加而做出修改