# 房间表情包

## 获取当前房间表情包

[获取房间上传的表情](https://s.apifox.cn/43256fe4-9a8c-4f22-949a-74a3f8b431f5/221092473e0.md)

返回结果示例：

```json
{
    "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 | 数组 | 返回的房间的所有的大表情 |

## 表情包信息

示例：

```json
{
                "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_info | object | 上传该表情包的用户信息 |
| meme_info | object | 表情包信息 |

`meme_info`信息：

| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| name | string | meme 的名称 |
| path | string | meme 的路径 |
| ext | string | meme 的文件类型 |
| create_time | int64 | meme 的创建时间 |
| mtype | int | meme 的类型。小表情为 1，大表情为 2。 |

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

### 发送表情

[发送频道消息](https://s.apifox.cn/43256fe4-9a8c-4f22-949a-74a3f8b431f5/195916005e0.md)

请求示例：

```json
{
    "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
}
```

### 用小表情回应某个消息

[对某条频道消息增加/取消回应(小表情)](https://s.apifox.cn/43256fe4-9a8c-4f22-949a-74a3f8b431f5/220985915e0.md)

请求示例：

```json
{
"msg_id":"1843948599933698048",
"emoji":"[custom3358126864697663488_1843946660894564352.png]",
"is_add":1,
"channel_id":"3531089236032782336",
"room_id":"3358126864697663488"
}
```

说明：在这两个请求中，可以看到使用的 emoji 对象由四段构成，如`[custom3358126864697663488_1843946660894564352.png]`。各字段含义如下：

| 字段 | 描述 |
| ---- | ---- |
| custom | 默认前缀 |
| 3358126864697663488 | 房间 id |
| 1843946660894564352 | meme_info 中的 path |
|.png | meme_info 中的 ext |