Skip to content

Intents 意图

Intents 使用位掩码(bitmask)控制机器人向 QQ 网关订阅哪些事件类型。

未订阅的事件类型即使发生,网关也不会推送,有助于减少不必要的网络流量。

支持的意图位

事件范围位值常量
群聊 + 私聊全部事件1 << 25 (33554432)GROUP_AND_C2C_EVENT
互动事件(按钮点击等)1 << 26 (67108864)INTERACTION

配置方式

config.yml 中设置(可选,默认已覆盖全部常用事件):

yaml
# 默认值:(1<<25) | (1<<26) = 100663296
intent: 100663296

# 仅群聊和私聊
# intent: 33554432

# 仅互动事件
# intent: 67108864

在代码中使用(高级)

SDK 内部使用 Intents 类:

java
// 默认意图
Intents i = Intents.defaultIntents(); // 群+C2C+互动

// 自定义
Intents i = Intents.fromValue(1 << 25); // 仅群+C2C

// 空意图(不订阅任何事件)
Intents i = Intents.none();

一般不需要修改

对大多数插件开发者来说,默认意图已包含全部常用事件,无需在 config.yml 中手动设置。