Announcement

interface Announcement

表示一个 (群) 公告.

公告类型

Announcement 可以是 OnlineAnnouncementOfflineAnnouncement.

发布公告

构造一条新公告并发布

构造 OfflineAnnouncement 然后调用其 OfflineAnnouncement.publishToAnnouncements.publish.

在构造时可提供可选的 AnnouncementParameters 来设置一些附加属性.

也可以使用 Announcement.publishAnnouncement 扩展快捷创建并发布公告.

转发获取的公告到其他群

通过一个群的 Announcements 获取到 OnlineAnnouncement, 然后调用 OnlineAnnouncement.publishTo 到另一个群即可. 由于目前不支持获取公告的图片, 转发的公告也就不会带有原公告的图片.

序列化

OfflineAnnouncement 支持 kotlinx-serialization 序列化, 可使用 serializer OfflineAnnouncement.serializer.

OnlineAnnouncement 无法序列化. 只能将其转为 OfflineAnnouncement 再序列化. 在 Kotlin 使用 Announcement.toOffline, 在 Java 使用 OfflineAnnouncement.from.

Since

2.7

See also

Types

Link copied to clipboard
object Companion

Functions

Link copied to clipboard
open suspend fun publishTo(group: Group): OnlineAnnouncement

在该群发布群公告并获得 OnlineAnnouncement, 需要管理员权限. 发布公告后群内将会出现 "有新公告" 系统提示.

Properties

Link copied to clipboard
abstract val content: String

内容

Link copied to clipboard
abstract val parameters: AnnouncementParameters

附加参数. 可以通过 AnnouncementParametersBuilder 构建获得.

Inheritors

Link copied to clipboard
Link copied to clipboard

Extensions

Link copied to clipboard
inline fun Announcement.toOffline(): OfflineAnnouncement

创建 OfflineAnnouncement. 若 this 类型为 OfflineAnnouncement 则直接返回 this.