Mobage iOS NativeSDK Quick Guide
1 前期准备
要使用 Mobage Native SDK 进行开发需要进行必要的前期准备。
1.1 注册成为DeNA开发者
访问 DeNA 开发者论坛 https://developer.mobage.cn/v/ 。根 据提示注册新的用户,完成后通过登陆开发者网站。
1.2 注册应用程序
输入相应信息后点击确认,在确认页面点击提交。跳转到应用程序详细。
1.3 获得客户端用key、secret
选中基本信息中的iOS Tab,其中的SDK Consumer Key、Secret将会在后面开发中用于接入SDK,在未半公开的情况下,只能使用Sandbox环境。
基本信息Tab中的key和secret是服务器端使用,不要和客户端SDK用的搞混了。
1.4 注册沙箱账户
本步骤在安卓平台通常不是必须步骤。
梦宝谷中文平台的弱账号系统允许玩家不注册账号就可登陆游戏。
(系统将自动分配账号)
在iOS平台为必须步骤。iOS平台不会自动分配账号。
但是开发者仍然可以建立新的沙箱账号以测试账户切换等相关功能。
在Sandbox环境中进行游戏测试时需创建并使用相应的沙箱帐号(即测试用帐号)。
沙箱帐号可以由各合作开发者自行创建,用于同一个合作开发者开发的游戏测试。
如何创建沙箱帐号?
1.通过合作开发者ID登陆开发者网站。
2.在首页选择“用户管理”>“沙箱帐号”进入测试帐号创建页面,
3.点击添加沙箱账号输入该帐号名称以及E-mail地址,提交。

