#

简要描述
- 游戏过程事件通知
请求方式
- https
- POST
- 参数为Json格式,放在body内
请求参数(可能会新增加字段,请服务端保持新增加字段兼容性)
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| notify_id | 是 | string | 通知ID | 0795d77f85789da0eb387a5096 |
| notify_time | 是 | string | 通知时服务端的时间戳(毫秒) | 1647834452408 |
| app_id | 是 | string | 消息接收方的应用id | 1 |
| notify_event | 是 | string | 通知事件 | sud.mg.merchant.game.process |
| data | 是 | GameProcessModel | 通知数据 | {} |
GameProcessModel
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| mg_id | 是 | string | 游戏id | 14615640800525066 |
| room_id | 是 | string | 房间id | 9009 |
| game_round_id | 是 | string | 游戏局id | ce56b6lzi1a7-v8eoi58qanhk-vjzmzss |
| event | 是 | string | 事件名 | chess_end |
| players | 是 | PlayerModel [] | 玩家数组 | [] |
| payload | 否 | object | 扩展字段 | {} |
- PlayerModel
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| uid | 是 | string | 玩家uid | u001 |
| type | 否 | string | 玩家类型(跨域等场景使用): INTERNAL: 内部 EXTERNAL: 外部 |
INTERNAL |
| payload | 否 | object | 扩展字段 | {} |
event 事件数据参数对应表
1.飞行棋LUDO,游戏ID=1468180338417074177
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| chess_end | {} | {} | 棋子到达终点 |
2.对战消消乐,游戏ID=1689904909564116994
| 事件 | payload | PlayerData中payload | 说明 |
|---|---|---|---|
| self_die | {} | {} | 淘汰的玩家 |
3.排雷兵,游戏ID=1472142640866779138
| 事件 | payload | PlayerData中payload | 说明 |
|---|---|---|---|
| self_die | {} | {} | 淘汰的玩家 |
4.跳一跳,游戏ID=1680881367829176322
| 事件 | payload | PlayerData中payload | 说明 |
|---|---|---|---|
| self_die | {} | {} | 淘汰的玩家 |
| jump_type_count | {} | {jump_type:1,count:1} | 不同类型跳上报。PlayerData中payload说明,jump_type说明:1:普通跳,2:完美跳,3:不可思议跳。count说明:1:表示一次,2:表示连续两次,3:表示连续3次,以此类推,不同类型则重新计数。 |
5.大富翁,游戏ID=1704460412809043970
| 事件 | payload | PlayerData中payload | 说明 |
|---|---|---|---|
| self_die | {} | {} | 淘汰的玩家 |
6.UMO,游戏ID=1472142559912517633
| 事件 | payload | PlayerData中payload | 说明 |
|---|---|---|---|
| action_cards | {} | { card_type:1} | 特殊牌出牌。PlayerData中payload说明:1是阻挡牌,2是翻转牌,3是+2牌,4是万能牌,5是王牌 |
消息验签
请求示例
{
"notify_id": "0795d77f85789da0eb387a50964993a3eba1fedfec2b12f729861392a9b5ad04",
"notify_time": "1647844976502",
"app_id": "14615640800525066",
"notify_event": "sud.mg.merchant.game.process",
"data": {
"mg_id": "14615640800525066",
"room_id": "9009",
"game_round_id": "ce56b6lzi1a7-v8eoi58qanhk-vjzmzss",
"event": "chess_end",
"players": [{
"uid": "u001",
"type": "INTERNAL"
}]
}
}
通知应答
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| ret_code | 是 | int32 | 返回状态码, 0为消息通知成功,其他错误码为失败 | 0 |
| ret_msg | 是 | string | 返回消息 | SUCCESS |
应答示例
{
"ret_code": 0,
"ret_msg": "SUCCESS",
}