回调回声机器人¶
一个基于回调 API 的事件驱动回声机器人。功能与简单回声机器人相同,但用 on_message 和 run_forever 替代了手动轮询循环。
参见仓库中的 examples/callback_echo.py。
使用方法¶
工作原理¶
- 创建
WeiLink实例并通过扫码登录。 - 使用
@wl.on_message注册消息处理器 -- 每条消息到达时自动调用。 - 调用
wl.run_forever(),启动后台轮询线程并阻塞主线程。 - 收到
Ctrl+C或SIGTERM信号时,run_forever()自动停止调度器并调用wl.close()。
展示的核心功能¶
- 装饰器注册 --
@wl.on_message注册回调函数,无需手动编写recv()循环。 - 阻塞式调度 --
run_forever()负责轮询、信号捕获和资源清理。 - 自动关停 --
Ctrl+C触发优雅退出,无需try/finally样板代码。
轮询 vs 回调¶
| 方面 | 轮询(recv() 循环) |
回调(on_message) |
|---|---|---|
| 控制流 | 由你掌控循环 | 由框架掌控循环 |
| 样板代码 | while True + try/finally |
装饰器 + run_forever() |
| 适用场景 | 自定义调度、批处理 | 简单的请求/响应机器人 |