事件处理

消息处理函数

在上一节中，如果你不是复制代码而是手写Repeat模块的话，当你写完CQEventType.时，应该已经从代码提示中看到各种事件类型了
本节我们以处理群消息为例，只需将监听到事件类型改为CQEventType.messageGroup

const { createRobot } = require('@dislido/CQNode');

const RepeatGroup = mod => {
  mod.setMeta({
    packageName: 'repeatGroup',
  });
  mod.on(CQEventType.messageGroup, async ctx => {
    ctx.reply(`收到消息: ${ctx.textMessage}`);
    return true;
  });
};


createRobot({
  connector: {
    account: 114514,
    password: '1919810',
  },
  modules: [RepeatGroup],
});

atme

在群聊天中，通常只在需要时才会让机器人处理你的消息，机器人会忽略群成员间的正常聊天，此时可以用atme监听选项来判断一条消息是否at了本机器人，默认情况下，此选项的值是true

const RepeatGroup = mod => {
  mod.setMeta({
    packageName: 'repeatGroup',
  });
  mod.on(CQEventType.messageGroup, async ctx => {
    ctx.reply(`收到消息: ${ctx.textMessage}`);
    return true;
  }, { atme: true });
};

预计行为：
[群聊]
user1: aaa
user2: bbb
user1: @robot 123
robot: @user1 收到消息: 123

默认情况下，CQNode使用@作为atme判断条件，以@本机器人开头的消息的atme才会为true
可以在配置中修改atmeTrigger来修改atme判断条件

createRobot({
  modules: [RepeatGroup],
  atmeTrigger: [true, '-'], // <- true代表默认的@， 我们增加一个-作为atme判断条件
});

预计行为：
[群聊]
user1: aaa
user2: bbb
user1: @robot 123
robot: @user1 收到消息: 123
user2: -456
robot: @user2 收到消息: 456

返回值

事件处理函数有以下几种返回值

• 任何boolean值为true的返回值，代表本模块处理了此事件，阻止事件继续向其他模块传递
• 任何boolean值为false的返回值，代表本模块不处理此事件，事件会继续向其他模块传递

const RepeatGroup = mod => {
  mod.setMeta({
    packageName: 'repeatGroup',
  });
  mod.on(CQEventType.messageGroup, async ctx => {
    if (ctx.textMessage.includes('123')) return false; // 消息中包含123，则不复读此消息，让消息继续传递给其他模块
    if (ctx.textMessage.includes('111')) return true; // 消息中包含123，则不复读此消息，也不让消息流向下一个模块
    ctx.reply(`收到消息: ${ctx.textMessage}`);
    return true;
  });
};

const NextModule = mod => {
  mod.setMeta({
    packageName: 'nextModule',
  });
  mod.on(CQEventType.messageGroup, async ctx => {
    ctx.reply('RepeatGroup不处理此消息');
    return true;
  });
};

CQNode.createRobot({
  modules: [
    RepeatGroup,
    NextModule, // <- CQNode会按顺序传递消息
  ],
});

预计行为：
[群聊]

user: 123
robot: MyModule不处理此消息

user: 111

user: @robot asdf
robot: @user 收到消息: asdf

子事件

messageGroup是message事件的子事件，因此在收到messageGroup事件时，也会传递给message事件的处理函数 事件传递给一个模块时，会先传递给子事件处理函数，再传递给父事件处理函数 参考消息处理

下一步 API