注册回调

无参数¶

注册的回调函数必须是没有参数的异步函数

若需要获取参数，请直接访问对应app属性

例如：

@app.on.idle()
@app.on.command("喝水")
async def no_args():
    print(app.user_id)
    print(app.user_name)

当存在激励源驱动时，将会触发相应的回调运行

激励源通常来说有两类，消息驱动、时间驱动

在收到消息后触发回调

注册设备闲置时的回调

注册应用运行在不同状态时的回调

注册命令回调

注册消息回调

必须是如下的先后顺序

@app.on.state(...) 
@app.on.command(...) 
async def handle():
    ...

@app.on.state(...) 
@app.on.text()
async def handle():
    ...

@app.on.idle(...)
@app.on.command(...) 
async def handle():
    ...

@app.on.idle(...)
@app.on.text()
async def handle():
    ...

在没有任何应用运行时，群聊处于闲置状态，此时注册的所有on.idle回调都可以响应，而on.state则无法响应，因为它们都依赖于相关应用的状态，而闲置时没有应用运行

运行应用后，注册在对应应用下的on.state回调可以响应，而普通的on.idle无法响应，但对于设置了super=True的特殊的on.idle仍可以响应

这种设计可以帮助一些有特殊需要的无状态应用在有状态应用运行时仍可响应用户的指令

定时器定时触发回调

触发时，回调无法通过分析消息得到各类信息（bot/group/message/event/sender等）

因此有很多方法和属性都无法访问

发送消息请使用专用的app.t_send/app.t_send_many，并且需要提供目标bot和群组的id

在指定的时间点后循环触发

每日定时触发

在这里~ ↘