提供基于 websocket server 的接口
adapterSettings:
ws:
## websocket server 监听的本地地址
## 一般为 localhost 即可, 如果多网卡等情况，自定设置
host: localhost
## websocket server 监听的端口
## 与 http server 可以重复, 由于协议与路径不同, 不会产生冲突
port: 8080
## websocket 用于消息同步的字段为 syncId, 一般值为请求时的原值，用于同步一次请求与响应
## 对于由 websocket server 主动发出的通知, 固定使用一个 syncId, 默认为 ”-1“
reservedSyncId: -1专有接口为该 adapter 特有的接口
通用接口为所有 built-in adapter 公用的数据规范, 该文档定义了不同 adapter 的具体调用方式
ws adapter 采用一步认证, 参数通过 header 或者 url 参数传递
在 ws adapter 中, websocket 一经连接, 便绑定到固定 session, 后续不需再次传递 sessionKey 参数
| 名字 | 类型 | 举例 | 说明 |
|---|---|---|---|
| verifyKey | String | "1234567890" | verifyKey, 配置文件中指定 |
| sessionKey | String | "UnVerifiedSession" | 新建连接 或 singleMode 模式下为空, 通过已有 sessionKey 连接时不可为空 |
| Long | 12345678 | 绑定的账号, singleMode 模式下为空, 非 singleMode 下新建连接不可为空 |
ws adatper不允许复用sessionKey, 建立连接时, 会同时关闭同一个”通道“中的旧websocket. 但可以同其他 adapter 复用
连接连接后，ws adapter 会立即返回 sessionKey
{
"syncId": "",
"data": {
"code": 0,
"session": "YourSessionKey"
}
}ws adatper 通过 websocket 主动推送消息与事件
ws adatper 拥有三个连接通道
/message: 推送消息/event: 推送事件/all: 推送消息及事件
示例: ws://localhost:8080/message?verifyKey=1234567890&qq=12345678
ws adapter 采用 json 文本格式进行数据传输
{
"syncId": 123, // 消息同步的字段
"command": "sendFriendMessage", // 命令字
"subCommand": null, // 子命令字, 可空
"content": {} // 命令的数据对象, 与通用接口定义相同
}{
"syncId": "123", // 消息同步的字段
"data": {} // 推送消息内容, 与通用接口定义相同
}使用此方法获取插件的信息，如版本号
命令字: about
通用接口定义: 获取插件信息
使用此方法获取所有当前登录账号
命令字: botList
通用接口定义: 获取登录账号
此方法通过 messageId 获取历史消息, 历史消息的缓存有容量大小, 在配置文件中设置
命令字: messageFromId
通用接口定义: 通过messageId获取消息
使用此方法获取bot的好友列表
命令字: friendList
通用接口定义: 获取好友列表
使用此方法获取bot的群列表
命令字: groupList
通用接口定义: 获取群列表
使用此方法获取bot指定群中的成员列表
命令字: memberList
通用接口定义: 获取群成员列表
使用此方法获取bot指定群中的最新群成员列表
命令字: latestMemberList
通用接口定义: 获取最新群成员列表
此接口获取 session 绑定 bot 的详细资料
命令字: botProfile
通用接口定义: 获取Bot资料
此接口获取好友的详细资料
命令字: friendProfile
通用接口定义: 获取好友资料
此接口获取群成员的消息资料
命令字: memberProfile
通用接口定义: 获取群成员资料
此接口获取获取QQ用户资料
命令字: userProfile
通用接口定义: 获取QQ用户资料
使用此方法向指定好友发送消息
命令字: sendFriendMessage
通用接口定义: 发送好友消息
命令字: sendGroupMessage
通用接口定义: 发送群消息
命令字: sendTempMessage
通用接口定义: 发送临时会话消息
命令字: sendNudge
通用接口定义: 发送头像戳一戳消息
命令字: recall
通用接口定义: 撤回消息
命令字: roamingMessages
通用接口定义: 获取漫游消息
命令字: file_list
通用接口定义: 查看文件列表
命令字: file_info
通用接口定义: 获取文件信息
命令字: file_mkdir
通用接口定义: 创建文件夹
命令字: file_delete
通用接口定义: 删除文件
命令字: file_move
通用接口定义: 移动文件
命令字: file_rename
通用接口定义: 重命名文件
(未施工)
(未施工)
(未施工)
使用此方法删除指定好友
命令字: deleteFriend
通用接口定义: 删除好友
使用此方法指定群禁言指定群员（需要有相关限权）
命令字: mute
通用接口定义: 禁言群成员
使用此方法指定群解除群成员禁言（需要有相关限权）
命令字: unmute
通用接口定义: 解除群成员禁言
使用此方法移除指定群成员（需要有相关限权）
命令字: kick
通用接口定义: 移除群成员
使用此方法使Bot退出群聊
命令字: quit
通用接口定义: 退出群聊
使用此方法令指定群进行全体禁言（需要有相关限权）
命令字: muteAll
通用接口定义: 全体禁言
使用此方法令指定群解除全体禁言（需要有相关限权）
命令字: unmuteAll
通用接口定义: 解除全体禁言
使用此方法添加一条消息为精华消息（需要有相关限权）
命令字: setEssence
通用接口定义: 设置群精华消息
使用此方法获取群设置
命令字: groupConfig
子命令字: get
通用接口定义: 获取群设置
使用此方法修改群设置（需要有相关限权）
命令字: groupConfig
子命令字: update
通用接口定义: 修改群设置
使用此方法获取群员设置
命令字: memberInfo
子命令字: get
通用接口定义: 获取群员设置
使用此方法修改群员设置（需要有相关限权）
命令字: memberInfo
子命令字: update
通用接口定义: 修改群员设置
使用此方法修改群员的管理员权限（需要有群主限权）
命令字: memberAdmin
通用接口定义: 修改群员管理员
此方法获取指定群公告列表
命令字: anno_list
通用接口定义: 获取群公告
此方法向指定群发布群公告
命令字: anno_publish
通用接口定义: 发布群公告
此方法删除指定群中一条公告
命令字: anno_delete
通用接口定义: 删除群公告
使用此方法处理添加好友申请
命令字: resp_newFriendRequestEvent
通用接口定义: 添加好友申请
使用此方法处理用户入群申请
命令字: resp_memberJoinRequestEvent
通用接口定义: 用户入群申请
使用此方法处理Bot被邀请入群申请
命令字: resp_botInvitedJoinGroupRequestEvent
通用接口定义: Bot被邀请入群申请
使用此方法向 console 提交一个消息作为命令执行
命令字: cmd_execute
通用接口定义: 执行命令
使用此方法向 console 注册一个指令, 当指令触发时, 会生成一个 CommandExecutedEvent
命令字: cmd_register
通用接口定义: 执行命令
命令被调用时, 会触发 CommandExecutedEvent