OneBot 事件和 API

到目前为止，我们都在使用 NoneBot 显式提供的接口，但实际上 OneBot 标准和各实现还提供了更多的事件类型和 API，可以利用这些编写更加丰富的功能。这里仍然以 go-cqhttp 为例。

事件

在 发生了什么？ 中我们提到，当 go-cqhttp 收到消息之后，会将其包装为一个统一的事件格式，并通过反向 WebSocket 给 NoneBot 发送事件数据。这些数据被 aiocqhttp 包装为 aiocqhttp.Event (opens new window) 对象，随后被 NoneBot 放在了 session.event 属性。该对象本质上是一个字典（但也提供了属性来获取其中的字段），你可以通过断点调试或打印等方式查看它的内容，其中的字段名和含义见 OneBot 事件 (opens new window) 和 go-cqhttp 事件 (opens new window)。

API 调用

前面我们已经多次调用 CommandSession 类的 send() 方法，而这个方法只能回复给消息的发送方，不能手动指定发送者，因此当我们需要实现将收到的消息经过处理后转发给另一个接收方这样的功能时，这个方法就用不了了。

幸运的是，NoneBot 类是继承自 aiocqhttp 的 CQHttp 类 (opens new window) 的，而这个类实现了 __getattr__() 魔术方法，因此可以在 bot 对象上直接调用 OneBot API。

提示

如果你在使用 HTTP 通信，要调用 OneBot API 需要在 config.py 中添加：

API_ROOT = 'http://127.0.0.1:5700'  # 这里 IP 和端口应与 go-cqhttp 配置中的 `host` 和 `port` 对应

要获取 bot 对象，可以通过如下两种方式：

bot = session.bot
bot = nonebot.get_bot()

Bot 对象的使用方式如下：

await bot.send_private_msg(user_id=12345678, message='你好～')

这里，send_private_msg 实际上对应 OneBot 的 /send_private_msg API (opens new window)，其它 API 同理。

通过这种方式调用 API 时，需要注意下面几点：

• 所有参数必须为命名参数（keyword argument），否则无法正确调用
• 这种调用全都是异步调用，因此需要适当 await
• 调用失败时（没有权限、对方不是好友、无 API 连接等）可能抛出 nonebot.CQHttpError 异常，注意捕获，例如：

  try:
      info = await bot.get_group_list()
  except CQHttpError:
      pass
  

• 当多个机器人使用同一个 NoneBot 后端时，可能需要加上参数 self_id=<机器人QQ号>，例如：

  info = await bot.get_group_list(self_id=event.self_id)
  

另外，在需要动态性的场合，除了使用 getattr() 方法外，还可以直接调用 bot.call_action() 方法，传入 action 和 params 即可，例如上例中，action 为 'send_private_msg'，params 为 {'user_id': 12345678, 'message': '你好～'}。

下面举出一些主动发送消息和调用 API 的例子：

await bot.send_private_msg(user_id=12345678, message='你好～')
await bot.send_group_msg(group_id=123456, message='大家好～')

params = session.event.copy()
del params['message']
await bot.send_msg(**params, message='喵～')

await bot.delete_msg(**session.event)
await bot.set_group_card(**session.event, card='新人请改群名片')
self_info = await bot.get_login_info()
group_member_info = await bot.get_group_member_info(group_id=123456, user_id=12345678, no_cache=True)

其它更多接口请自行参考 OneBot 的 API 列表 (opens new window) 和 go-cqhttp 的 API 列表 (opens new window)。