消息元素
凡例
| 来源 | |
|---|---|
| Satori | 这个元素是 Satori 协议的标准元素或标准属性。 |
| Chronocat | 这个元素是 Chronocat 的扩展元素或扩展属性。 |
| 支持 | |
|---|---|
| v0.0.50 | 这个元素在 Chronocat v0.0.50 中加入。 |
| 未具备 | QQ 尚未具备此功能。 |
| 未实现 | Chronocat 尚未实现此功能。 |
需要注意的是，即使某个元素尚不可用，你仍然可以使用此元素。元素会被 Chronocat 以最适合的形式发送。
| 阶段 | |
|---|---|
| 实验性 | 这个功能处于实验性阶段。 |
| 收发 | |
|---|---|
| 收 | 这个元素或属性支持接收。 |
| 发 | 这个元素或属性支持发送。 |
| 合并转发 | 这个元素或属性支持在合并转发消息内发送。 |
文本（text） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
- 合并转发 （从 v0.2.15）
一段纯文本。
发送和接收文本
你好
@（at） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string? | 收 发 | 目标用户的 ID |
| name | string? | 收 发 | 目标用户的名称 |
| role | string? | 收 发 | 目标角色 |
| type | string? | 收 发 | 特殊操作，例如 all 表示 @全体成员，here 表示 @在线成员 |
<at> 元素用于提及某个或某些用户。
频道（sharp） 未具备
- Satori
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string | 收 发 | 目标频道的 ID |
| name | string? | 收 发 | 目标频道的名称 |
QQ 尚未具备此功能。
表情（face） 未实现
- Satori
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string | 收 发 | 表情的 ID |
| name | string? | 收 | 表情的名称 |
| platform | string? | 发 | 表情显示的平台，始终为 chronocat |
链接（a） 未具备
- Satori
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| href | string | 收 发 | 链接的 URL |
<a> 元素用于显示一个链接。当平台不支持链接时，建议显示为 content (href) 的形式。
图片（img） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| src | string | 收 发 | 资源的 URL |
| title | string? | 收 发 | 资源文件名称 |
| cache 实验性 | boolean? | 发 | 是否使用已缓存的文件 |
| timeout 实验性 | string? | 发 | 下载文件的最长时间 (毫秒) |
| width | number? | 收 | 图片的宽度 (像素) |
| height | number? | 收 | 图片的高度 (像素) |
音频（audio） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| src | string | 收 发 | 资源的 URL |
| title | string? | 收 发 | 资源文件名称 |
| cache 实验性 | boolean? | 发 | 是否使用已缓存的文件 |
| timeout 实验性 | string? | 发 | 下载文件的最长时间 (毫秒) |
| duration | number? | 收 | 音频长度 (秒) |
| poster | string? | 收 发 | 缩略图 URL |
视频（video） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| src | string | 收 发 | 资源的 URL |
| title | string? | 收 发 | 资源文件名称 |
| cache 实验性 | boolean? | 发 | 是否使用已缓存的文件 |
| timeout 实验性 | string? | 发 | 下载文件的最长时间 (毫秒) |
| width | number? | 收 | 视频的宽度 (像素) |
| height | number? | 收 | 视频的高度 (像素) |
| duration | number? | 收 | 视频长度 (秒) |
| poster | string? | 收 发 | 缩略图 URL |
文件（file） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| src | string | 收 发 | 资源的 URL |
| title | string? | 收 发 | 资源文件名称 |
| cache 实验性 | boolean? | 发 | 是否使用已缓存的文件 |
| timeout 实验性 | string? | 发 | 下载文件的最长时间 (毫秒) |
| poster | string? | 收 发 | 缩略图 URL |
粗体（b, strong） 未具备
- Satori
QQ 尚未具备此功能。
斜体（i, em） 未具备
- Satori
QQ 尚未具备此功能。
下划线（u, ins） 未具备
- Satori
QQ 尚未具备此功能。
删除线（s, del） 未具备
- Satori
QQ 尚未具备此功能。
剧透（spl） 未具备
- Satori
QQ 尚未具备此功能。
代码（code） 未具备
- Satori
QQ 尚未具备此功能。
上标（sup） 未具备
- Satori
QQ 尚未具备此功能。
下标（sub） 未具备
- Satori
QQ 尚未具备此功能。
换行（br） 未实 现
- Satori
Chronocat 尚未实现此功能。
段落（p） 未实现
- Satori
Chronocat 尚未实现此功能。
消息（message） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
- 合并转发 （从 v0.2.15）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string? | 发 | 消息的 ID |
| forward | boolean? | 发 | 是否为转发消息 |
使用 message 组发送多条消息
<message>消息1</message> <message>消息2</message>
使用 message 打碎发送多条消息
消息1<message />消息2
发送合并转发
<message forward>合并转发消息</message>
使用 message 组合并转发消息
<message forward>
<message>消息1</message>
<message>消息2</message>
</message>
使用 message 打碎合并转发消息
<message forward>消息1<message />消息2</message>
引用（quote） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
作者（author） v0.0.50
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string? | 发 | 用户 ID |
| name | string? | 发 | 昵称 |
| avatar | string? | 发 | 头像 URL |
按钮（button） 未具备
- Satori
- 收 （从 v0.0.50）
- 发 （从 v0.0.50）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| id | string? | 发 | 按钮的 ID |
| type | string? | 发 | 按钮的类型 |
| href | string? | 发 | 按钮的链接 |
| text | string? | 发 | 待输入文本 |
| theme | string? | 发 | 按钮的样式 |
QQ 尚未具备此功能。
戳一戳（chronocat:poke） v0.0.59
- Chronocat
- 实验性
- 收 （从 v0.0.59）
- 发 （从 v0.0.59）
| 属性 | 类型 | 范围 | 描述 |
|---|---|---|---|
| user-id | number? | 发 | 要戳的用户 |
接收戳一戳
1000001 戳了戳 1000000：
<chronocat:poke user-id="1000000" operator-id="1000001" />
发送戳一戳
在私聊中发送戳一戳：
<chronocat:poke />
在群聊中发送戳一戳：
<chronocat:poke user-id="1000000" />