Skip to content
This repository has been archived by the owner on Oct 21, 2023. It is now read-only.

Latest commit

 

History

History
181 lines (161 loc) · 6.77 KB

sdk.md

File metadata and controls

181 lines (161 loc) · 6.77 KB

ColorMirai

返回

SDK

目前的SDK代码

C#

JAVA JAVA/Kotlin建议去写mirai插件

插件教程

ColorMirai使用WebSocket/Netty方式让机器人和插件互相链接
数据包的接受和封装在SDK已经写完了(C#),只需要引用一下就好了

WebSocket的数据包

{
  "index": 数据包ID,
  "data": {...}
}

Netty的数据包

插件如果是使用netty请务必加上这两个管道

pipeline.AddLast(new LengthFieldPrepender(4))
.AddLast(new LengthFieldBasedFrameDecoder(1024 * 500, 0, 4, 0, 4))

数据包的拆装较复杂,直接看源码妥当

目前的数据包ID

0 [插件]插件开始连接
1 [机器人]图片上传前. 可以阻止上传(事件)
2 [机器人]头像被修改(通过其他客户端修改了头像)(事件)
3 [机器人]在群里的权限被改变. 操作人一定是群主(事件)
4 [机器人]被邀请加入一个群(事件)
5 [机器人]成功加入了一个新群(不确定. 可能是主动加入)(事件)
6 [机器人]成功加入了一个新群(机器人被一个群内的成员直接邀请加入了群)(事件)
7 [机器人]主动退出一个群(事件)
8 [机器人]被管理员或群主踢出群(事件)
9 [机器人]被禁言(事件)
10 [机器人]主动离线(事件)
11 [机器人]被挤下线(事件)
12 [机器人]被服务器断开(事件)
13 [机器人]因网络问题而掉线(事件)
14 [机器人]服务器主动要求更换另一个服务器(事件)
15 [机器人]登录完成, 好友列表, 群组列表初始化完成(事件)
16 [机器人]主动或被动重新登录(事件)
17 [机器人]被取消禁言(事件)
18 [机器人]成功添加了一个新好友(事件)
19 [机器人]好友头像修改(事件)
20 [机器人]好友已被删除(事件)
21 [机器人]在好友消息发送后广播(事件)
22 [机器人]在发送好友消息前广播(事件)
23 [机器人]好友昵称改变(事件)
24 [机器人]群 "匿名聊天" 功能状态改变(事件)
25 [机器人]群 "坦白说" 功能状态改变(事件)
26 [机器人]群 "允许群员邀请好友加群" 功能状态改变(事件)
27 [机器人]入群公告改变(事件)
28 [机器人]在群消息发送后广播(事件)
29 [机器人]在发送群消息前广播(事件)
30 [机器人]群 "全员禁言" 功能状态改变(事件)
31 [机器人]群名改变(事件)
32 [机器人]图片上传成功(事件)
33 [机器人]图片上传失败(事件)
34 [机器人]成员群名片改动(事件)
35 [机器人]成成员被邀请加入群(事件)
36 [机器人]成员主动加入群(事件)
37 [机器人]一个账号请求加入群事件, [Bot] 在此群中是管理员或群主.(事件)
38 [机器人]成员被踢出群(事件)
39 [机器人]成员主动离开(事件)
40 [机器人]群成员被禁言(事件)
41 [机器人]成员权限改变(事件)
42 [机器人]成员群头衔改动(事件)
43 [机器人]群成员被取消禁言(事件)
44 [机器人]好友消息撤回(事件)
45 [机器人]群消息撤回事件(事件)
46 [机器人]一个账号请求添加机器人为好友(事件)
47 [机器人]在群临时会话消息发送后广播(事件)
48 [机器人]在发送群临时会话消息前广播(事件)
49 [机器人]收到群消息(事件)
50 [机器人]收到群临时会话消息(事件)
51 [机器人]收到朋友消息(事件)
52 [插件]发送群消息
53 [插件]发送私聊消息
54 [插件]发送好友消息
55 [插件]获取群列表
56 [插件]获取好友列表
57 [插件]获取群成员
58 [插件]获取群设置
59 [插件]回应事件
60 [插件/机器人]心跳包
61 [插件]发送图片到群
62 [插件]发送图片到私聊
63 [插件]发送图片到朋友
64 [插件]删除群员
65 [插件]禁言群员
66 [插件]解除禁言
67 [插件]开启全员禁言
68 [插件]关闭全员禁言
69 [插件]设置群名片
70 [插件]设置群名
71 [插件]撤回消息
72 [机器人]友输入状态改变(事件)
73 [机器人]好友昵称改变(事件)
74 [插件]发送语音到群
75 [插件]从文件加载图片发送到群
76 [插件]从文件加载图片发送到群私聊
77 [插件]从文件加载图片发送到朋友
78 [插件]从文件加载语音发送到群
79 [机器人]成员群恢复(事件)
80 [机器人]机器人群恢复(事件)
81 [机器人]群成员戳一戳(事件)
82 [机器人]机器人被戳一戳(事件)
83 [插件]发送私聊戳一戳
84 [插件]发送群戳一戳
85 [机器人]龙王改变时(事件)
86 [机器人]其他客户端上线(事件)
87 [机器人]其他客户端离线(事件)
88 [机器人]其他客户端发送消息给 Bot(事件)
89 [机器人]其他客户端发送群消息(事件)
90 [插件]获取图片Url
91 [插件]获取群成员信息
92 [插件]获取朋友信息11
93 [插件]发送音乐分享
94 [插件]设置群精华消息
95 [插件]消息队列
96 [插件]发送朋友骰子
97 [插件]发送群骰子
98 [插件]发送群私聊骰子
99 [插件]上传群文件
100 [插件]删除群文件
101 [插件]获取群文件
102 [插件]移动群文件
103 [插件]重命名群文件
104 [插件]创新群文件文件夹
105 [插件]删除群文件文件夹
106 [插件]重命名群文件文件夹
107 [插件]下载群文件到指定位置
108 [插件]设置取消管理员
109 [插件]获取群公告
110 [插件]设置群公告
111 [插件]删除群公告
112 [插件]发送好友语言文件
113 [机器人]群解散消息(事件)
114 [插件]设置允许群员邀请好友入群的状态
115 [插件]设置允许匿名聊天
116 [机器人]收到陌生人消息(事件)
117 [插件]发送陌生人消息
118 [插件]从文件加载图片发送到陌生人
119 [插件]发送陌生人骰子
120 [插件]发送陌生人戳一戳
121 [插件]从文件加载语音发送到陌生人
122 [机器人]在发送陌生人消息前广播(事件)
123 [机器人]在陌生人消息发送后广播(事件)
124 [机器人]陌生人关系改变(事件)
126 [插件]发送好友语音

127 [插件]断开连接

每当机器人事件触发后,会通过Socket/WebSocket/Netty将数据发送给所有插件

标注为[机器人]是框架发给插件的
标注为[插件]是插件发送给框架的

每个包需要发送的数据在这里

:经测试Server 2008存在数据包断包和丢包的现象,请切换到Server 2019使用

SDK补充说明

  1. 获取图片Url uuid{xxx-xxx-xxx-xx}.png,获取的链接可以直接打开