接口适配器
接口适配器是对接 mirai-core 为其提供网络接口的具体实现.
从 mirai-api-http 2 版本开始，接口适配器提供更为模块化的网络接口实现. 通过启用不同的适配器可以实现不同的接口调用形式甚至数据格式。
内置接口适配器 (built-in adapter)
mirai-api-http 2 内置若干 adapter. 所有 built-in adapter 采用相同的接口逻辑和数据格式标准, 只在调用形式上有所不同
| 适配器名称 | 描述 | 文档 |
|---|---|---|
| http | 提供基于轮询的 http 接口 | http |
| ws | 提供 websocket server 形式的接口 | ws |
| reverse-ws | 提供 websocket client 形式的接口 | reverse-ws |
| webhook | 通过 http 反向调用形式的接口 | webhook |
自定义扩展接口适配器
接口适配器支持扩展, 从外部加载, 接口适配器开发详情查看 CustomizedAdapter
关于 verifyKey, session 和 cache
verifyKey, session, cache 是 built-in adapter 特有的校验逻辑. 目前只有内置的 adapter 实现了身份校验(webhook adapter 除外). 用于校验接口调用者的身份, 以及缓存接口实现过程中的消息缓存和上下文.
对于 Customized Adapter, 没有强制实现这三个标准, 是否提供校验逻辑, 需要阅读具体 adapter 的使用说明.
关于 verifyKey, session 和 cache 的作用域
对于 built-in adapter 而言, verifyKey, session, cache 是全局的. 即, 若开启了多个 adapter 的情况下, 多个客户端通过多个 adaptor 使用同一个 session, 客户端之间的操作会相互影响.
举例:
- 客户端A, 通过
http adapter申请到session1并监听 - 客户端B, 通过
websocket adatper监听session1 - 当
session1绑定的bot接收到事件时, 客户端A 和 客户端B 都会收到消息推送 - 客户端A发送消息并取得
messageId1 - 客户端A 和 客户端B 均可以通过
messageId1获取到消息缓存
总而言之, session 不在乎是否有多个客户端通过哪种 adapter 在监听同一个 session, 只要 session 收取到消息事件，都会无差别地通知客户端.
虽然不建议多个客户端监听同一个 session, 但是在分布式操作上有一定作用