Group
群.
群员操作
获取群成员
使用 Group.members 可获取除 Bot 自身外的所有群成员 (包括管理员和群主) 列表. Bot 自身在群内的对象可通过 botAsMember 获取.
get 可以按 QQ 号码获取一个群成员对象, 在不存在时返回 null
. getOrFail 则在不存在时抛出 NoSuchElementException.
判断管理员权限
首先获取到目标群成员对象, 然后使用 NormalMember.permission 获取其权限.
Bot 在群内的权限可通过 Group.botPermission 或其 Member 对象 的 NormalMember.permission 获取.
其他动作
设置管理员权限: NormalMember.modifyAdmin
戳一戳: NormalMember.nudge
群公告
可通过 Group.announcements 获取公告支持. 可在 Announcements 查看详细文档.
群文件
使用 Group.files 获取群文件管理器后操作. 详见 RemoteFiles.
Functions
群头像下载链接.
要求 Bot 在这个群里的权限至少为 required, 否则抛出异常 PermissionDeniedException
获取群成员实例. 不存在时返回 null
.
同 getMemberOrFail. 在一些不适合使用 getOrFail 的情境下使用 getMemberOrFail.
获取群成员实例. 不存在时抛出 kotlin.NoSuchElementException.
在此 CoroutineScope 下创建一个监听所有事件的 EventChannel. 相当于 GlobalEventChannel.parentScope(this).context(coroutineContext)
.
在该群发布群公告并获得 OnlineAnnouncement, 需要管理员权限. 发布公告后群内将会出现 "有新公告" 系统提示.
发送纯文本消息
向这个对象发送消息.
将一条消息设置为群精华消息, 需要管理员或群主权限. 操作成功返回 true
.
将一条消息设置为群精华消息, 需要管理员或群主权限. 操作成功返回 true
.
上传一个语音文件以备发送. resource 需要调用方ExternalResource.close.
上传一个 资源 作为图片以备发送.
将文件作为图片上传, 但不发送
将文件作为图片上传, 但不发送
读取 InputStream 到临时文件并将其作为图片上传, 但不发送
Properties
获取群荣誉相关功能接口
获取群公告相关功能接口
群头像下载链接, 规格默认为 AvatarSpec.LARGEST
机器人被禁言还剩余多少秒
机器人在这个群里的权限
获取远程文件列表 (管理器).
返回机器人是否正在被禁言
群成员列表, 不含机器人自己, 含群主.
群主.
获取漫游消息记录管理器.
群设置