3.点击账户右侧的激活
4.点击该URL进行激活注册。
5.注册完成,系统分配的手机号则为沙箱环境的登陆账号。
2 Xcode相关设定
本章介绍 Mobage iOS Native SDK Xcode 5开发工具的设定。
本文环境:
- Mac OS X 10.9
- XCode 5.0.2
- Mobage iOS SDK 1.3.6
2.1 导入MobageSDK目录
在 Xcode 中导入 (Add File To)MobageSDK 目录, 加入到工程根目录(注意,MobageNativeSDK.VERSION 和conf.json 文件是必须的),如下图所示:
2.2 删除重复资源文件
在SDK\images文件夹下有cn、tw两个文件夹,分别面向简体平台和繁体平台,删除不需要的平台即可。
2.3 更改AppDelegate的后缀名
为了提高效率,在梦宝谷SDK中使用了大量的C++代码。为了混编ObjC代码和C++代码,需要将AppDelegate.m修改后缀为AppDelegate.mm
2.4 设置C++编译环境
开发者需要设置 Xcode build setting 中设置C++的编译环境,否则会编译错误。
找到Apple LLVM 5.0 - Language - C ++, 将C++ Standard Library 改为 libstdc++,如下图所示:
2.5 设置otherlinkerflag
开发者需要设置 Xcode build setting 相关内容。如下图所示:
2.6 导入需要的framework
选择工程文件的 Build phase 面板,然后打开 Link Binary With Libraries,
Moabge SDK 使用了一些特定的 framework, 主要的有
- libz.dylib
- CoreLocation.framework
- CoreTelephony.framework
- QuartzCore.framework
- CFNetwork.framework
- CoreGraphics.framework
- MessageUI.framework
- MobileCoreServices.framework
- StoreKit.framework
- SystemConfiguration.framework
- UIKit.framework
- CoreText.framework
- Security.framework
- libsqlite3.dylib
- AdSupport.framework(set as Optional)
- Social.framework(set as Optional)
- Accounts.framework(set as Optional)
- AudioToolbox.framework
- AVFoundation.framework
- CoreMotion.framework
- EventKit.framework
- MediaPlayer.framework
2.7 设置KeychainGroups
选择工程文件的Capability 面板,, 找到“KeyChain Sharing” 并添加 "com.mobage.shared" 到"Keychain Groups"中. 请注意,如果不添加"Keychain Groups",您可能无法正确访问梦宝谷平台
3 Mobage平台初始化
3.1 修改 conf.json 文件
导入 MobageSDK 后,会发现有一个 conf.json 文件。
在conf.json中指定了开发环境:sandbox(沙箱测试环境)或者production (正式环境)
一个基本的 conf.json 的例子如下: conf.json 示例:
{"platformEnv":"SADNBOX", "app_id":"13000062", "affcode":"1983000062"}
指定了此应用发布的渠道类型,初始值为 1980000000,无需开发者填写,开发者平台会自动处理。
3.2 Mobage 平台初始化相关代码
3.2.1 头文件
在AppDelegate.m中,引入梦宝谷SDK的头文件
#import "MBGPlatform.h"
3.2.2 初始化
在函数
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
的return YES;前需要添加如下代码来初始化程序
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[[MBGPlatform sharedPlatform] setDelegate:self withWindow:self.window withRootViewController:self.window.rootViewController];
if ([MBGPlatform isProductionEnv]) {
[MBGPlatform initialize:MBG_REGION_CN serverType:MBG_PRODUCTION consumerKey:@"your production app key" consumerSecret:@"your production app secret" appId:@"your appid"];
}else {
[MBGPlatform initialize:MBG_REGION_CN serverType:MBG_SANDBOX consumerKey:@"your sandbox app key" consumerSecret:@"your sandbox app secret" appId:@"your appid"];
}
[MBGPlatform registerTick];
[[MBGPlatform sharedPlatform] checkLoginStatus];
return YES;
}
注意,将你的appid,key,secret填入上述代码的initialize:方法中
3.3 退到后台和从后台恢复的相关代码
应用程序需要处理退后台,以及从后台恢复两个事件。
3.3.1 退到后台时需要调用的代码
在函数
- (void)applicationWillResignActive:(UIApplication *)application
或者函数
- (void)applicationDidEnterBackground:(UIApplication *)application
中添加如下代码(根据游戏需求,只需在上述一个函数中添加即可,无特殊需求就在applicationDidEnterBackground中添加)
[MBGPlatform pause];
3.3.2 从后台恢复时需要调用的代码
在函数
- (void)applicationWillEnterForeground:(UIApplication *)application
或者函数
- (void)applicationDidBecomeActive:(UIApplication *)application
中添加如下代码(根据游戏需求,只需在上述一个函数中添加即可,无特殊需求可在applicationDidBecomeActive中添加)
[MBGPlatform resume];
3.4 编译运行
至此梦宝谷iOS SDK应该已可以编译运行。Mobage iOS SDK 同时支持模拟器和实体机,
4 Mobage功能接入
4.1 交易
Mobage平台有统一的货币—M币,用户在社区用支付宝,财付通等方式将人民币充值成M币。对于充值M币这个流程,SDK用webview实现,整个平台是统一的,不需要开发商再做额外的接入。而开发商需要实现的是用M币来购买游戏内道具的流程。
mobage提供3种流程,详细流程可以参考(https://docs.mobage.com/display/CNSPAPP/How+to+use+bank+and+eco+native), 如果只是简体平台和繁体平台,并没有海外平台的计划,则推荐使用第一种流程接入,这里介绍一下第一种流程的大致步骤:
(1)先到开发者网站注册道具信息,


(2)在游戏控制台 - 2其他功能追加 - Bank回调设置中设置该应用的回调地址,用于接收交易完成之后Mobage发出的Http请求,以通知游戏服务器交易完成。(该步骤可选,如未登记回调地址则不会调用。)
(2)按create->open->close的顺序在createTransaction的onSuccess回调函数里面调用openTransaction, 在openTransaction的onSuccess回调函数里面调用closeTransaction,注意交易必须成功close交易才算完成。虽然在openTransaction的时候已经扣费,但是如果没有close,10分钟之后交易会被自动cancel并将扣除的M币返回给用户账号。
(3)在close之后Mobage平台会向登记的回调地址发送http请求,开发者需要对该请求进行处理。详情参考https://docs.mobage.com/display/CNSPAPP/Callback+function+description
4.2 其他API
关于其他API,可参考随SDK附带的示例代码及文档。
目录