mirai-core / net.mamoe.mirai.contact / QQ

QQ

@PlannedRemoval("1.0.0") abstract class QQ : User, CoroutineScope
Deprecated: use Friend or Person instead

QQ 对象.

自 0.39.0 起 mirai 引入 User 作为 FriendMember 的父类, 以备将来支持仅 Friend 可用的 API, 如设置备注.

所有 API 均有二进制兼容.

请根据实际情况, 使用 FriendUser 替代.

Constructors

<init>

QQ 对象.

QQ()

Properties

avatarUrl

头像下载链接

open val avatarUrl: String

id

QQ 号码

abstract val id: Long

nick

昵称

abstract val nick: String

Functions

sendMessage

向这个对象发送消息.

abstract suspend fun sendMessage(message: Message): MessageReceipt<QQ>

Extension Properties

nameCardOrNick

获取非空群名片或昵称.

val User.nameCardOrNick: String

Extension Functions

recall

suspend fun Contact.recall(source: MessageChain): Unit
suspend fun Contact.recall(source: MessageSource): Unit

recallIn

fun Contact.recallIn(message: MessageChain, millis: Long, coroutineContext: CoroutineContext = EmptyCoroutineContext): Job
fun Contact.recallIn(source: MessageSource, millis: Long, coroutineContext: CoroutineContext = EmptyCoroutineContext): Job

sendImage

Dispatchers.IO 中将图片发送到指定联系人. 不会保存临时文件

suspend fun <C : Contact> C.sendImage(bufferedImage: BufferedImage): MessageReceipt<C>

Dispatchers.IO 中下载 URL 到临时文件并将其作为图片发送到指定联系人

suspend fun <C : Contact> C.sendImage(imageUrl: URL): MessageReceipt<C>

Dispatchers.IO 中读取 Input 到临时文件并将其作为图片发送到指定联系人

suspend fun <C : Contact> C.sendImage(imageInput: Input): MessageReceipt<C>

Dispatchers.IO 中读取 InputStream 到临时文件并将其作为图片发送到指定联系人

suspend fun <C : Contact> C.sendImage(imageStream: InputStream): MessageReceipt<C>

Dispatchers.IO 中将文件作为图片发送到指定联系人

suspend fun <C : Contact> C.sendImage(file: File): MessageReceipt<C>

sendImage

将图片作为单独的消息发送给 this

suspend fun <C : Contact> C.sendImage(image: ExternalImage): MessageReceipt<C>

uploadImage

Dispatchers.IO 中将图片上传, 但不发送. 不会保存临时文件

suspend fun Contact.uploadImage(bufferedImage: BufferedImage): OfflineImage

Dispatchers.IO 中下载 URL 到临时文件并将其作为图片上传, 但不发送

suspend fun Contact.uploadImage(imageUrl: URL): OfflineImage

Dispatchers.IO 中读取 Input 到临时文件并将其作为图片上传, 但不发送

suspend fun Contact.uploadImage(imageInput: Input): OfflineImage

Dispatchers.IO 中读取 InputStream 到临时文件并将其作为图片上传, 但不发送

suspend fun Contact.uploadImage(imageStream: InputStream): OfflineImage

Dispatchers.IO 中将文件作为图片上传, 但不发送

suspend fun Contact.uploadImage(file: File): OfflineImage

Inheritors

Friend

好友 对象. 注意: 一个 Friend 实例并不是独立的, 它属于一个 Bot. 它不能被直接构造. 任何时候都应从 Bot.getFriend 或事件中获取.

abstract class Friend : QQ, CoroutineScope

MemberJavaFriendlyAPI

Member 中为了让 Java 更容易调用的 API 不要用它作为一个类型, 只应使用其中的方法

abstract class MemberJavaFriendlyAPI : QQ