接口文档格式

《幻宠大陆》项目协议文档

Ø 协议格式说明

游戏系统中协议是由两部分组成：协议头+协议体。其中协议头的数据长度为固定。如下显示

客户端发送的消息格式：

字段意义

字段类型

说明

消息长度

INT

描述协议体的长度，包括当前

消息头

 SHORT

协议ID

消息回执码

SHORT

压缩或加密的标识，或者是回执码

消息内容

-

 

 

服务端发送的消息格式：

字段意义

字段类型

说明

消息长度

INT

描述协议体的长度，包括当前

消息头

 SHORT

协议ID

消息回执码

SHORT

回执码

错误码

SHORT

错误码!=0时一般无消息内容

消息内容

-

 

 

字段类型说明：

字段类型

说明

BYTE

1个字节

SHORT

2个字节

INT

4个字节

LONG

8个字节

UTF-8

说明字符串的编码是由UTF-8格式。

 

协议按系统功能进行分类。部分协议具体系统功能没有关系，如系统消息。有些协议是服务器主动发送给客户端的。不需要客户端主动请求。有些协议操作需要服务器立即返回协议。如提示用户操作是否成功类，客户端对应此需要做相关逻辑。本文档服务器和客户端在一起。

【C】标识是客户端协议，【S】标识服务器端协议。

 

 

 

 

 

 

 

 

 

 

 

一、       背包系统

Ø  使用背包中的道具【1031】

请求

字段功能说明

字段类型

说明

道具唯一id

LONG

 

使用数量

SHORT

 

扩展信息

UTF8

 

返回：

字段功能说明

字段类型

说明

道具ID

INT

 

扩展信息

UTF8

 

Ø  扩充背包【1032】

请求

字段功能说明

字段类型

说明

背包类型

BYTE

 

扩充数量

SHORT

 

返回：

字段功能说明

字段类型

说明

 

背包类型

BYTE

 

最新容量

SHORT

 

 

 

Ø  丢弃背包数据【1033】

请求

字段功能说明

字段类型

说明

道具唯一id

LONG

 

使用数量

SHORT

 

返回：

字段功能说明

字段类型

说明

 

Ø  整理背包数据【1034】

请求

字段功能说明

字段类型

说明

返回：

字段功能说明

字段类型

说明

Ø  出售道具【1035】

请求

字段功能说明

字段类型

说明

道具唯一id

LONG

 

使用数量

SHORT

 

返回：

字段功能说明

字段类型

说明

道具唯一id

LONG

 

使用数量

SHORT

 

 

Ø  道具拖拽【1036】

请求

字段功能说明

字段类型

说明

道具唯一id

LONG

 

新位置

SHORT

 

返回：

字段功能说明

字段类型

说明

道具唯一id

LONG

 

新位置

SHORT

 

 

 

Ø  道具碎片合成【1038】

请求

字段功能说明

字段类型

说明

碎片道具id

INT

 

合成数量

INT

 

返回：

字段功能说明

字段类型

说明

合成的道具id

INT

 

合成数量

INT

 

 

Ø  装备出售【1039】

请求

字段功能说明

字段类型

说明

道具ID

INT

 

数量

INT

 

返回：

字段功能说明

字段类型

说明

 

道具ID

INT

 

数量

INT

 

奖励

UTF8