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

房间表情包

获取当前房间表情包#

获取房间上传的表情
返回结果示例:
{
    "msg": "",
    "result": {
        "emoji": [
            {
                "user_info": {
                    "avatar_decoration": {
                        "src_type": "",
                        "src_url": ""
                    },
                    "tag": null,
                    "nickname": "测试测试222",
                    "avatar": "https://imgheybox.max-c.com/avatar/2024/05/22/d00c1ab1820ee5860372aadaf57cb4f9.png",
                    "medals": null,
                    "user_id": 8829926,
                    "level": 2,
                    "bot": false,
                    "room_nickname": "123",
                    "roles": [
                        "3495100762307633152",
                        "3627828495298797568",
                        "3627828495298797570",
                        "3627828495298797574",
                        "3627828495298797576",
                        "3627828495298797572",
                        "3627828495298797582"
                    ]
                },
                "meme_info": {
                    "name": "ash",
                    "path": "1843947882976337920",
                    "ext": "png",
                    "create_time": 0,
                    "mtype": 1
                }
            }
        ],
        "sticker": [
            {
                "user_info": {
                    "avatar_decoration": {
                        "src_type": "",
                        "src_url": ""
                    },
                    "tag": null,
                    "nickname": "CYCY-",
                    "avatar": "https://imgheybox.max-c.com/dev/avatar/2024/08/19/741364067a40650fca3e5d36821e6f32.jpeg",
                    "medals": null,
                    "user_id": 8829829,
                    "level": 3,
                    "bot": false,
                    "room_nickname": "房主",
                    "roles": null
                },
                "meme_info": {
                    "name": "测试",
                    "path": "1737774365795160064",
                    "ext": "jpg",
                    "create_time": 0,
                    "mtype": 2
                }
            }
        ]
    },
    "status": "ok"
}
说明:在获取的房间表情结果中,包含两个字段emoji和sticker,它们的内容结构相同。emoji数组返回房间所有的小表情,sticker数组返回房间的所有大表情。
字段类型描述
emoji数组返回的房间所有的小表情
sticker数组返回的房间的所有的大表情

表情包信息#

示例:
{
                "user_info": {
                    "avatar_decoration": {
                        "src_type": "",
                        "src_url": ""
                    },
                    "tag": null,
                    "nickname": "CYCY-",
                    "avatar": "https://imgheybox.max-c.com/dev/avatar/2024/08/19/741364067a40650fca3e5d36821e6f32.jpeg",
                    "medals": null,
                    "user_id": 8829829,
                    "level": 3,
                    "bot": false,
                    "room_nickname": "房主",
                    "roles": null
                },
                "meme_info": {
                    "name": "测试",
                    "path": "1737774365795160064",
                    "ext": "jpg",
                    "create_time": 0,
                    "mtype": 2
                }
            }
字段类型描述
user_infoobject上传该表情包的用户信息
meme_infoobject表情包信息
meme_info信息:
字段类型描述
namestringmeme 的名称
pathstringmeme 的路径
extstringmeme 的文件类型
create_timeint64meme 的创建时间
mtypeintmeme 的类型。小表情为 1,大表情为 2。

如何在房间中使用某个小表情或者大表情#

发送表情#

发送频道消息
请求示例:
{
    "msg": "[custom3358126864697663488_1843946660894564352.png],[custom8829926_1803731643450613760.png][custom3378957762485559296_1801446419245649920.png]",
    "msg_type": 4,
    "heychat_ack_id": "0",
    "reply_id": "",
    "room_id": "3358126864697663488",
    "addition": "{}",
    "channel_id": "3531089236032782336",
    "channel_type": 1
}

用小表情回应某个消息#

对某条频道消息增加/取消回应(小表情)
请求示例:
{
"msg_id":"1843948599933698048",
"emoji":"[custom3358126864697663488_1843946660894564352.png]",
"is_add":1,
"channel_id":"3531089236032782336",
"room_id":"3358126864697663488"
}
说明:在这两个请求中,可以看到使用的 emoji 对象由四段构成,如[custom3358126864697663488_1843946660894564352.png]。各字段含义如下:
字段描述
custom默认前缀
3358126864697663488房间 id
1843946660894564352meme_info 中的 path
.pngmeme_info 中的 ext
修改于 2024-10-10 07:45:33
上一页
对指定用户剥夺指定权限
下一页
获取房间上传的表情包
Built with