水缸机器人

Appearance

Bngeuit API ​

cn.org.bukkit.bngeuit.Bngeuit 是静态门面类，模仿 Bukkit 风格。绝大数常用操作都有对应静态方法。

Bngeuit 静态方法速查 ​

群聊 — 文本 ​

java
Bngeuit.sendGroupText(gid, "你好");                          // 主动发送
Bngeuit.sendGroupText(gid, "你好", keyboard);                // 带键盘（自动以 Markdown 发送）
Bngeuit.replyGroupText(gid, msgId, msgSeq, "回复");          // 被动回复
Bngeuit.quoteGroupText(gid, msgId, msgSeq, "引用");          // 引用回复（带气泡）

群聊 — Markdown ​

java
Bngeuit.sendGroupMarkdown(gid, "**md**");
Bngeuit.sendGroupMarkdown(gid, "**md**", keyboard);
Bngeuit.replyGroupMarkdown(gid, msgId, msgSeq, "**md**");
Bngeuit.quoteGroupMarkdown(gid, msgId, msgSeq, "**md**");

群聊 — 富媒体 ​

java
Bngeuit.sendGroupImage(gid, fileInfo);
Bngeuit.sendGroupVideo(gid, fileInfo);
Bngeuit.sendGroupVoice(gid, fileInfo);
Bngeuit.sendGroupFile(gid, fileInfo);

群聊 — 卡片 ​

java
Bngeuit.sendGroupCard(gid, "标题", "描述", "图片URL", "跳转URL");
// jumpUrl 需 QQ 白名单域名，传 null 可展示不可点击

私聊 — 文本 ​

java
Bngeuit.sendC2CText(openid, "你好");
Bngeuit.sendC2CText(openid, "你好", keyboard);
Bngeuit.replyC2CText(openid, msgId, msgSeq, "回复");
Bngeuit.quoteC2CText(openid, msgId, msgSeq, "引用");

私聊 — Markdown ​

java
Bngeuit.sendC2CMarkdown(openid, "**md**");
Bngeuit.sendC2CMarkdown(openid, "**md**", keyboard);
Bngeuit.replyC2CMarkdown(openid, msgId, msgSeq, "**md**");
Bngeuit.quoteC2CMarkdown(openid, msgId, msgSeq, "**md**");

私聊 — 富媒体 ​

java
Bngeuit.sendC2CImage(openid, fileInfo);
Bngeuit.sendC2CVideo(openid, fileInfo);
Bngeuit.sendC2CVoice(openid, fileInfo);
Bngeuit.sendC2CFile(openid, fileInfo);

其他 ​

java
Bngeuit.sendC2CTyping(openid, 5);                                  // "正在输入..."
Bngeuit.deleteGroupMessage(gid, messageId);                        // 撤回群消息
Bngeuit.deleteC2CMessage(openid, messageId);                       // 撤回私聊
Bngeuit.respondInteraction(interactionId, ResponseCode.SUCCESS);   // 互动响应

高级场景：BotApi ​

上传、流式消息等多步操作，通过 Bngeuit.api() 获取原始 BotApi：

java
BotApi api = Bngeuit.api();

// 富媒体上传
UploadResult r = api.uploadGroupFile(gid, FileType.IMAGE, url, false);
UploadResult r = api.uploadC2CFile(openid, FileType.IMAGE, url, false);

// 本地分片上传
MediaUploader uploader = new MediaUploader(api);
UploadResult r = uploader.uploadGroup(gid, FileType.IMAGE, new File("img.jpg"));

// 自定义消息
api.sendGroupMessage(GroupMessageRequest.builder()
    .groupOpenid(gid).msgType(MsgType.TEXT).content("Hello").build());

// 群信息
GroupInfo info = api.getGroupInfo(gid);
BotGroupState state = api.getBotGroupState(gid);

互动响应码 ​

枚举值说明
SUCCESS0操作成功
FAILED1操作失败
TOO_FREQUENT2操作频繁
DUPLICATE3重复操作
NO_PERMISSION4没有权限
ADMIN_ONLY5仅管理员操作