增強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)