(MatchVS对战引擎对战接口使用说明v1.2.6.docxVIP

MatchVS接口说明对战引擎（For Cocos2d-x）版本：V1.2 欢迎集成MatchVS游戏对战引擎，本文档描述了MatchVS 对战引擎（本文以下简称之为“MatchVS”）功能接口说明，供技术人员参看。 开发者在阅读本文档后，存在任何疑问都可以及时咨询MatchVS技术支持，谢谢合作～?深圳市掌玩网络技术有限公司日期版本说明作者2015/12/08V1.0新建MatchVS研发部2015/12/20V1.2细化回调接口，修改发送接口及说明MatchVS研发部2016/01/04V1.2.6增加同步接口MatchVS研发修订历史记录目录概述4接口方法详解5Java对战信息服务5初始化服务5C++核心引擎:6初始化引擎6反初始化引擎6C++引擎回调接口类7回调接口7C++引擎接口11登录游戏大厅11进入房间11更换房间12游戏准备12取消准备13游戏开始13数据传输13游戏局结束14退出房间14退出游戏大厅15获取对战状态码15C++用户中心回调接口类16回调接口16C++用户中心接口18初始和反初始化用户中心18注册用户ID18获取用户信息19注册用户ID19用户登录20修改用户信息20C++战况信息回调接口类20回调接口20C++战况信息回调接口类24初始化和反初始化战况24设置游戏版本号24获取游戏信息列表25获取当前用户游戏信息25获取多个用户游戏信息25获取每日排行榜25获取大厅用户列表26获取当前用户排行26获取在线用户列表26附录27对战引擎错误码27注意事项28概述MatchVS开发包，当前提供给android终端接入所需组件jar包和c++头文件和so库，即：对战服务代理MatchVSAndroid.jar、对战引擎核心库（libKOFramWork.so）、辅助库(libGameHelper.so)和引用头文件MatchVSLobby.h、MatchVSBase.h、MatchVSCommon.h；MatchVS对战引擎能提供支付、战况信息、用户中心以及c++底层网络引擎。本文档主要对底层网络对战引擎使用进行说明。使用开发包的基本流程： （Java）， 调用MatchVSService.java的InitService方法初始化MatchVS服务；2. （C++）， 引擎初始化 ---》 注册回调 --》 调用对战接口... ---》去初始化，详细使用流程如下图：图1. 引擎详细状态流图接口方法详解Java对战信息服务public class MatchVSService参见MatchVSService.java文件。初始化服务//必须优先于C++引擎模块的初始化服务static void InitService(Context context, int pGameID, int pVersionGame, int pDevelopID)；C++核心引擎:class CMatchVSLobby参见MatchVSLobby.h头文件， C++核心引擎。初始化引擎获取引擎单例后，设置接口的回调方法，初始化引擎。/********************************************************************** 函数名： getInstance** 描述: 获取对战引擎单例对象** 输入： 无** 输出: 无** 返回: 单例对象指针**********************************************************************/DLL_API static CMatchVSLobby* getInstance();/********************************************************************** 函数名: initWithCallback** 描述: CMatchVSLobbyCallback初始化函数** 输入: 无** 输出: 无** 返回: 正确： MATCHVS_OK,错误：其他值**********************************************/DLL_API ms_int32_t initWithCallback(CMatchVSLobbyCallback *pLobbyCallback);反初始化引擎在退出应用前需要调用反初始化方法， 与初始化对应。/*********************** 函数名： release** 描述： 释放CMatchVSUser对象** 输入： 空** 输出： 空** 返回:*************/DLL_API static ms_int32_t release();C+