simbot-component-qq-guild-core/love.forte.simbot.component.qguild.bot/QGBot/sendTo

sendTo

abstract suspend fun sendTo(channelId: ID, text: String): QGMessageReceipt(source)
abstract suspend fun sendTo(channelId: ID, message: Message): QGMessageReceipt(source)

直接向目标子频道发送消息。

此频道需要为文字子频道，否则会产生异常，但是此异常不会由程序检测， 而是通过API的错误响应 QQGuildApiException 体现。

sendTo 相对于 QGTextChannel.send 而言更加“不可靠” —— 因为它跳过了对频道服务器和对子频道类型的校验，失去了在消息中自动填充 msgId 等透明行为，并且直接使用ID也会存在一些细微的隐患。 但是这可以有效规避当没有获取频道服务器或子频道信息权限时候可能导致的问题。

如有必要，请不要忘记添加 QGReplyTo 来指定一个用于回复标记的 msgId。

Return

消息发送回执

Throws

see HttpClient.request, 可能会抛出任何ktor请求过程中的异常。

请求异常，例如无权限

当响应状态为表示消息审核的 304023、304024 时

abstract suspend fun sendTo(channelId: ID, message: MessageContent): QGMessageReceipt(source)

直接向目标子频道发送消息。

此频道需要为文字子频道，否则会产生异常，但是此异常不会由程序检测， 而是通过API的错误响应 QQGuildApiException 体现。

sendTo 相对于 QGTextChannel.send 而言更加“不可靠” —— 因为它跳过了对频道服务器和对子频道类型的校验，失去了在消息中自动填充 msgId 等透明行为， 并且直接使用ID也会存在一些细微的隐患。 但是这可以有效规避当没有获取频道服务器或子频道信息权限时候可能导致的问题。

如有必要，请不要忘记添加 QGReplyTo 来指定一个用于回复标记的 msgId。

Return

消息发送回执

Throws

see HttpClient.request, 可能会抛出任何ktor请求过程中的异常。

请求异常，例如无权限

当响应状态为表示消息审核的 304023、304024 时