#
QuickStartReqData
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
user_infos | 是 | user_info数组 | 用户信息数组 优先使用user_infos,如果数组为空,会使用codes字段 (注:不要把机器人放在第一个位置) |
room_id | 是 | string | 房间ID |
mode | 否 | int32 | 模式 默认: 1 |
language | 否 | string | 语言 默认:zh-CN |
rule | 否 | object | 玩法配置 |
report_game_info_extras | 否 | string | 透传参数,最大长度1024字节,超过则截断 |
report_game_info_key | 否 | string | 透传参数key,最大长度64字节,接入方服务端,可以根据这个字段来查询一局游戏的数据 |
mode_ex | 否 | int32 | 子模式 |
- user_info结构说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
uid | 是 | string | 用户id |
nick_name | 是 | string | 用户昵称 |
avatar_url | 是 | string | 用户头像url(建议使用128*128尺寸) |
gender | 是 | string | 性别(female or male or "") 未知性别请填写空字符串 |
is_ai | 否 | int32 | 0:普通用户,1:机器人(默认为0) |
ai_level | 否 | int32 | ai等级 0:简单ai 1:简单ai 2:中级ai 3:高级ai 默认为0 |
玩法配置(rule)
游戏名称 | name | 配置 | 介绍 |
---|---|---|---|
碰碰我最强 | bumper | {"userInfos": [{"uid": "uid1","mass": 1, "trail": 1,}]} | "mass":体型 默认值10,可填范围 10 20 30 40 50 ,拖尾型号 1 2 3 4 |
飞行棋 | ludo | { "mode":0, "chessNum":2, "item":0, "isReroll":0 } | mode:默认赛制,0快速,1经典,2竞技;chessNum:默认棋子数量,2对应2颗棋子,4对应4颗棋子;item:默认道具,1要,0不要; isReroll:是否重摇,1要,0不要 |
台湾麻将 | twmahjong | {"roundTimeDefault":1,"bottomScoreDefault":1 ,"multiplesDefault":1} | |
数字炸弹 | numberbomb | { "keyNum":45, "range":[1,99], "save":0} | keyNum:最终的答案数字,range:初始范围,save:是否保存,0不保存,就是每次的设置仅生效1次,下次如果没有再设置则恢复默认,1是保存,就是每次的设置会持续生效直到下次改变 |
谁是卧底 | whoisspy | {"mode": 0} | mode:游戏模式,0表示经典模式,1表示爆词模式 |
大富翁 | monopoly | {"defaultRounds": 0, "defaultAsset": 2, "trade": 1} | defaultRounds:回合数选项索引,范围为0~2; defaultAsset:获胜资产选项索引,范围为0~2; trade: 是否开启交易 0是不开启,1是开启 |
巴洛特 | baloot | {"mode": 0} | mode:游戏模式,0为经典模式,1为快速模式 |
连连看 | matchpairs | {"board_id": 1} | board_id:棋盘id(0~4),若不传id,则随机地图 |
找茬特攻队 | SpotTheDifference | {"maxTurn":15,"turnTime":30,"modeSelected":{"Flip":true,"Classic":true,"Shuffle":true,"Spotlight":true}} | true表示启用;Classic:经典模式,flase表示禁用,true表示启用;Shuffle:乱序模式,flase表示禁用,true表示启用;Spotlight:聚光灯模式,flase表示禁用,true表示启用 |
子模式玩法配置(mode_ex)
游戏名称 | name | 配置 | 介绍 |
---|---|---|---|
克朗棋 | Carrom | mode_ex:1 | mode_ex:1、2、3 分别表示 Carrom、Freestyle、2v2(队伍按照座位索引:0,1一队,2,3一队) |
Jackaroo | Jackaroo | mode_ex:1 | mode_ex:1、2分别表示 Base、Complex(队伍按照座位索引:0,1一队,2,3一队) |
请求示例
{
"event": "quick_start",
"mg_id": "mg_id_1",
"timestamp": "1657770493152",
"data": {
"user_infos": [{
"uid": "uid_1",
"nick_name": "nick_name_1",
"avatar_url": "avatar_url_1",
"gender": "male",
"is_ai": 0,
"ai_level": 0
},{
"uid": "uid_2",
"nick_name": "nick_name_2",
"avatar_url": "avatar_url_2",
"gender": "female",
"is_ai": 1,
"ai_level": 1
}],
"room_id":"roomId_1",
"mode": 1,
"language": "zh-CN",
"rule": {
"mode": 0,
"chessNum": 2,
"item": 0
},
"report_game_info_extras": "",
"report_game_info_key": ""
}
}