黑盒语音接口
  1. 机器人命令
黑盒语音接口
  • 教程
  • 开发者服务协议
  • 使用交流
  • 更新日志
  • 开发计划
  • 资源
    • 请求速率限制
    • Websocket
    • Bot命令
  • WEBSOCKET 连接请求
    • 连接到黑盒语音服务
  • HTTP接口
    • 消息接口
      • 发送消息接口的参数
      • 发送消息接口的返回值
      • 发送图片形式的频道消息
      • 发送Markdown文档
      • 更新指定频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 发送卡片消息
      • 给用户发送私聊消息
      • 发送频道图片消息
      • 发送频道消息
      • 发送卡片消息
      • 发送频道消息@全体成员/@在线成员
      • 更新指定的频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 给用户发送私聊消息
    • 媒体文件上传
      • 上传媒体文件的参数解析
      • 上传媒体文件
    • 房间角色接口
      • 权限相关说明
      • 接口说明
      • 获取房间角色列表
      • 创建角色
      • 更新角色
      • 删除角色
      • 对指定用户授予指定权限
      • 对指定用户剥夺指定权限
    • 房间表情
      • 房间表情包
      • 获取房间上传的表情包
      • 房间删除表情包
      • 房间更新表情包名称
    • 房间接口
      • 房间相关接口文档
      • 修改房间内昵称
      • 分页获取加入的房间列表
      • 获取房间信息
      • 退出房间
      • 房间踢人
      • 获取房间用户列表
  • 服务端推送事件
    • 事件说明
    • 通用推送字段
    • 机器人命令
      • 用户使用Bot命令
    • 频道消息事件
      • 频道消息事件
    • 房间消息事件
      • 房间消息事件
  1. 机器人命令

用户使用Bot命令

一 收到的JSON 内容#

{
    "sequence": 11736260019,
    "type": "50",
    "notify_type": "",
    "data": {
        "bot_id": 72053518,
        "channel_base_info": {
            "channel_id": "3611849174307799042",
            "channel_name": "默认频道",
            "channel_type": 1
        },
        "command_info": {
            "id": "1831636113196855296",
            "name": "/test",
            "options": [
                {
                    "name": "test",
                    "type": 3,
                    "value": "123123"
                }
            ],
            "type": 0
        },
        "msg_id": "1831637085605466112",
        "room_base_info": {
            "room_avatar": "",
            "room_id": "3611849174284943360",
            "room_name": "酸辣鸡杂面的房间"
        },
        "send_time": 1725531286039,
        "sender_info": {
            "avatar": "https://cdn.max-c.com/heybox/profile/avatar/heygirl_3.png",
            "avatar_decoration": {
                "src_type": "image",
                "src_url": "https://imgheybox.max-c.com/oa/2024/08/19/02e11b983bbd0fdcd5d9db03989ad713.gif"
            },
            "bot": false,
            "level": 10,
            "medals": null,
            "nickname": "酸辣鸡杂面",
**            **"roles": null,
            "room_nickname": "",
            "tag": null,
            "user_id": 43028164
        }
    },
    "timestamp": 1725531286040
}

二 非命令字段解析#

2.1 最外层字段#

字段名称类型作用使用场景
sequenceint64序列号,用于唯一标识这个事件
typeint64消息类型当收到50类型的消息的时候,处理对应的命令事件
dataobject收到的推送的具体内容
timestampint64推送产生的时间,毫秒时间戳

2.2 data 字段#

字段名称类型描述使用
bot_idint用户使用的机器人ID校验是否与本地机器人ID 相同
channel_base_infooject频道的基本信息,具体查看通用推送字段中的channel_base_info
room_base_infooject房间的基本信息,具体查看通用推送字段中的room_base_info
command_infooject用户使用的命令信息
send_timeint64消息发送的毫秒时间戳。校验消息是否延迟到达
sender_infooject发送者的信息,具体查看通用推送字段中的sender_info

三 命令字段#

3.1 command_info 字段#

字段名称类型描述
idstring使用的命令id
namestring使用的命令名称
options数组类型使用的命令参数列表
typeint命令类型 目前只有默认类型

3.2 options字段 字段#

字段名称类型描述使用场景
namestring使用的参数名称
typeint使用的参数类型
valuestring使用的参数值,这是string

3.3 参数类型 type#

这些类型对应的值都是String 需要手动转换
字段名称类型
3String 类型
4Number 类型
5Boolean 类型
6User 用户类型
7Channel 频道类型
8Role 房间角色类型
9选择项类型的选择结果
10Integer类型
修改于 2024-10-10 08:08:54
上一页
通用推送字段
下一页
频道消息事件
Built with