mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-12-01 01:25:07 +08:00
📝 finish plugin introduction
This commit is contained in:
parent
3f01963452
commit
3b5e37f64b
@ -254,5 +254,37 @@ async def handle(bot: Bot, event: Event, state: dict):
|
|||||||
参数分别为:
|
参数分别为:
|
||||||
|
|
||||||
1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象,为 BaseBot 的子类。特别注意,此处的类型注释可以替换为指定的 Bot 类型,例如:`nonebot.adapters.cqhttp.Bot`,只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数!可用于多平台进行不同的处理。
|
1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象,为 BaseBot 的子类。特别注意,此处的类型注释可以替换为指定的 Bot 类型,例如:`nonebot.adapters.cqhttp.Bot`,只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数!可用于多平台进行不同的处理。
|
||||||
2. [nonebot.typing.Event](../api/typing.md#event):
|
2. [nonebot.typing.Event](../api/typing.md#event): 即上报事件对象,可以获取到上报的所有信息。
|
||||||
3. `state`:
|
3. `state`: 状态字典,可以存储任意的信息
|
||||||
|
|
||||||
|
#### 处理事件
|
||||||
|
|
||||||
|
在事件处理函数中,我们只需要对 `event` 做出相应的处理,存入状态字典 `state` 中,或者向用户发送消息、调用某个机器人 API 等等。
|
||||||
|
|
||||||
|
在 NoneBot 中,提供了几种特殊的处理函数:
|
||||||
|
|
||||||
|
##### `@matcher.args_parser`
|
||||||
|
|
||||||
|
这是一个装饰器,装饰一个函数来使它成为参数的默认解析函数,当使用 `matcher.got(xxx, [args_parser])` 获取到一条消息时,会运行 `matcher.got` 的 `args_parser` ,如果不存在则运行 `@matcher.args_parser`。
|
||||||
|
|
||||||
|
##### `matcher.pause`
|
||||||
|
|
||||||
|
这个函数用于结束当前事件处理函数,强制接收一条新的消息再运行**下一个消息处理函数**。
|
||||||
|
|
||||||
|
##### `matcher.reject`
|
||||||
|
|
||||||
|
这个函数用于结束当前事件处理函数,强制接收一条新的消息再**再次运行当前消息处理函数**。
|
||||||
|
|
||||||
|
##### `matcher.finish`
|
||||||
|
|
||||||
|
这个函数用于直接结束当前事件处理。
|
||||||
|
|
||||||
|
以上三个函数都拥有一个参数 `prompt`,用于向用户发送一条消息。
|
||||||
|
|
||||||
|
## 结语
|
||||||
|
|
||||||
|
至此,相信你已经能够写出一个基础的插件了,更多的用法将会在 进阶 部分进行介绍,这里给出几个小提示:
|
||||||
|
|
||||||
|
- 请千万注意事件处理器的优先级设定
|
||||||
|
- 在匹配规则中请勿使用耗时极长的函数
|
||||||
|
- 同一个用户可以跨群(私聊)继续他的事件处理(除非做出权限限制,将在后续介绍)
|
||||||
|
Loading…
Reference in New Issue
Block a user