五子棋模块通信结构定义精.docx
《五子棋模块通信结构定义精.docx》由会员分享，可在线阅读，更多相关《五子棋模块通信结构定义精.docx（14页珍藏版）》请在冰豆网上搜索。
五子棋模块通信结构定义精
五子棋模块通信结构定义
一．五子棋模块（001）
1．获取房间列表
操作码
000
获取房间列表请求
数据字段项
字段名
字段说明
Datafield1
Userid
用户id
获取房间列表请求响应
Datafield1
succflag
是否获取成功（0：
成功1：
失败）
Datafield2
Roomdata1
格式（房间号$容量$在线人数）
Datafield3
Roomdata2
格式（房间号$容量$在线人数）
…
…
…
Datafieldn
Roomdatam
格式（房间号$容量$在线人数）
2．获取五子棋游戏中的用户游戏统计信息
操作码
001
获取房间列表请求
数据字段项
字段名
字段说明
Datafield1
Userid
用户id
获取房间列表请求响应
Datafield1
succflag
是否获取成功（0：
成功1：
失败）
Datafield2
Roomdata1
游戏统计；格式（积分$级别$总局数$胜的局数$输的局数$平的局数））
3．获取大厅信息
操作码
002
获取大厅信息请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
roomnum
房间编号
获取大厅信息请求响应
Datafield1
succflag
是否获取成功（0：
成功1：
失败）
Datafield2
Tabledata1
玩家1信息
Datafield3
Tabledata2
玩家2信息
…
…
…
Datafieldn
Tabledatam
玩家m信息
注：
玩家信息格式（userid$nickname$picture$usertype$status$tableid$tableseq）
操作码
502
给其他在线用户的响应
Datafield1
Roomnum
房间编号
Datafield2
onlinenum
在线人数
3．退出房间
操作码
003
退出房间请求
数据字段项
字段名
字段说明
Datafield1
Userid
用户id号
Datafield2
roomnum
房间编号
退出房间请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
给其他在线用户的响应
操作码
503
Datafield1
Roomnum
房间编号
Datafield2
onlinenum
在线人数
4．用户坐下
操作码
004
用户坐下请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
Roomnum
房间号
Datafield3
tablenum
桌子号
Datafield4
tableseq
对应桌子的方位
用户坐下请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
Datafield2
oppuserid
对家用户id
Datafield3
Nickname
用户昵称
Datafield4
picture
头像
Datafield5
sex
性别
Datafield6
Age
用户年龄
Datafield7
gamemoney
游戏币总量
Datafield8
status
状态
Datafield9
Usertype
用户类型
Datafield10
Gamestat
对家游戏统计；格式（积分$级别$总局数$胜的局数$输的局数$平的局数）
给游戏对手的响应
操作码
504
Datafield1
userid
用户id
Datafield2
Nickname
用户昵称
Datafield3
picture
头像
Datafield4
sex
性别
Datafield5
usertype
用户类型
Datafield6
age
用户年龄
Datafield7
gamemoney
游戏币总量
Datafield8
Gamestat
游戏统计；格式（积分$级别$总局数$胜的局数$输的局数$平的局数）
操作码
514
给房间里的其他玩家的响应
Datafield1
userid
用户id
Datafield2
Nickname
用户昵称
Datafield3
picture
头像
Datafield4
usertype
用户类型
Datafield5
status
状态
Datafield6
tableid
桌子号
Datafield7
tableseq
桌子的方位号
5．用户站起
操作码
005
用户站起请求
数据字段项
字段名
字段说明
Datafield1
Userid
用户id号
Datafield2
roomnum
房间编号
Datafield3
tableid
桌子
Datafield4
tableseq
对应桌子的方位
用户站起请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
给其他在线用户的响应
操作码
505
Datafield1
Userid
用户id号
Datafield2
tableid
桌子号
Datafield3
tableseq
对应桌子的方位
5．获取指定玩家的信息
操作码
006
获取对手信息请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
otheruserid
指定用户id
获取对手信息请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
Datafield2
Nickname
用户昵称
Datafield3
picture
头像
Datafield4
sex
性别
Datafield5
usertype
用户类型
Datafield6
age
用户年龄
Datafield7
gamemoney
游戏币总量
Datafield8
status
用户状态
Datafield9
gamestat
游戏统计；格式（积分$级别$总局数$胜的局数$输的局数$平的局数）
6．用户准备好
操作码
007
用户开始请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
roomid
房间号
Datafield3
Tableid
桌子号
Datafield4
tableseq
桌子的方位号
用户开始请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
给房间里其他用户的响应
操作码
507
Datafield1
userid
用户id
Datafield2
tableid
桌子号
Datafield2
tableseq
桌子序号
6．用户开始游戏
操作码
008
用户开始请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
roomid
房间号
Datafield3
Tableid
桌子号
Datafield4
tableseq
桌子的方位号
用户开始请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
给房间里其他用户的响应
操作码
508
Datafield1
userid
用户id
Datafield2
tableid
桌子号
Datafield3
tableseq
桌子序号
7．游戏走子操作
操作码
009
用户游戏操作请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
seqnum
游戏棋盘编号（roomid+tableid）
Datafield3
stepnum
当前步数
Datafield4
xcoordinate
x坐标位置
Datafield5
ycoordinate
Y坐标位置
Datafield6
color
颜色（1：
黑色2：
白色）
用户游戏操作请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
Datafield2
stepflag
游戏标志（0：
开始1：
黑胜2：
白胜3：
和了）
Datafield3
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在一盘游戏结束的时候起作用
Datafield4
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在一盘游戏结束的时候起作用
给游戏对手的响应
操作码
509
Datafield1
stepflag
游戏标志（0：
开始1：
和了2：
黑胜3：
白胜）
Datafield2
stepnum
当前步数
Datafield3
xcoordinate
x坐标位置
Datafield4
ycoordinate
Y坐标位置
Datafield5
color
颜色（1：
黑色2：
白色）
Datafield6
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在一盘游戏结束的时候起作用
Datafield7
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在一盘游戏结束的时候起作用
给房间里其他用户的响应只在一盘游戏结束的时候起作用
操作码
519
Datafield1
tableid
桌子号
8．放弃下子操作请求
操作码
010
用户放弃操作请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
stepnum
当前步数
Datafield3
roomid
房间号
Datafield4
tableid
桌子号
用户放弃操作请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
给游戏对手的响应
操作码
510
Datafield1
stepnum
当前步数
9．用户在线检测
操作码
011
用户开始请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
10．用户游戏中退出（可能由服务端维护程序发起）
操作码
012
用户开始请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
给房间里其他用户的响应
操作码
512
Datafield1
userid
用户id
Datafield2
tableid
桌子号
Datafield3
tableseq
桌子序号
Datafield7
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）表示对家强退
11．用户游戏中认输
操作码
013
用户认输请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
stepnum
用户当前步数（为了游戏双方同步）
Datafield3
roomid
房间号
Datafield4
tableid
桌子号
用户认输请求响应
Datafield1
succflag
是否成功（0：
成功1：
失败）
Datafield2
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）
Datafield3
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）
给对手响应
操作码
513
Datafield1
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）
Datafield2
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）
给房间里其他用户的响应
操作码
519
Datafield1
tableid
桌子号
12．用户悔棋请求
操作码
014
用户悔棋操作请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
roomid
房间号
Datafield4
tableid
桌子号
用户悔棋操作请求响应
Datafield1
oppmind
对家的态度（0:
同意1：
不同意）
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
Prefirx
倒数第一步棋x坐标只在同意的时候返回
Datafield4
Prefiry
倒数第一步棋y坐标
Datafield5
Presecx
倒数第二步棋x坐标
Datafield6
Presecy
倒数第二步棋y坐标
Datafield6
Prethix
倒数第三步棋x坐标
Datafield7
Prethiy
倒数第三步棋y坐标
给游戏对手的响应
操作码
524
Datafield1
stepnum
游戏当前步数（为了游戏双方同步）
游戏对手的响应
操作码
524
Datafield1
Userid
对家的用户id
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
oppmind
对家的态度
Datafield4
roomid
房间号
Datafield5
tableid
桌子号
游戏对手的再次响应（对家同意的时候发送）
操作码
534
Datafield1
Prefirx
倒数第一步棋x坐标只在同意的时候返回
Datafield2
Prefiry
倒数第一步棋y坐标
Datafield3
Presecx
倒数第二步棋x坐标
Datafield4
Presecy
倒数第三步棋y坐标
Datafield5
Prethix
倒数第三步棋x坐标
Datafield6
Prethiy
倒数第三步棋y坐标
13．用户求和操作请求
操作码
015
用户求和操作请求
数据字段项
字段名
字段说明
Datafield1
userid
用户id
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
roomid
房间号
Datafield4
tableid
桌子号
用户求和操作请求响应
Datafield1
oppmind
对家的态度（0:
同意1：
不同意）
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在用户同意的时候起作用
Datafield4
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在用户同意的时候起作用
给游戏对手的响应
操作码
525
Datafield1
stepnum
游戏当前步数（为了游戏双方同步）
游戏对手的响应（发给服务器）
操作码
525
Datafield1
Userid
对家的用户id
Datafield2
stepnum
游戏当前步数（为了游戏双方同步）
Datafield3
oppmind
对家的态度
Datafield4
roomid
房间号
Datafield5
tableid
桌子号
给游戏对手的再次响应
操作码
535
Datafield1
usercount
用户数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在用户同意的时候起作用
Datafield2
oppcount
对手数据统计（积分$级别$总局数$胜的局数$输的局数$平的局数）只在用户同意的时候起作用
给房间里其他用户的响应
操作码
519
Datafield1
tableid
桌子号
服务器端主动发起
升级会员 