动网先锋文档中心

手游SDK
数据中心接入
新游戏接入流程
手游接入规范
一:背景 二:数据记录规范
三:数据记录内容
1、用户表 2、充值表 3、玩家登录日志 4、玩家离线日志 5、玩家在线日志 6、等级升级日志 7、任务日志 8、金币流量 9、玩家操作日志 10、游戏产出道具日志纪录 11、新用户流失跟踪表(t_userLose)
四:特殊游戏接口
1、单服在线数接口 2、单服分平台、渠道在线接口
页游接入规范
一、背景 二、数据记录规范
三、数据记录内容
1、用户表 2、充值表 3、新用户流失跟踪表 4、等级升级日志 5、任务日志 6、玩家登录日志 7、玩家离线日志 8、玩家在线日志 9、金币流量 10、玩家操作日志 11、游戏产出道具日志纪录
四、特殊游戏接口
1、单服在线数接口 2、游戏log保存数据时额外接口
外部游戏网管接入规范
客服系统提问及FAQ
公共参数说明
客服系统FAQ
1获取FAQ分类 2分类的标题 3FAQ的详细内容 4FAQ评价接口 5热点FAQ接口 6FAQ搜索接口
GM提问
1提问接口 2工单评价接口 3玩家追问接口 4删除工单 5工单列表 6工单详情 7删除全部工单
客服公告
客服公告列表 客服公告详情
DOVO联运通用版接入合作方接口
通用接口
接口说明 登陆接口 充值接口 角色账号验证接口 角色信息查询接口 禁言、踢下线接口 封号接口 游戏服每天5分钟在线接口 百度实时post角色信息接口
客服系统提问及FAQ(移动版)
客服提问及FAQ
客服系统提问及FAQ(Flash封装包)
Flash封装包对接说明
客服GM工具接口
页游接入GM工具
1、优先级别 2、请求格式及方式 3、返回数据格式 4.1、玩家查询 4.2、获取日志类型 4.3、玩家日志查询 4.4、游戏登录功能 4.5、获取 封号/禁言 列表 4.6、添加 封号/禁言 4.7、删除 封号/禁言 4.8、邮件发放 4.9、获取道具卡列表 4.10、获取需要发送的道具 4.11、发送道具 4.12、背包查询 4.13、调整背包物品数量 4.14、添加公告 4.15、获取公告列表 4.16、编辑公告 4.17、删除公告 4.18、充值查询 4.19、获取邮件列表 4.20客服回复GM图标闪烁 5、开发测试工具
手游接入GM工具
1、优先级别 2、请求格式及方式 3、返回数据格式 4.1、玩家查询 4.2、获取日志类型 4.3、玩家日志查询 4.4、游戏登录功能 4.5、获取 封号/禁言 列表 4.6、添加 封号/禁言 4.7、删除 封号/禁言 4.8、邮件发放 4.9、获取道具卡列表 4.10、获取需要发送的道具 4.11、发送道具 4.12、背包查询 4.13、调整背包物品数量 4.14、添加公告 4.15、获取公告列表 4.16、编辑公告 4.17、删除公告 4.18、充值查询 4.19、获取邮件列表 4.20、查询武将 4.21、剔除玩家 4.22、维护管理 4.23、白名单 4.24、添加白名单 4.25、删除白名单 4.26、装备查询 4.27、家将查询 4.28、坐骑查询 4.29、宠物查询 4.30、获取活动类型、及活动列表 4.31、开启活动 4.32、查询开启的活动列表 4.33、删除开启的活动 5、开发测试工具
uwan接口
登录接口 文化部审核接口 充值接口

数据记录方式有2种:

1、  记录在MYSQL数据库服务器,并且开放权限以供数据中心采集(推荐该方式)。

2、  记录为文本形式,保存在游戏服务器,并且提供http接口以供读取。

1、数据库记录

数据记录在数据库中,具有以下优点:

1、  查询和数据采集较为实时,便于开发客服操作日志接口。

2、  不需要额外开发数据接口。

3、  便于游戏内部利用这些记录做一些活动排名等。

缺点:

1、  单表过大的时候需要考虑分表,并且定期清理旧数据。

2、  查询过大数据量时,可能影响服务器速度。

 

数据记录表要求具有自增id字段或者精确到秒的时间字段,并且都在同一个数据库中。


2、文本记录

文本记录方式需要提供http接口, http接口需要支持range属性(需要知道文件长度),因此http接口的实现方式为直接读取文件输出。

2.1游戏日志文件名规范

         游戏日志分2种,第一种是增量数据,如操作日志、登录日志,第二种是状态数据,如用户表、配置表。

第一种:按小时产生和记录,每个小时至少产生一个日志文件,日志文件名必须包含日志文件产生的类型、日期、时间,格式为: xxxxx_YYYYMMDDHH.log ,其中xxxxx用于标识日志类型。YYYYMMDD表示文件产生日期,HH表示文件产生的小时,00为固定值,例如:loginlog_2013031009.log,表示20133109点产生的登录日志文件。如gamelog_2013031009.log,表示20133109点产生的操作日志文件。

第二种:按天产生和记录,生成时间在每天的0点到1点。日志文件名由日志类型和日志时间构成(日志时间和数据时间一致),格式为: xxxxx_YYYYMMDD.log,其他同上。


2.2游戏日志格式规范

1、所有日志均使用‘|’分隔字段形式,各个字段内容中不允许出现‘|’字符。

日志文件必须以文本(txt)日志方式记录,不要使用二进制方式。每条日志之间以换行符分隔,日志内容字段之间以竖线“|”进行分隔,只支持使用一级分隔符。角色名、地图名、NPC名等可能含有字符的字段必须不能含有竖线“|”这个特殊字符,否则会导致日志解释入库异常。日志中第一个字段为非日志内容的字段,用于标识是什么类型的日志。

         2、日志按照表设计中规定的字段顺序记录,不记录表的自增ID,可以将原ID列记录为当前时间字符串,格式为:yyyy-MM-dd HH:mm:ss

        

2.3 http读取接口

1、流程:

数据中心服务器通过get或者post方式请求游戏的http接口,接口程序读取指定的文本文件,并且输出其中的内容。

2、参数字段:

字段

描述

备注

table

指定表名

loginlog

filedate

请求读取的表时间后缀

2013_03_10_09

(20133109)

time

请求时系统时间

Unix时间,1970年起以秒为单位

sign

验证签名

md5(“time=” + time + “&key=” + key)

 

3、数据加密:

每条协议指令中必须包含timesign参数以进行合法验证。

签名验证方法:md5(“time=” + time + “&key=” + key) == sign

Key由双方约定。

4、示例:

http://www.XXX.com/cmd_type/cmd?table=loginlog&filedate=2013_03_10_09&time=1234567890&sign=abcdef123456

其中http://www.XXX.com/为游戏域名。

5、有的日志可能没有数据不会生成文件,在开发http接口的时候需要做异常处理,找不到文件则输出{"state":"0","info":"错误信息"}。对于生成了文件,但没有数据内容的,可以直接输出空白。