增强CQ码
===
* 为了更好的方便开发者使用,插件对CQ码做了一些改造。
* CQ码仅在发送消息时作为消息参数使用.
发送图片或语音
---
#### 原始用法说明
原生CQ码只能用于发送在酷Q目录`\data\image\`、`\data\record\`下的图片/语音文件,例如存在文件`xxx.jpg`、`xxx.mp3`,则发送语音和图片时为`[CQ:image,file=xxx.jpg]`、`[CQ:record,file=xxx.mp3]`,不支持直接使用其他目录下的资源文件,也不能使用网络资源。
---
#### 发送本地文件
将`file`值设为`file://`+文件的绝对路径,即可发送本地文件。如
```
[CQ:image,file=file://C:\Users\i\Pictures\xx.gif]
[CQ:record,file=file://C:\Users\i\Music\xx.mp3]
```
插件会将本地资源文件复制到图片目录,作为缓存文件进行发送。
| 参数 | 类型 | 默认值 | 说明 |
| --- | :-: | :-: | --- |
| `file` | string | `-` | 本地资源的绝对路径,需要在开头添加`file://`作为标记 |
| `autoDelete` | boolean | `false` | 在发送完成后删除缓存文件,`true`/ 删除 |
---
#### 使用网络资源
在增强CQ码下,可以将`file`值设定为url链接,插件会将网络文件先下载到本地目录,再将`file`值替换成相应文件名后进行发送。如
```
[CQ:image,file=https://www.baidu.com/img/bd_logo1.png]
[CQ:record,file=https://t.cn/xxx]
```
| 参数 | 类型 | 默认值 | 说明 |
| --- | :-: | :-: | --- |
| `file` | string | - | 本地资源文件的绝对路径、网络资源的URL地址(支持HTTPS) |
| `method` | string | `GET` | (仅发送网络资源时可用)HTTP请求方法,可选值:`GET`、`POST` |
| `data` | string | `-` | (仅使用POST请求方法时可用)POST数据,`UTF-8`编码 |
| `cookie` | string | `-` | (仅发送网络资源时可用)HTTP请求COOKIE |
| `header` | string | `-` | (仅发送网络资源时可用)HTTP请求头 |
| `proxy` | string | `-` | (仅发送网络资源时可用)HTTP请求使用的代理,格式:`1.1.1.1:11111` |
| `autoDelete` | boolean | `false` | 在发送完成后删除缓存文件,`true`/ 删除 |
说明
* 换行请用`\n`
* 所以值均需要对以下字符进行转码(即替换文本):
| 字符 | 转码 |
| :-: | :-: |
| `&` | `&` |
| `[` | `[` |
| `]` | `]` |
| `,` | `,` |
设置禁言状态
---
```
[CQ:ban,qq=10001,time=60]
```
| 参数 | 类型 | 默认值 | 说明 |
| --- | :-: | :-: | --- |
| `qq` | number | - | 需要更改禁言状态的QQ,`-1`/操作全群禁言开关 |
| `time` | number | `0` | 禁言时间,单位:秒。可省略,`0` / 解除禁言或关闭禁言状态 |
说明
* 该CQ码仅在发送群消息时可用.
## 其中增强CQ 码的功能
* @某人(at)
* 禁言
* 发送emoji表情(emoji)
* 图片(image)
* 发送表情(face)
* 发送窗口抖动(shake)
* 发送链接分享(share)
* 发送名片分享(contact)
* 匿名发消息(anonymous)
* 位置分享(location)
* 音乐(music)
* 语音(record)
* 大表情(bface)
* 厘米秀(show)