文档中心
ZegoMiniGameEngine 小游戏平台
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 小游戏平台
  • 服务端 API
  • 弹幕游戏相关
  • 发送评论

发送评论

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

描述

调用此接口触发弹幕游戏内的评论事件,会在弹幕游戏客户端产生相应的效果。

由于需要发送特定的评论才会触发效果,例如:发送“5”或“6”,则加入蓝方或红方,因此,请联系 ZEGO 技术支持,获取游戏的默认评论规定,或者重新约定指定游戏的评论与操作的对应关系。如果用户发送的评论不属于约定的内容,会被视为无效内容并遭过滤。

  • 游戏平台会尽力保证评论的有效性。
  • 请以房间的维度,合并用户的弹幕评论,再请求至此接口,建议每 50-200ms 整合一次用户的弹幕评论。

接口原型

  • 请求方法:POST
  • 请求地址:https://mini-game-api.zego.im/?Action=SendDanmakuComments
  • 传输协议:HTTPS
  • 调用频率限制:50 次/秒(以房间为维度)

请求参数

以下请求参数列表仅列出了接口请求参数,公共参数列表请参考 调用方式 - 公共请求参数。

参数 类型 是否必选 描述
RoomId
String
是
房间 ID,由您定义,长度上限为 64 字符。
MiniGameId
String
是
游戏 ID,请联系 ZEGO 技术支持获取。
CommentList
Array of Object
是
整合后的评论列表。
UserInfo
Object
是
用户信息对象。
UserId
String
是
参与游戏的用户 ID,由您定义,长度上限为 48 字符,只允许数字和英文。
  • 请保证 UserId 在相同的 appID 下全局唯一。
  • 如果您业务的账号系统中的用户 ID 采用了其他规则,请自行实现映射。
Nickname
String
是
用户昵称,由您定义,长度上限为 32 字符。
Avatar
String
是
用户头像的地址,必须是有效的 HTTP/HTTPS 地址,且长度在 1024 字节以内。
Sex
Number
否
用户性别。
  • 1:男。
  • 2:女
Content
String
是
用户评论内容。

请求示例

  • 请求 URL

    https://mini-game-api.zego.im/?Action=SendDanmakuComments
    &<公共请求参数>
  • 请求消息体

    {
      "RoomId": "room123",
      "MiniGameId": "TinyLoveWar",
      "CommentList": [
        {
          "UserInfo": {
            "UserId": "user1",
            "Nickname": "test1",
            "Avatar": "http://",
            "Sex": 1
          },
          "Content": "666"
        },
        {
          "UserInfo": {
            "UserId": "user2",
            "Nickname": "test2",
            "Avatar": "http://",
            "Sex": 1
          },
          "Content": "888"
        }
      ]
    }

响应参数

参数 类型 描述
Code
Number
错误码。
Message
String
请求结果的说明信息。
RequestId
String
请求 ID。

响应示例

{
    "Code": 0,
    "Message": "Succeed",
    "RequestId": "1684195459343613952"
}

返回码

以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码。

返回码 描述说明 处理建议
7202001 游戏未找到,可能造成的原因包含:
  • MiniGameId 输入错误。
  • 未开通此游戏的权限。
  • 请检查 MiniGameId 是否正确。
  • 请联系 ZEGO 商务人员开通此游戏的权限。
7202002 MiniGameId 格式错误。 请确认格式是否为 String。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