Karin API Docs / QQBotButton

接口: QQBotButton

定义于: packages/core/src/types/segment/button.ts:42

QQ官方按钮消息结构

属性

action

action: object

定义于: packages/core/src/types/segment/button.ts:62

操作相关的数据

anchor?

optional anchor: number

本字段仅在指令按钮下有效，设置后后会忽略 action.enter 配置。 设置为 1 时 ，点击按钮自动唤起启手Q选图器，其他值暂无效果。 （仅支持手机端版本 8983+ 的单聊场景，桌面端不支持）

at_bot_show_channel_list?

optional at_bot_show_channel_list: boolean

【已弃用】指令按钮可用，弹出子频道选择器，默认 false

click_limit?

optional click_limit: number

【已弃用】可操作点击的次数，默认不限

data

data: string

操作相关的数据

enter?

optional enter: boolean

指令按钮可用，点击按钮后直接自动发送 data，默认 false

permission

permission: object

权限设置

permission.specify_role_ids?

optional specify_role_ids: string[]

有权限的身份组 id 的列表（仅频道可用）

permission.specify_user_ids?

optional specify_user_ids: string[]

有权限的用户 id 的列表

permission.type

type: number

0 指定用户可操作，1 仅管理者可操作，2 所有人可操作，3 指定身份组可操作（仅频道可用）

reply?

optional reply: boolean

指令按钮可用，指令是否带引用回复本消息，默认 false

type

type: 0 | 1 | 2

设置 0 跳转按钮：http 或 小程序 客户端识别 scheme，设置 1 回调按钮：回调后台接口, data 传给后台，设置 2 指令按钮：自动在输入框插入

Bot

data

unsupport_tips

unsupport_tips: string

客户端不支持本action的时候，弹出的toast文案

---

id

id: string

定义于: packages/core/src/types/segment/button.ts:44

按钮ID：在一个keyboard消息内设置唯一

---

render_data

render_data: object

定义于: packages/core/src/types/segment/button.ts:46

按钮上的文字

label

label: string

按钮上的文字

style

style: number

按钮样式

• 0-灰色线框
• 1-蓝色线框
• 2-特殊样式按钮
• 3-红色文字
• 4-白色填充

visited_label

visited_label: string

点击后按钮的上文字