> 說明
本功能添加于`2.1.4.0` / `2.4.0`版本。
使用本功能需啟用 **`動態交互`** 模塊。
整體說明
---
事件管理功能中的所有函數均含有以下請求參數，后續不再重復說明.
| 參數 | 類型 | 值 | 說明 |
| --- | :-: | :-: | --- |
| `module` | string | `eventManage` | 模塊名 |
| `function` | string | - | 函數名 |
在響應數據中均含有以下響應字段
| 字段 | 類型 | 說明 |
| --- | --- | --- |
| `request` | object | 本次請求的相關數據 |
| `request.handle` | number | 請求綁定的句柄 |
| `request.text` | object | 請求內容 |
函數列表
---
### 獲取事件數據（`get`）
說明
* 用于取回為未成功投遞到服務端的事件數據
#### 請求數據
```
{
"module":"eventManage",
"function":"get",
"limit":5
}
```
##### 請求參數說明
| 參數 | 類型 | 默認值 | 說明 |
| --- | :-: | :-: | --- |
| `function` | string | `get` | 功能名 |
| `limit` | number | `5` | 需要取回的數據數量 |
#### 響應數據
```
{
"status": 0,
"amount": 3,
"margin": 0,
"event": [
{
"type": 1,
"subType": 1,
"msgID": 534,
"time": 1532109054,
"loginQQ": 10000,
"qq": 2010741172,
"msg": null,
"font": 54519592
},
{
"type": 2,
"subType": 1,
"msgID": 536,
"time": 1532111575,
"loginQQ": 0,
"qq": 0,
"group": 0,
"msg": "寫文檔是真的emmm",
"font": 54989944
},
{
"type": 2,
"subType": 1,
"msgID": 537,
"time": 1532111612,
"loginQQ": 0,
"qq": 0,
"group": 0,
"originalMsg": "還有一個說明沒補充，有點不想動了[CQ:image,file=xxxxx.jpg],",
"imageInfo": [
{
"fileName": "xxxxx.jpg",
"md5": "xxxxx",
"width": 50,
"height": 65,
"size": 20829,
"url": "https://gchat.qpic.cn/gchatpic_new/xxxxx",
"addTime": 1532011070
}
],
"msg": "還有一個說明沒補充，有點不想動了",
"font": 55416120
}
]
}
```
##### 響應字段說明
| 字段 | 類型 | 說明 |
| --- | --- | --- |
| `status` | number | 響應狀態，成功為0 |
| `amount` | number | 實際取回的事件數據數量 |
| `margin` | number | 未取回的事件數據數量(可以理解成未讀消息) |
| `event` | array | 取回的事件數據 |
| `event[i]` | object | 取回的第`i`個事件數據，具體說明請參考 **`提交事件說明`** |
---
### 攔截事件（`intercept`）
#### 說明
當客戶端進程收到事件，并且處理完事件數據后，需要選擇是否將該事件傳遞給下一進程處理。在開啟事件攔截處理功能后，進程會保留該事件一段時間，用于等待服務端發送攔截處理結果，若該段時間結束后仍未收到攔截處理結果，則進程將會把該事件傳遞給下一進程處理。
#### 請求數據
```
{
"module":"eventManage",
"function":"intercept",
"handle": 12345678,
"intercept": false
}
```
##### 請求參數說明
| 參數 | 類型 | 默認值 | 說明 |
| --- | :-: | :-: | --- |
| `handle` | number | - | 事件中的處理標志 |
| `intercept` | bool | `true` | `true` / 攔截，`false` / 不攔截 |
#### 響應數據
```
{
"status": 0,
"errMsg": ""
}
```
##### 響應字段說明
| 字段 | 類型 | 說明 |
| --- | --- | --- |
| `status` | number | 攔截結果，`0` / 處理成功，`400` / 事件不存在，`425` / 剛好超過等待結果時間 |
| `errMsg` | string | 錯誤原因，成功時為`空文本` |
