消息发送
公告
站点迁移啦~!
为什么迁移?
作为由我们官方维护的组件库,分散在各自的文档站点中的确有好处:它们可以各自维护自己所需的东西、互不干扰。
但是缺点也很明显: 太过分散。
组件库与核心库之间的关系是比较紧密的, 我们希望你能够在一个站点内就可以查阅或搜索到所有你想要得知的信息。
在 KOOK 组件中,主要有两种发送消息的方式。
直接构建并使用 API 发送消息。这是最原始的消息发送方式。
在使用 simbot 核心库时,配合使用 消息元素
Message.Element
发送消息。
本章将主要介绍第 1 种方式: 使用 API 发送消息。而与消息元素相关的内容可前往参考 消息元素。
使用 API
KOOK API 中用于发送消息的 API 主要就是 向子频道发送消息 和 向用户发送私聊消息。 它们的 API 封装分别为:
这两个 API 的大致使用方式很类似,因此此处只选其一 SendChannelMessageApi
作为实例。
仅在API模块使用
与在 使用 API 中的示例类似, 当你不依赖其他模块,仅依赖 API 模块 simbot-component-kook-api
时, 你可以使用比较贴合原始的方式直接使用 API。
TODO
// TODO
TODO
// TODO
在标准库中使用
当你依赖使用 标准库模块 simbot-component-kook-stdlib
时, 标准库提供的 Bot
中基本已经包含了请求 API 所需要的基本信息, 因此其会提供一些扩展/辅助方法来简化你的请求逻辑。
TODO
// TODO
TODO
// TODO
在组件库配合simbot4核心库时使用
其实在组件库中, KookBot
类型可以直接提供它内部包含的标准库 Bot
, 因此你可以获取到 KookBot.sourceBot
后,直接用 标准库的方式 进行请求。
val kookBot: KookBot = ...
val bot = kookBot.sourceBot // 得到标准库的 Bot
KookBot kookBot = ...;
Bot bot = kookBot.getSourceBot(); // 得到标准库的 Bot
Last modified: 07 August 2024