当前位置：首页 > 帮助文档 > iOS SDK接入说明
iOS SDK单机接入
0 接入必读
0.1 接入准备
接入开始前，请先做好如下准备工作：1.创建游戏，获取渠道参数及配置文件
接入前，需要由掌趣项目负责人完成渠道申报并在掌趣后台进行配置，从而获取到该游戏的渠道参数、掌趣配置文件（见下图）。掌趣配置文件（ourpalm.cfg）按照渠道及语言机型的不同，被分别打到对应的压缩文件目录中。
注意：接入前，务必将SDK包中assets目录下ourpalm.cfg替换为对应渠道配置文件中的ourpalm.cfg，否则很可能会报错。
MIS平台配置参数及获取配置文件的说明
2.完成计费申报，填写商品录入模板
计费测试前，还需要完成在渠道的计费点申报，填写《商品录入模板》（见下图），并由掌趣项目负责人完成在掌趣后台的配置。
MIS平台配置计费点方法
0.2 版本命名
游戏版本命名（安卓是指androidmainfest.xml 中的versionName，IOS是指info.plist中的Bundle version），必须遵循如下规则要求（详见附录3.5）1 SDK构成
掌趣IOS SDK主要由以下几部分构成，如下图：
1.Ourpalmlib掌趣静态库
只支持armv7、armv7s和arm64架构，固件要求iOS5.0以上
2.Thirdilb第三方静态库.a或Framework
掌趣静态库封装调用的第三方静态库或Framework
3.OpenSource第三方开源库
掌趣SDK所使用的第三方开源库或源文件，避免SDK与游戏产生冲突
SDK支持平台
掌趣 IOS SDK支持 iPhone、iPad、iPod Touch设备，要求armv7、armv7s或arm64架构，操作系统要求Mac要求Lion以上，Xcode要求5.0以上，iOS SDK要求5.0以上。
2 SDK概述
2.1开发环境搭建
2.1.1 工程配置
Xcode->Project->Build Settings工程配置1.添加库的连接参数
请在工程文件Build Settings处，找到Other Linker Flags，并添加以下内容
2.请将Apple LLVM 5.0 – Language – C++中C++ Standard Library项修改为以下内容
注意：
如果你有更改过或使用的是Target中的配置，那么需要在Target的配置中同样修改此配置！
3.其他编译设置
2.1.2 Framework添加及配置（请特别注意！）
1、配置Info.plist文件Xcode->Project->Info
请在工程文件Info中设置SDK所需要的参数，例如：单机appstore
2、添加Framework及资源
请将lib拖到你的工程Groups&Files面板中，如下图：
添加Framework后，如下图：
3、设置URL Scheme
设置方法如下：
选中工程中的Target，选中Info标签页，找到底下的URLTypes，展开，点击加号，创建URL Scheme。
点击后，Identifier字段与URL Scheme字段填入格式为bundleid
示例如下：
2.2SDK初始化接口
2.2.1 功能说明
1、初始化第三方SDK，同时获取SDK所需要的初始化数据2、检查版本更新，初始化内部封装了第三方的更新接口
2.2.2 接口定义
注意：初始化接口在不同游戏引擎添加的位置不同，具体参看代码示例2.2.3 参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| controller | 必填 | UIViewController* | 游戏的rootViewcontroller |
| opInfo | 必填 | OPInitParam | 用于初始化的参数类 |
2.2.4 OPInitParam参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| mDebugModel | 必填 | std::string | 是否开启测试模式 |
| mGameResVersion | 非必填 | std::string | 游戏资源版本号 |
| mAllowCharge | 非必填 | std::string | 是否允许充值，默认为true |
| mAutoOrientation | 非必填 | std::string | 是否允许自动旋转，默认为true |
| mScreenOrientation | 非必填 | OPScreenOrientation | 界面初始化方向，默认为横屏 |
| mUseAPIInterface | 非必填 | bool | 设置掌趣官网登录（true：使用API接口，false：使用官网界面） |
2.2.5 接口示例
(1)对于coco2d-x引擎：初始化接口必须放在cocos2d::CCApplication::sharedApplication()->run();之后，且需要添加代码self.window.rootViewController = viewController;
(2)对于unity3d引擎：
初始化接口必须放在OnUnityReady();之后。
2.3注册登录接口
2.3.1 流程说明
1.手机游戏客户端会调用掌趣sdk进行sdk初始化操作
2.掌趣sdk向掌趣用户中心服务器发起登录/注册的请求
3.掌趣用户中心服务器向掌趣sdk返回token、用户信息等等
4.手机游戏客户端向游戏服务器发送token、用户信息等等
5.游戏服务器根据token向掌趣用户中心服务器获取用户信息
6.掌趣用户中心服务器向游戏服务器返回用户信息
7.游戏服务器向手机游戏客户端返回登录结果
注：现在大部分游戏未实现5和6的流程
2.3.2 登录（客户端调用，必须）
功能说明登录掌趣用户中心。游戏客户端调用登录接口（RegisterLogin）前，需要通过设置登录回调接口（RegisterLoginCallBack）将回调函数指针传给SDK，登录成功后，掌趣SDK会通过回调函数通知游戏客户端。
接口定义参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| OPUserType | 必填 | enum | 掌趣官网登录类型 |
接口示例
其中对应的OPUserType类型返回的JSON数据格式说明
登录成功时
{"id":"掌趣平台分配的用户唯一id",
"returnJson":{第三方SDK平台返回的数据,一般情况下游戏无需关心},
"tokenId":"掌趣分配的tokenId",
"userName":"掌趣平台中的用户名"}
登录失败时
{"desc":"失败描述",
"reset":"状态码","status":"1"}
注意：返回失败时，SDK会弹出提示框！对于请求超时（状态码为101），不会弹出提示框，游戏可自动重新连接或自己添加提示框。
2.3.3 登录注销（客户端调用，根据SDK接口信息来决定是否调用）
功能说明注销当前登陆账号。游戏客户端调用注销接口（LogOut）前，需要通过设置注销回调接口（RegisterLogoutCallBack）将回调函数指针传给SDK，注销成功后，掌趣SDK会通过回调函数通知游戏客户端。
接口定义接口示例
2.3.4 切换账号（客户端调用，根据第三方渠道SDK接口信息来决定是否调用）
功能说明注销当前登录账号，切换成功后会调用注销回调函数通知游戏客户端。
接口定义
接口示例
2.3.5 登录验证（服务器调用，可选）
功能说明游戏服务器端根据token去用户中心拿取用户信息，该接口可以避免客户端随意修改信息的漏洞。
接口采用HTTP请求，参数以JSON数据格式，POST方式发给用户中心
接口定义请求URL：http://auth.gamebean.net/ucenter/uMember/userLoginMgr.do (中国大陆)
参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| interfaceId | 必须 | String | 接口号，固定填写0002即可 |
| tokenId | 必须 | String | 用户中心返回的tokenId |
接口示例（接口采用POST格式传输）返回参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| bindingMode | 必须 | String | 0为手机方式绑定；1为邮箱方式绑定 |
| loginType | 必须 | String | 用户登录标识：（ 0：是第三方平台注册 1：为官网注册 2：为快速注册 9：为其它平台登录 10：为官网登录 11：为快速登录 ） |
| status | 必须 | String | 返回状态 |
| reset | 必须 | String | 状态内码 |
| desc | 必须 | String | 状态描述 |
| tokenId | 必须 | String | 单点登录标识 |
| userInfo | 必须 | String | 用户信息（具体返回参数见示例） |
返回json格式信息：
各地域接口地址清单
A 中国大陆 http://auth.gamebean.net/ucenter/uMember/userLoginMgr.do
B 港台以及东南亚地域 http://auth.hk.gamesbean.net/ucenter/uMember/userLoginMgr.do
C 韩国 http://auth.fingertips.kr/ucenter/uMember/userLoginMgr.do
2.4充值发货接口
2.4.1 流程说明
1.游戏客户端向掌趣SDK发起计费请求
2.掌趣SDK向掌趣计费中心发起计费求情
3.掌趣计费中心生成支付订单号，返回支付结果给掌趣SDK
4.掌趣SDK返回支付结果给游戏客户端，游戏客户端根据支付结果发货
2.4.2 支付接口（客户端调用，必须）
功能说明游戏客户端通过调用计费接口，实现游戏中的道具购买。游戏客户端调用计费接口（Purchase）前,需要继承PurchaseListener，通过设置接口（SetListener）将对象指针传给SDK，计费成功后，掌趣SDK会通过OnPurchaseResult通知游戏客户端。当游戏收到购买结果必须调用接口（ConfirmCharge()），用以保证交易成功。
接口定义
参数说明
| 参数名称 | 重要性 | 类型 | 说明 |
| mPrice | 必填 | std::string | 商品价格 |
| mCurrencyType | 必填 | std::string | 货币类型(1人民币2美元3日元4港币5英镑6新加坡币7越南盾8台币9韩元10泰铢) |
| mPropId | 必填 | std::string | 商品ID |
| mPropName | 必填 | std::string | 商品名称（不可带数量） |
| mPropCount | 必填 | std::string | 商品数量 |
| mPropDescribe | 非必填 | std::string | 商品描述 |
| mExtendParams | 非必填 | std::string | 自定义参数 |
接口示例
2.4.3 应用间调用接口（客户端调用，必须）
功能说明在调用第三方app进行支付时（例如支付宝），通过设置该接口，便可在支付完成后直接返回到游戏中。
接口定义
接口示例
2.5其他功能接口
2.5.1 获取SDK可用接口信息
功能说明获取SDK接口是否可用。
接口定义接口示例返回数据如下,JSON格式
{"Logout":"0","SwitchAccount":"0","EnterPlatform":"1"}
1: 表示接口可用
0: 表示接口不可用
例如以上返回数据说明：登陆注销接口不需要调用；切换账号接口不需要调用，进入用户中心接口需要调用。
2.5.2 设置工具栏接口
功能说明设置工具栏的显示状态和位置。
接口定义接口示例
2.5.3 进入应用论坛接口
功能说明进入应用论坛界面。
接口定义接口示例
2.5.4 进入平台中心接口（客户端调用，根据SDK接口信息来决定是否调用）
功能说明进入平台中心的首页界面。
接口定义接口示例
2.5.5 显示暂停页面接口（客户端调用，必须）
功能说明在游戏暂停或者从后台恢复的时候显示暂停页。
接口定义接口示例
3 附录
3.1 附1：客户端错误码
| 状态码 | 说明 |
| 101 | 连接超时 |
| 102 | 网络异常，请检查网络 |
| 103 | 数据异常 |
| 104 | SDK初始化参数错误 |
| 105 | SDK语言配置文件错误 |
| 106 | Ourpalm.cfg配置文件错误 |
| 107 | SDK未初始化成功 |
| 108 | SDK未设置登录回调 |
| 109 | 未设置服务器id |
| 110 | 未设置价格 |
| 111 | 未设置货币类型 |
| 112 | 未设置商品名称 |
| 113 | 未设置商品id |
| 114 | 未设置虚拟货币单位 |
| 115 | 未设置虚拟货币数量 |
| 116 | 未设置发货地址 |
| 117 | 未设虚拟货币单位 |
| 118 | 未设商品数量 |
| 119 | 用户取消支付 |
| 120 | 支付失败 |
| 121 | 支付页面加载失败 |
| 200 | 支付成功 |
| 201 | 下单成功 |
3.2 附2：计费中心错误码
| 状态外码 | 状态内码 | 描述 |
| 0 | 21000 | 成功 |
| 逻辑错误状态码(预留1000个错误码) | ||
| 1 | 21001 | 请求的json串格式不正确 |
| 1 | 21002 | json对象格式不正确 |
| 1 | 21003 | json字符串转换为对象错误 |
| 1 | 21004 | 道具格式不正确 |
| 1 | 21005 | 返回bean格式不正确 |
| 1 | 21006 | 没有筛出计费点 |
| 1 | 21007 | 驱动格式不正确 |
| 1 | 21099 | 全局异常错误 |
| 1 | 21100 | common节点格式不正确 |
| 1 | 21101 | options节点格式不正确 |
| 1 | 21102 | common中interfaceId格式不正确 |
| 1 | 21103 | tokenid格式不正确 |
| 1 | 21104 | serviceId格式不正确 |
| 1 | 21105 | deviceGroupId格式不正确 |
| 1 | 21106 | localeId格式不正确 |
| 1 | 21120 | device格式不正确 |
| 1 | 21121 | mac格式不正确 |
| 1 | 21122 | 手机号码错误 |
| 1 | 21123 | 发货地址格式不正确 |
| 1 | 21130 | 批价ID格式不正确 |
| 1 | 21131 | 道具ID格式不正确 |
| 1 | 21132 | sdkVersion格式不正确 |
| 1 | 21133 | userId格式不正确 |
| 1 | 21134 | roleId格式不正确 |
| 1 | 21135 | roleName格式不正确 |
| 1 | 21136 | gameType格式不正确 |
| 1 | 21137 | gameServerId格式不正确 |
| 1 | 21138 | gameClientVersion格式不正确 |
| 1 | 21139 | 当前业务下没有该道具 |
| 1 | 21140 | 计费点ID格式不正确 |
| 1 | 21141 | 充值金额格式不正确 |
| 1 | 21142 | 货币类型格式不正确 |
| 1 | 21143 | gameServerId在平台没有启用 |
| 1 | 21144 | 游戏产品不存在 |
| 1 | 21145 | 平台操作失败. |
| 1 | 21146 | 请求报文头格式不正确 |
| 1 | 21147 | 手机平台ID格式不正确 |
| 1 | 21148 | 设备名称格式不正确 |
| 1 | 21149 | 设备系统版本号格式不正确 |
| 1 | 21150 | 设备分辨率格式不正确 |
| 1 | 21151 | 设备UDID格式不正确 |
| 1 | 21152 | 运营商格式不正确 |
| 1 | 21153 | 设备厂商格式不正确 |
| 1 | 21154 | 手机格式不正确 |
| 1 | 21155 | 用户ID格式不正确 |
| 1 | 21156 | 代计费功能同步渠道异常 |
| 1 | 21157 | 超过用户日最大计费金额 |
| 1 | 21158 | 超过用户月最大计费金额 |
| 1 | 21159 | 黑名单用户 |
| 1 | 21160 | 充值失败 |
| 1 | 21161 | 超过计费点日最大计费金额 |
| 1 | 21162 | 超过计费点月最大计费金额 |
| 1 | 21163 | 道具名称不能为空 |
| 1 | 21164 | 通知发货成功 |
| 1 | 21165 | 计费失败 |
| 1 | 21166 | 等待支付结果 |
| 1 | 21167 | 指令错误 |
| 1 | 21168 | 已经订购，无需重复订购（包月） |
| 1 | 21169 | 黑名单用户 |
| 1 | 21170 | 虚拟货币单位格式不正确 |
| 1 | 21171 | 虚拟货币数量格式不正确 |
| 1 | 21172 | 虚拟货币单位非法 |
| 1 | 21173 | 虚拟货币数量非法 |
| 1 | 21174 | 货币格式非法 |
| 1 | 21175 | 发货地址在mis上没有配置 |
| 1 | 21176 | SDK同步_验签失败 |
| 1 | 21177 | SDK同步_订单缓存不存在 |
| 1 | 21178 | SDK同步_签名信息格式不正确 |
| 1 | 21179 | 欢畅官网_订单号格式不正确 |
| 1 | 21180 | 欢畅官网_订单缓存不存在 |
| 1 | 21181 | 欢畅官网_充值卡号格式不正确 |
| 1 | 21182 | 欢畅官网_充值卡类型格式不正确 |
| 1 | 21183 | 欢畅官网_充值卡密码格式不正确 |
| 1 | 21184 | 欢畅官网_银行类型格式不正确 |
| 1 | 21185 | 礼包码不得为空 |
| 1 | 21186 | 发货失败 |
| 1 | 21187 | 礼包码不存在或不可用 |
| 1 | 21188 | 礼包码已过期 |
| 1 | 21189 | 礼包码未领取 |
| 1 | 21190 | 礼包码已使用 |
| 1 | 21191 | 该用户已兑换过礼包码 |
| 1 | 21192 | 该设备已兑换过礼包码 |
| 1 | 21193 | 礼包活动暂停中 |
| 1 | 21194 | 礼包码已经用完 |
| 1 | 21195 | 网络异常 |
| 1 | 21196 | 服务内部错误 |
| 1 | 21197 | 传入的礼包码有错误 |
| appsotre平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22000 | appstore：app_product_id 格式不正确 |
| 江苏移动sdk平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22050 | 江苏移动：cmcc_pay_code 格式不正确 |
| GooglePlay sdk平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22100 | googlePlay_pay_code 格式不正确 |
| GooglePlay sdk平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22100 | googlePlay_pay_code 格式不正确 |
| mm sdk平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22100 | googlePlay_pay_code 格式不正确 |
| 世纪佳缘 sdk平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22200 | 世纪佳缘接口 game_partner_id 游戏合作ID格式不正确 |
| 1 | 22201 | 世纪佳缘接口 game_jf_id 游戏计费点编号格式不正确 |
| 1 | 22202 | 世纪佳缘接口 game_id 游戏id格式不正确 |
| 1 | 22203 | 世纪佳缘接口 game_cost 金额格式不正确 |
| 1 | 22204 | 世纪佳缘接口 mobile 充值手机号格式不正确 |
| 1 | 22205 | 世纪佳缘接口 game_pay_type 支付类型格式不正确 |
| 1 | 22206 | 世纪佳缘接口 param 短信上行自定义内容格式不正确 |
| 1 | 22207 | 世纪佳缘接口 sign 加密格式不正确 |
| 1 | 22208 | 世纪佳缘接口 签名数据不符 |
| 1 | 22209 | 世纪佳缘接口 game_partner_id与计费点上参数不符 |
| 1 | 22210 | 世纪佳缘接口 game_jf_id与计费点上参数不符 |
| 1 | 22211 | 世纪佳缘接口 game_id与计费点上参数不符 |
| 1 | 22212 | 世纪佳缘接口 根据指令没有相关代计费配置 |
| 华谊 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22250 | 根据指令没有相关代计费配置 |
| 1 | 22251 | itemId_短信上行自定义内容格式不正确 |
| 1 | 22252 | transactionId_内容格式不正确 |
| 1 | 21188 | 礼包码已过期 |
| 1 | 22253 | serviceId_内容格式不正确 |
| 1 | 22254 | spId_内容格式不正确 |
| 1 | 22255 | serviceType_内容格式不正确 |
| 1 | 22256 | feeType_内容格式不正确 |
| 1 | 22257 | serviceId与计费点上参数不符 |
| 1 | 22258 | spId与计费点上参数不符 |
| 1 | 22259 | serviceType与计费点上参数不符 |
| 1 | 22260 | feeType与计费点上参数不符 |
| 1 | 22262 | success_内容格式不正确 |
| 联通时科 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22304 | 联通时科外放接口 Mobile 充值手机号格式不正确 |
| 1 | 22305 | 联通时科外放接口 sms_msg 外放代码格式不正确 |
| 1 | 22306 | 联通时科外放接口 ret 计费结果格式不正确 |
| 1 | 22307 | 联通时科外放接口 message 计费错误信息格式不正确 |
| 1 | 22308 | 联通时科外放接口 sec |
| 1 | 22309 | 联通时科外放接口 签名数据不符 |
| 1 | 22310 | 联通时科外放接口 没有相关代计费配置 |
| 1 | 22311 | 联通时科外放接口 传入订单号格式 不正确 |
| 微米 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22354 | 微米外放接口 mobile 充值手机号格式不正确 |
| 1 | 22355 | 微米外放接口 Price 金额格式不正确 |
| 1 | 22356 | 微米外放接口 ExData 上行自定义内容格式不正确 |
| 1 | 22357 | 微米外放接口 param WIMI POST上传的参数无效 |
| 1 | 22358 | 微米外放接口 没有相关代计费配置 |
| 1 | 22359 | 微米外放接口 【POST】-回传的XML报文未成功获取 |
| 联动优势 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22400 | 联动优势外放接口 mobileId 充值手机号码格式不正确 |
| 1 | 22401 | 联动优势外放接口 goodsId 短信上行商品号指令格式不正确 |
| 1 | 22402 | 联动优势外放接口 没有相关代计费配置 |
| 1 | 22403 | 联动优势外放接口 merId 商户号格式不正确 |
| 1 | 22404 | 联动优势外放接口 amtType 货币类型格式不正确 |
| 1 | 22405 | 联动优势外放接口 bankType 货币类型格式不正确 |
| 1 | 22406 | 联动优势外放接口 version 版本号格式不正确 |
| 1 | 22407 | 联动优势外放接口 sign 签名格式不正确 |
| 1 | 22408 | 联动优势外放接口 orderId 商户订单号格式不正确 |
| 1 | 22409 | 联动优势外放接口 merDate 商户日期格式不正确 |
| 1 | 22410 | 联动优势外放接口 payDate 平台支付日期格式不正确 |
| 1 | 22411 | 联动优势外放接口 amount 商品金额格式不正确 |
| 1 | 22412 | 联动优势外放接口 transType 交易类型格式不正确 |
| 1 | 22413 | 联动优势外放接口 settleDate 账务清算日期格式不正确 |
| 1 | 22414 | 联动优势外放接口 merPriv 商户私有信息格式不正确 |
| 1 | 22415 | 联动优势外放接口 retCode 返回码格式不正确 |
| 1 | 22416 | 联动优势外放接口 平台向用户下订单时签名验证不成功 |
| 1 | 22417 | 联动优势外放接口 平台向用户同步信息时签名验证不成功 |
| 1 | 22418 | 联动优势外放接口 平台向商户下订单金额超过当前计费点的实际金额 |
| 1 | 22419 | 联动优势外放接口 当前计费点不满足计费限额，订单状态更新为异常 |
| IVR 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22450 | IVR外放接口 没有相关代计费配置 |
| 1 | 22451 | IVR外放接口 开始计费时间格式不正确 |
| 1 | 22452 | IVR外放接口 结束计费时间格式不正确 |
| 1 | 22453 | IVR外放接口 呼叫号码格式不正确 |
| 1 | 22454 | IVR外放接口 被叫号码格式不正确 |
| 1 | 22455 | IVR外放接口 没有找到相关计费点配置 |
| 官网SMS 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22500 | Official官网SMS计费回调接口 sign 签名验证不通过 |
| 1 | 22501 | Official官网SMS计费回调接口 订单不存在 |
| 当乐SDK 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22550 | downloadjoy SDK计费回调接口 result 返回结果验证不通过 |
| 1 | 22551 | downloadjoy SDK计费回调接口 money 返回结果验证不通过 |
| 1 | 22512 | downloadjoy SDK计费回调接口 mid 返回结果验证不通过 |
| 1 | 22513 | downloadjoy SDK计费回调接口 time 返回结果验证不通过 |
| 1 | 22514 | downloadjoy SDK计费回调接口 signature 返回结果验证不通过 |
| 1 | 22515 | downloadjoy SDK计费回调接口 ext 返回结果验证不通过 |
| 1 | 22516 | downloadjoy SDK计费回调接口 签名验证不通过 |
| 百度多酷SDK 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22600 | duoku SDK计费回调接口 amount 返回结果验证不通过 |
| 1 | 22601 | duoku SDK计费回调接口 cardtype 返回结果验证不通过 |
| 1 | 22602 | duoku SDK计费回调接口 orderId 返回结果验证不通过 |
| 1 | 22603 | duoku SDK计费回调接口 result 返回结果验证不通过 |
| 1 | 22604 | duoku SDK计费回调接口 timetamp 返回结果验证不通过 |
| 1 | 22605 | duoku SDK计费回调接口 client_secret 返回结果验证不通过 |
| 1 | 22606 | duoku SDK计费回调接口 签名验证不通过 |
| 爱思SDK 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22650 | I4 SDK计费回调接口 amount 返回结果验证不通过 |
| 1 | 22651 | I4 SDK计费回调接口 order_id 返回结果验证不通过 |
| 1 | 22652 | I4 SDK计费回调接口 billno 返回结果验证不通过 |
| 1 | 22653 | I4 SDK计费回调接口 account 返回结果验证不通过 |
| 1 | 22654 | I4 SDK计费回调接口 status 返回结果验证不通过 |
| 1 | 22655 | I4 SDK计费回调接口 app_id 返回结果验证不通过 |
| 1 | 22656 | I4 SDK计费回调接口 role 返回结果验证不通过 |
| 1 | 22657 | I4 SDK计费回调接口 zone 返回结果验证不通过 |
| 1 | 22658 | I4 SDK计费回调接口 sign 返回结果验证不通过 |
| 1 | 22659 | I4 SDK计费回调接口 签名验证不通过 |
| 华谊 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22700 | 本月已订购 |
| 1 | 22701 | 用户未登录 |
| 1 | 22702 | 手机号有误 |
| 1 | 22703 | token不能为空 |
| 1 | 22704 | 计费点不能为空 |
| 1 | 22705 | 跳转地址不能为空 |
| 安智 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22750 | 安智回调接口 第三方订单ID不存在 |
| 1 | 22751 | 安智回调接口 订单金额不存在 |
| 1 | 22752 | 安智回调接口 回调信息 用户自定义参数不存在 |
| 1 | 22753 | 安智回调接口 回传状态不存在 |
| 1 | 22754 | 安智回调接口 实际支付金额不存在 |
| 步步高 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22800 | 步步高下单失败 |
| 1 | 22801 | 步步高回调验签失败 |
| 1 | 22802 | 步步高回调支付失败 |
| 微信 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22850 | 获取access_token值返回错误 |
| 1 | 22851 | 下单失败 |
| 联想 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22900 | 签名错误 |
| 1 | 22901 | 支付状态错误 |
| 1 | 22902 | 支付状态错误 |
| 朗天 平台逻辑错误状态码（每个平台预留50个错误码） | ||
| 1 | 22950 | 上行内容格式不正确 |
| 1 | 22951 | 代计费配置错误 |
| 1 | 22952 | 手机号码格式不正确 |
| 1 | 22953 | 处理结果格式不正确 |
| 1 | 22954 | 流水号格式不正确 |
| 1 | 22955 | 上行号码格式不正确 |
3.3 附3：用户中心错误码
| 状态外码 | 状态内码 | 描述 |
| 0 | 1000 | 成功 |
| 逻辑错误状态码(系统平台 预留200个错误码) | ||
| 1 | 1001 | 请求格式错误 |
| 1 | 1002 | interfaceId错误 |
| 1 | 1003 | gameKey错误 |
| 1 | 1004 | loginFlag登陆标识错误 |
| 1 | 1005 | 获取静态参数错误 |
| 1 | 1006 | 用户名不能为空 |
| 1 | 1007 | 用户名长度错误，最短6位，最长100位 |
| 1 | 1008 | 用户名包含空格 |
| 1 | 1009 | 用户名含有非法字符 |
| 1 | 1010 | 用户名包含中文 |
| 1 | 1011 | 密码不能为空 |
| 1 | 1012 | 密码长度错误，最短6位，最长100位 |
| 1 | 1013 | 密码包含中文 |
| 1 | 1014 | 密码含有非法字符 |
| 1 | 1015 | SDK必填参数为空 |
| 1 | 1016 | SDK必填参数缺失 |
| 1 | 1017 | 手机号已经和当前账号绑定 |
| 1 | 1018 | 当前玩家的手持设备的IP地址已经被游戏封停 |
| 1 | 1019 | 请求第三方鉴权请求回传参数为空 |
| 1 | 1020 | 上行的参数roleName和roleId不能同时为空 |
| 1 | 1021 | 上行的参数server不能为空 |
| 1 | 1022 | 上行的参数time不能为空 |
| 1 | 1099 | 其它请求错误 |
| 1 | 1101 | 用户名不存在或错误 |
| 1 | 1102 | 密码错误 |
| 1 | 1103 | 登录失败 |
| 1 | 1104 | 单点登录tokenID无效 |
| 1 | 1105 | 第三方返回参数为空 |
| 1 | 1106 | 用户名已经存在 |
| 1 | 1107 | 服务器缓存连接失败 |
| 1 | 1108 | 连接第三方服务器异常 |
| 1 | 1109 | 服务器端参数未配置 |
| 1 | 1110 | 传入的mac的有误 |
| 1 | 1111 | 传入的userPlatformId有误 |
| 1 | 1112 | mac已经存在 |
| 1 | 1113 | 用户名和密码不匹配 |
| 1 | 1114 | ID不存在 |
| 1 | 1115 | 新密码不能设置为空 |
| 1 | 1116 | uId不能为空 |
| 1 | 1117 | token过期，请重新登陆 |
| 1 | 1118 | 修改失败，新密码与原密码相同 |
| 1 | 1119 | tokenId不能为空 |
| 1 | 1120 | mac不能为空 |
| 1 | 1121 | mac或者IDFA不能为空 |
| 1 | 1122 | mac或者deviceUniqueID不能为空 |
| 1 | 1123 | 传入的mac有误 |
| 1 | 1124 | 传入的版本号错误 |
| 1 | 1125 | 传入的uId有误 |
| 1 | 1126 | 账号已绑定 |
| 1 | 1127 | 已绑定过手机 |
| 1 | 1128 | 手机号有误 |
| 1 | 1129 | 验证码失效或有误 |
| 1 | 1130 | 手机未绑定 |
| 1 | 1131 | 短信发送失败 |
| 1 | 1132 | 账号已封停 |
| 1 | 1133 | mac已封停 |
| 1 | 1134 | 账号不存在 |
| 1 | 1135 | 该账户已绑定手机 |
| 1 | 1136 | 该账户未绑定手机 |
| 1 | 1137 | 帐号mac都未封停 |
| 1 | 1138 | 业务Id错误 |
| 1 | 1139 | 推广渠道Id错误 |
| 1 | 1140 | 机型组Id错误 |
| 1 | 1141 | 地区Id错误 |
| 1 | 1142 | hadoop目录错误 |
| 1 | 1143 | 找回密码次数超过当天次数限制 |
| 1 | 1144 | 请求头oUa为空 |
| 1 | 1145 | 请求头version为空 |
| 1 | 1146 | IP鉴权失败，非法客户端IP |
| 1 | 1147 | 找回密码失败：快登用户不能找回密码 |
| 1 | 1148 | 58位特征串为空 |
| 1 | 1149 | 58位特征串位数不足58位 |
| 1 | 1150 | sid为空异常 |
| 1 | 1151 | 产品黑名单异常 |
| 1 | 1152 | 用户昵称为空异常 |
| 1 | 1153 | 接口暂未定义异常 |
| 1 | 1154 | 接口暂无访问权限异常 |
| 1 | 1155 | userName生成的伪序列为0异常 |
| 1 | 1156 | account不能为空 |
| 1 | 1157 | accountSign不能为空 |
| 1 | 1158 | 签名无效 |
| 1 | 1159 | 平台ID未在白名单异常。 |
| 1 | 1160 | jsonStr为空异常 |
| 1 | 1161 | 验证码错误 |
| 1 | 1162 | 当前手机号已经被注册 |
| 1 | 1163 | 用户中心没有该手机号信息 |
| 1 | 1164 | 手机号没有与当前注册账号绑定 |
| 1 | 1165 | 昵称已被使用 |
| 1 | 1166 | 旧密码有误 |
| 1 | 1167 | 确认密码有误 |
| 1 | 1168 | 确认密码和新密码有误 |
| 1 | 1169 | email不能为空 |
| 1 | 1170 | 用户名长度只能在6-18位字符之间 |
| 1 | 1171 | 用户名只能由数字、字母、下划线组成 |
| 1 | 1172 | 密码长度只能在6-14位之间 |
| 1 | 1173 | 密码不能是纯数字 |
| 1 | 1174 | 密码不能是纯字母 |
| 1 | 1175 | 密码只能由数字、字母组成 |
| 1 | 1176 | 无法获取快速登录所需的设备信息，不能进行快速登录！ |
| 1 | 1177 | 修改密码次数超过当天次数限制 |
| 替换官网用户相关异常状态码（每个平台预留50个错误码） | ||
| 1 | 2356 | 目标用户的用户名更新失败,可能重名 |
| 1 | 2357 | 修改要找回的账号信息失败 |
| 1 | 2358 | 要找回用户的邮箱绑定信息更新失败 |
| 1 | 2359 | 要找回用户的手机绑定信息更新失败 |
| 1 | 2404 | 旧用户或者新用户不是官网用户 |
| 1 | 2405 | 旧用户不是快登用户，或新用户不是官网正式用户 |
| 1 | 2406 | 用户信息错误 |
| 封停帐号错误状态码（每个平台预留50个错误码） | ||
| 1 | 3000 | closureType有误 |
| 1 | 3001 | closureDatas有误 |
| 1 | 3002 | closureStartTime有误 |
| 1 | 3003 | closureEndTime有误 |
| 道具帐号错误状态码（每个平台预留50个错误码） | ||
| 1 | 3100 | 道具tokenId有误 |
| 1 | 3101 | 道具bsid有误 |
| 1 | 3102 | 道具gameKey有误 |
| 用户是否在线错误状态码（每个平台预留50个错误码） | ||
| 1 | 3450 | 用户不在线上 |
| 1 | 3451 | uids不能为空 |
| 1 | 3452 | flag不能为空 |
| 心跳错误状态码（每个平台预留50个错误码） | ||
| 1 | 3500 | 心跳接口时间间隔参数有误 |
| SDK版本升级错误状态码（每个平台预留50个错误码） | ||
| 1 | 3600 | SDK版本不能为空 |
| 1 | 3601 | 未能检测到版本信息 |
| 用户角色对应错误状态码（每个平台预留50个错误码） | ||
| 1 | 3800 | roleId不能为空 |
| 1 | 3801 | roleName不能为空 |
3.4 附4：货币类型及对应ID
在MIS中的货币有总共十种，货币ID是没有限定位数的纯自增值
| 货币ID | 货币名称 | 货币单位 |
| 1 | 人民币 | 分 |
| 2 | 美元 | 美分 |
| 3 | 日元 | 円 |
| 4 | 港币 | 分 |
| 5 | 英镑 | 便士 |
| 6 | 新加坡币 | 分 |
| 7 | 越南盾 | 盾 |
| 8 | 台币 | 元 |
| 9 | 韩元 | 分 |
| 10 | 泰铢 | 萨当 |
3.5 附5：版本命名规则
游戏客户端版本命名（安卓是指androidmainfest.xml 中的versionName，IOS是指info.plist中的Bundle version），必须遵循如下规则要求：
1. 版本信息不能出现数字和小数点之外的字符，以小数点进行分割，分隔后每个分区只有一位的情况可以是零，如果是多位则首位必须是非零，正确格式如 1.0.0、4.3.2.0，非法格式如
4.0.3-23940 不能有横杠
2.0.35(58390) 不能出现括号
1.0.a 不能带字母
1.0.01 多位数字首位不能为0
2. 版本信息从左到右按照每个分区转为Integer进行比较，如
1.1.1 > 1.0.10 （1 > 0）
1.0.9 ＜ 1.0.10 （9 ＜10）
1.0.11 ＜ 1.0.101 （11＜101）
3. 后续版本信息不允许增加小数点，如：
1.0版本上线后，后续版本不可以出现1.0.1，否则会按非法版本号处理，将会强制提示更新1.0版本
3.6 附6：礼包码兑换错误码
| 状态码 | 说明 |
| 21185 | 礼包码不得为空 |
| 21186 | 发货失败 |
| 21187 | 礼包码不存在或不可用 |
| 21188 | 礼包码已过期 |
| 21189 | 礼包码未领取 |
| 21190 | 礼包码已使用 |
| 21191 | 该用户已兑换过礼包码 |
| 21192 | 该设备已兑换过礼包码 |
| 21193 | 礼包活动暂停中 |
| 21194 | 礼包码已经用完 |
| 21195 | 网络异常 |
| 21196 | 服务内部错误 |
| 21197 | 传入的礼包码有错误 |
| 21198 | 传入的礼包ID有错误 |
| 21199 | 用户未登录 |
| 21200 | 兑换超过用户最大限制 |
| 21201 | 游戏产品有误 |
| 21202 | 策略关系不存在 |
| 21203 | 联运渠道或推广渠道有误 |
| 21204 | 推广渠道有误 |
| 21205 | 机型组有误 |
| 21206 | 语言有误 |
| 21207 | 逻辑服策略不存在 |
| 21208 | 逻辑服有误 |
| 23157 | 礼包码未到生效时间 |