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 中手动设置。
