#
#
1. 元宇宙砂砂舞相关设置
- state
app_common_game_disco_action
data
参数说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| actionId | 是 | int | 必传的参数，用于指定类型的序号，不同序号用于区分游戏内的不同功能，不传则会判断为无效指令，具体序号代表的功能见下表 |
| cooldown | 否 | int | 持续时间，单位秒，部分功能有持续时间就需要传对应的数值，不传或传错则会按各自功能的默认值处理（见下表） |
| isTop | 否 | bool | 是否置顶，针对部分功能可排队置顶（false：不置顶；true：置顶；默认为false） |
| field1 | 否 | string | 额外参数1，针对部分功能有具体的意义（见下表） |
| field2 | 否 | string | 额外参数2，针对部分功能有具体的意义（见下表） |
- 参数说明2
| 参数名 | 说明 |
|---|---|
| "actionId":9 | 切歌-当前游戏仅有一首背景音乐，该功能仅用于改变节奏快慢 field1:歌曲ID（1：歌曲1；默认随机） field2:节奏快慢的数值，用于控制角色跳舞的快慢（0.1-10，保留1位小数点，1为正常速度，超出范围会取默认值）；默认1 |
| "actionId":10 | 角色是否绑定性别 field1:0-不绑定（会在所有角色中随机）；1-绑定（会在对应性别的角色中随机）；默认0不绑定 |
| "actionId":11 | 更换角色 field1:角色ID（1：角色1（男）；2：角色2（男）；3：角色3（男）；4：角色4（男）；5：角色5（男）；6：角色6（男）；7：角色7（男）；8：角色8（男）；9：角色9（男）；10：角色10（男）；11：角色11（男）；12：角色12（女）；13：角色13（女）；14：角色14（女）；15：角色15（女）；16：角色16（女）；17：角色17（女）；18：角色18（女）；19：角色19（女）；20：角色20（女）；21：角色21（女））；默认随机 |
| "actionId":12 | 加入主播位 field1:0-0号主播位；1-1号主播位；2-2号主播位；3-3号主播位；4-4号主播位；5-5号主播位；6-6号主播位；7-7号主播位；-1-随机，默认随机 |
| "actionId":13 | 离开主播位 field1:playerId（离开主播位的玩家id），默认自己离开，如果该玩家本来就不在主播位则没有任何效果 |
| "actionId":14 | 是否隐藏中央舞台 field1:0-显示；1-隐藏（隐藏后不再有主播位，也不能和主播跳舞），默认显示 |
| "actionId":15 | 加入舞池 field1:昵称的颜色色值（比如#ffffff就是昵称颜色为白色）默认白色 |
| "actionId":16 | 离开舞池 field1:playerId（离开舞池的玩家id），默认自己离开，如果该玩家本来就不在舞池则没有任何效果 |
| "actionId":17 | 清场，强制所有人离开舞池，全部变成观众 |
| "actionId":18 | 角色移动 cooldown:移动的持续时间，单位秒（范围为3-300，超出范围会取默认值）默认10秒 field1:移动速度快慢的数值（范围为0.1-3，保留1位小数点，1为正常速度，超出范围会取默认值）；默认1 |
| "actionId":19 | 角色变大 cooldown:变大的持续时间，单位秒，默认60秒，需要设为永久则设为-1即可 field1:放大倍数的数值（范围为0.1-5，保留1位小数点，1为原始大小，超出范围会取默认值）；默认2 |
| "actionId":20 | 角色飞天 cooldown:飞天的持续时间，单位秒，默认30秒，需要设为永久则设为-1即可 |
| "actionId":22 | 角色特效 cooldown:特效的持续时间，单位秒，默认60秒，需要设为永久则设为-1即可 field1:特效ID（1：特效1；2：特效2；3：特效3；4：特效4；5：特效5；6：特效6）；默认随机 |
| "actionId":23 | 角色特写 cooldown:特写的持续时间，单位秒（范围为1-30，超出范围会取默认值）默认舞池角色1秒,DJ台角色3秒,跳舞的角色5秒 isTop:false-不置顶；true-置顶 |
| "actionId":24 | 文字气泡 cooldown:气泡的持续时间，单位秒，默认3秒，需要设为永久则设为-1即可 field1:气泡的文字内容；默认为空 |
| "actionId":25 | 角色称号 cooldown:称号的持续时间，单位秒，默认-1，就是永久 field1:称号的文字内容（6个汉字的长度）；默认在“全场最靓”，“最强王者”和“元宇宙砂砂舞”中随机 field2:称号特效ID（1：称号1；2：称号2；3：称号3）默认随机 |
| "actionId":26 | 上DJ台 cooldown:上DJ台的持续时间，单位秒，默认180秒，需要设为永久则设为-1即可 |
| "actionId":27 | 跳舞模式 field1:0-单对单（单个玩家只能和单个主播跳舞）；1-单对多（单个玩家可以和多个主播跳舞）默认0） |
| "actionId":28 | 和主播跳舞 cooldown:和主播跳舞的持续时间，单位秒，默认30秒，需要设为永久则设为-1即可 isTop:false-不置顶；true-置顶 field1:playerId（主播玩家的id）；该参数必传，不传则没有任何效果 |
- 示例
{
"actionId":9,
"field1":"1", //切歌后播放歌曲1
"field2":"2" //节奏为2，角色跳舞速度翻倍
}
{
"actionId":10,
"field1":"1" //新加入的角色绑定性别
}
{
"actionId":11,
"field1":"5" //更换为5号角色
}
{
"actionId":12,
"field1":"0" //加入0号主播位
}
{
"actionId":13,
"field1":"" //离开主播位的玩家playerId
}
{
"actionId":14,
"field1":"1" //隐藏中央舞台
}
{
"actionId":15,
"field1":"#000000" //角色昵称颜色为黑色
}
{
"actionId":16,
"field1":"" //离开舞池的玩家playerId
}
{
"actionId":17 //清场，所有玩家变成观众
}
{
"actionId":18,
"cooldown":"5", //角色移动5秒
"field1":"2" //按2倍速度移动
}
{
"actionId":19,
"cooldown":5, //角色变大5秒
"field1":"1.5" //放大倍数为1.5倍
}
{
"actionId":20,
"cooldown":10 //角色飞天10秒
}
{
"actionId":22,
"cooldown":30, //角色播放特效30秒
"field1":"5" //播放特效5
}
{
"actionId":23,
"cooldown":10, //角色特写10秒
"isTop":false //正常排队不置顶
}
{
"actionId":24,
"cooldown":3, //文字气泡显示3秒
"field1":"元宇宙砂砂舞" //文字内容为“元宇宙砂砂舞”
}
{
"actionId":25,
"cooldown":60, //角色显示称号1分钟
"field1":"舞王就是我", //称号的文字内容为“舞王就是我”
"field2":"3" //称号特效为称号3
}
{
"actionId":26,
"cooldown":60 //角色上DJ台1分钟
}
{
"actionId":27,
"field1":"0" //和主播跳舞的模式采用单对单模式，一个玩家同时最多只能和一位主播跳舞
}
{
"actionId":28,
"cooldown":60, //和主播跳舞1分钟
"isTop": true, //我置顶了，下一个就轮到我
"field1":"" //主播的playerId，不传则没有任何效果，每次只能传一个
} //如果是单对多的跳舞模式，和多个主播跳舞就需要发多次当前api
- 说明
所有游戏指令用统一数据结构，"actionId" 为指令序号用以区别类型，必传