mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-11-28 16:16:21 +08:00
144 lines
2.0 KiB
Markdown
144 lines
2.0 KiB
Markdown
---
|
|
contentSidebar: true
|
|
sidebarDepth: 0
|
|
---
|
|
|
|
# NoneBot.message 模块
|
|
|
|
## 事件处理
|
|
|
|
NoneBot 内部处理并按优先级分发事件给所有事件响应器，提供了多个插槽以进行事件的预处理等。
|
|
|
|
|
|
## `event_preprocessor(func)`
|
|
|
|
|
|
* **说明**
|
|
|
|
事件预处理。装饰一个函数，使它在每次接收到事件并分发给各响应器之前执行。
|
|
|
|
|
|
|
|
* **参数**
|
|
|
|
事件预处理函数接收三个参数。
|
|
|
|
|
|
* `bot: Bot`: Bot 对象
|
|
|
|
|
|
* `event: Event`: Event 对象
|
|
|
|
|
|
* `state: dict`: 当前 State
|
|
|
|
|
|
|
|
## `event_postprocessor(func)`
|
|
|
|
|
|
* **说明**
|
|
|
|
事件后处理。装饰一个函数，使它在每次接收到事件并分发给各响应器之后执行。
|
|
|
|
|
|
|
|
* **参数**
|
|
|
|
事件后处理函数接收三个参数。
|
|
|
|
|
|
* `bot: Bot`: Bot 对象
|
|
|
|
|
|
* `event: Event`: Event 对象
|
|
|
|
|
|
* `state: dict`: 当前事件运行前 State
|
|
|
|
|
|
|
|
## `run_preprocessor(func)`
|
|
|
|
|
|
* **说明**
|
|
|
|
运行预处理。装饰一个函数，使它在每次事件响应器运行前执行。
|
|
|
|
|
|
|
|
* **参数**
|
|
|
|
运行预处理函数接收四个参数。
|
|
|
|
|
|
* `matcher: Matcher`: 当前要运行的事件响应器
|
|
|
|
|
|
* `bot: Bot`: Bot 对象
|
|
|
|
|
|
* `event: Event`: Event 对象
|
|
|
|
|
|
* `state: dict`: 当前 State
|
|
|
|
|
|
|
|
## `run_postprocessor(func)`
|
|
|
|
|
|
* **说明**
|
|
|
|
运行后处理。装饰一个函数，使它在每次事件响应器运行后执行。
|
|
|
|
|
|
|
|
* **参数**
|
|
|
|
运行后处理函数接收五个参数。
|
|
|
|
|
|
* `matcher: Matcher`: 运行完毕的事件响应器
|
|
|
|
|
|
* `exception: Optional[Exception]`: 事件响应器运行错误（如果存在）
|
|
|
|
|
|
* `bot: Bot`: Bot 对象
|
|
|
|
|
|
* `event: Event`: Event 对象
|
|
|
|
|
|
* `state: dict`: 当前 State
|
|
|
|
|
|
|
|
## _async_ `handle_event(bot, event)`
|
|
|
|
|
|
* **说明**
|
|
|
|
处理一个事件。调用该函数以实现分发事件。
|
|
|
|
|
|
|
|
* **参数**
|
|
|
|
|
|
* `bot: Bot`: Bot 对象
|
|
|
|
|
|
* `event: Event`: Event 对象
|
|
|
|
|
|
|
|
* **示例**
|
|
|
|
|
|
```python
|
|
import asyncio
|
|
asyncio.create_task(handle_event(bot, event))
|
|
```
|