将NTQQLiteLoaderAPI封装成OneBot11/12标准的API, V12没有完整测试
注意:本文档对应的是 LiteLoader 1.0.0及以上版本,如果你使用的是旧版本请切换到本项目v1分支查看文档
1.安装LiteLoaderQQNT
2.安装修改后的LiteLoaderQQNT-Plugin-LLAPI,原版的功能有缺陷
3.安装本项目插件OneBotApi, 注意本插件2.0以下的版本不支持LiteLoader 1.0.0及以上版本
关于插件的安装方法: 上述的两个插件都没有上架NTQQLiteLoader插件市场,需要自己下载复制到插件目录
插件目录:LiteLoaderQQNT/plugins
目前只支持http协议POST方法,不支持websocket,事件上报也是http协议
主要功能:
- 发送好友消息
- 发送群消息
- 获取好友列表
- 获取群列表
- 获取群成员列表
- 撤回消息
- 上报好友消息
- 上报群消息
消息格式支持:
- 文字
- 图片
- 引用消息
- @群成员
- 发送语音(只测试了silk编码的amr)
- 转发消息记录
- xml
支持的api:
- get_login_info
- send_msg
- send_group_msg
- send_private_msg
- delete_msg
- get_group_list
- get_group_member_list
- get_group_member_info
- get_friend_list
自己发送成功的消息也会上报,可以用于获取需要撤回消息的id
暂时不支持"message": "hello"
这种message为字符串的形式
调用接口报404
目前没有支持全部的onebot规范接口,请检查是否调用了不支持的接口,并且所有接口都只支持POST方法,调用GET方法会报404
发送不了图片和语音
检查当前操作用户是否有LiteLoaderQQNT/data/LLOneBot的写入权限,如Windows把QQ上安装到C盘有可能会出现无权限导致发送失败
不支持cq码
cq码已经过时了,没有支持的打算(主要是我不用这玩意儿,加上我懒)
onebot 12对接不了
onebot 12只写了部分兼容,没有完整测试,不保证能用,慎用
QQ多开时事件没有上报
小概率事件,有可能是IPC通信串台了(不确定),重启QQ可解决,目前正在想办法修复
QQ变得很卡
这是你的群特别多导致的,因为启动后会批量获取群成员列表,获取完之后就正常了
如何查看日志
LiteLoaderQQNT/data/LLOneBot/*.log
- 接口返回更详细的错误信息,目前消息发不出去也会返回发送成功(这河里吗)
- 转发消息记录
- 支持websocket,等个有缘人提PR实现
- 重构摆脱LLAPI,目前调用LLAPI只能在renderer进程调用,需重构成在main进程调用