进阶 #

@Shiro
@Component
public class ExamplePlugin {

    @GroupMessageHandler
    @MessageHandlerFilter(cmd = "开启|关闭")
    public void test1(Bot bot, GroupMessageEvent event, Matcher matcher) {
        String action = matcher.group();
        switch (action) {
            case "开启":
                System.out.println("开启事件触发");
                break;
            case "关闭":
                System.out.println("关闭事件触发");
                break;
            default:
        }
    }

    @GroupMessageHandler
    @MessageHandlerFilter(cmd = "^战绩查询\s(.*)?$")
    public void test2(Bot bot, GroupMessageEvent event, Matcher matcher) {
        String gameID = matcher.group(1);
        queryGameStats(gameID)
    }

}

String msg = MsgUtils.builder()
        .atAll()                        // @全体成员
        .img("https://test.com/1.png")  // 包含一张图片
        .text("hello~")                 // 包含一段文本内容
        .build();                       // 构建消息

MsgUtils.builder()
        .img("file:///C:/img/1.png")    // Windows 本地图片
        .img("file:///root/1.png")      // Linux   本地图片
        .img("base64://")               // Base64
        .img("https://test.com/1.png")  // 网络图片
        .build();

// 注入 Bot 容器
@Resource
private BotContainer botContainer;

private void sendMsg() {
    // 机器人账号
    long botId = 123456789L;
    // 通过机器人账号取出 Bot 对象
    Bot bot = botContainer.robots.get(botId);
    // 调用 Bot 对象方法
    bot.sendPrivateMsg(12345L, "Hi~", false);
}

@Component
public class ExamplePlugin extends BotPlugin {

    @Override
    public int onPrivateMessage(Bot bot, PrivateMessageEvent event) {
        event.getArrayMsg()
                .stream()
                .filter(item -> MsgTypeEnum.image == item.getType())
                .forEach(image -> System.out.println(image.getData().get("url")));
        return MESSAGE_IGNORE;
    }

}

// 构建消息列表（可以填充 MsgUtils 构建的消息）
List<String> msgList = new ArrayList<String>() {{
    msgList.add("这是第一条消息");
    msgList.add("这是第二条消息");
    msgList.add("这是第三条消息");
}};

// 构建合并转发消息（selfId为合并转发消息显示的账号，nickname为显示的发送者昵称，msgList为消息列表）
List<Map<String, Object>> forwardMsg = ShiroUtils.generateForwardMsg(selfId, nickname, msgList)

// 发送合并转发内容到群（groupId为要发送的群）
bot.sendGroupForwardMsg(groupId, forwardMsg)

// 发送合并转发内容到私聊（userId为要发送的好友账号）
bot.sendPrivateForwardMsg(userId, forwardMsg)

// 该示例构建了一条图片消息，并且告诉客户端不要使用缓存
OneBotMedia img = OneBotMedia.builder().file("https://example.com/1.jpg").cache(false);
// 构建消息
String msg = MsgUtils.builder().img(img).build();

@Component
public class InterceptorExample implements BotMessageEventInterceptor {

    @Override
    public boolean preHandle(Bot bot, MessageEvent event) throws Exception {
        // 预处理方法，可以在触发事件前做一些处理，返回值为 false 时本次事件将会被拦截
        // 使用场景可以是黑名单检查或检查权限等等，具体的使用场景可以发挥自己的想象力
        // MessageEvent 可能为右边这三种类型 PrivateMessageEvent、GroupMessageEvent、GuildMessageEvent
        return false;
    }

    @Override
    public void afterCompletion(Bot bot, MessageEvent event) throws Exception {
        // 当 preHandle 返回值为 true 时则会执行 plugin-list，执行完毕后进入到 afterCompletion
    }

}

@Primary
@Component
public class MyCoreEvent extends CoreEvent {

    @Override
    public void online(Bot bot) {
        // 客户端上线事件
        // 例如上线后发送消息给指定的群或好友
        // 如需获取上线的机器人账号可以调用 bot.getSelfId()
        bot.sendPrivateMsg(123456789, "我上线啦～", false);
    }

    @Override
    public void offline(long account) {
        // 客户端离线事件
        System.out.println("诶～我又离线了");
    }

    @Override
    public boolean session(WebSocketSession session) {
        // 可以通过 session.getHandshakeHeaders().getFirst("x-self-id") 获取上线的机器人账号
        // 例如当服务端为开放服务时，并且只有白名单内的账号才允许连接，此时可以检查账号是否存在于白名内
        // 不存在的话返回 false 即可禁止连接
        return true;
    }

}

@Getter
public enum CustomActionPath implements ActionPath {

    // 定义 Endpoint
    DELETE_FRIEND("delete_friend");

    private final String path;

    CustomActionPath(String path) {
        this.path = path;
    }

    @Override
    public String getPath() {
        return this.path;
    }

}

// 定义需要删除的好友账号
val friend = 12345678L;
// 获取 Endpoint
val action = CustomActionPath.DELETE_FRIEND;
// 构建请求参数
Map<String, Object> params = new HashMap<>() {{
    put("friend_id", friend);
}};
// 参考 Bot 类对响应结果进行处理
val result = bot.customRequest(action, params);

@Order(1)
@GroupMessageHandler
public void test1(Bot bot, GroupMessageEvent event, Matcher matcher) {
    System.out.println("我将被第一个触发");
}

@Order(2)
@GroupMessageHandler
public void test2(Bot bot, GroupMessageEvent event, Matcher matcher) {
    System.out.println("我将被第二个触发");
}