文档中心
小游戏平台
服务端 API
回调
上报弹幕游戏信息

上报弹幕游戏信息

更新时间：2025-04-15 19:16

回调服务不能保证完全可靠，请慎重考虑使用回调方案构建核心业务流程的风险。

描述

通过本回调，您可在弹幕游戏开始、弹幕游戏结算时收到具体的事件通知。

回调说明

回调方法：POST/JSON。
回调地址：请联系 ZEGO 技术支持配置回调地址。
传输协议：HTTPS。

回调参数

公共参数	类型	描述
AppId	Int64	App 的唯一标识。
SignatureNonce	String	随机数。
Timestamp	Int64	Unix 时间戳，单位为秒。
Signature	String	签名。
业务参数	类型	描述
GameSource	String	游戏源，固定为 "zego"。
ReportId	String	由 ZEGO 生成，同一个 MiniGameId 下唯一回调 ID。
ReportType	Int	上报信息类型： 1：游戏开始。 2：游戏结算。
MiniGameId	String	游戏 ID。
RoomId	String	游戏房间 ID。
AnchorId	String	游戏房间的房主（主播）ID。
RoundId	String	游戏对局标识，由 ZEGO 服务端生成，同一个 MiniGameId 下唯一。
ReportTime	Int64	事件发生时间，Unix 时间戳，单位：毫秒。
DanmakuResult	Object	游戏结算信息。仅在游戏结算时上报。
WinTeam	Int	弹幕游戏获胜队伍。
ResultType	Int	结算类型： 0：正常结束。 1：主播主动结束。 2：超时结束。 3：逃跑。 4：游戏被强制关闭。 5：游戏发生异常并结束。
UserSize	Int	参与用户数。
ExtraData	String	额外 JSON 数据。

回调示例

{
    "AppId":1234567890,
    "SignatureNonce":"15215528852396",
    "Timestamp":1234567890,
    "Signature":"Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D",
    "GameSource":"zego",
    "ReportId":"jjjjjj",
    "MiniGameId":"aaaaaa",    
    "ReportType":2,
    "RoomId":"abcd",
    "AnchorId":"user111",
    "RoundId":"xxx",
    "ReportTime":1662365592,
    "DanmakuResult":{
        "WinTeam":"1",
        "ResultType":1,
        "UserSize":10,
        "ExtraData":""
    }    
}

响应参数

当您收到此回调后，请响应，参数如下表所示：

参数	类型	是否必选	描述
Code	Int64	是	HTTP 状态码。 200：接收回调成功。 401、404、500：接收回调失败。
Message	String	否	响应描述。

响应示例

{
    "Code": 200,
    "Message": "succeed"
}