mirai-core-api/net.mamoe.mirai.contact/Stranger

Stranger

@NotStableForInheritance
interface Stranger : User, CoroutineScope
Content copied to clipboard

代表一位陌生人.

一个 Stranger 实例并不是独立的, 它属于一个 Bot. 对于同一个 Bot, 任何一个人的 Stranger 实例都是单一的. Stranger 无法通过任何方式直接构造. 任何时候都应从 Bot.getStranger 或事件中获取.

陌生人的来源：当将添加好友设置为 ‘任何人可添加为好友’或‘需要回答对验证问题时’ 且被他人成功添加时此人会成为陌生人

陌生人需要主动添加好友才能构成好友关系 但 Mirai 将不会提供此功能 请手动在其他客户端添加好友

See also

Functions

Link copied to clipboard
@JvmName(name = "getAvatarUrl")
open fun avatarUrl(spec: AvatarSpec): String
Content copied to clipboard

头像下载链接.

Link copied to clipboard
abstract suspend fun delete()
Content copied to clipboard

删除并屏蔽该陌生人, 屏蔽后对方将无法发送临时会话消息

Link copied to clipboard
open override fun nudge(): StrangerNudge
Content copied to clipboard

创建一个 "戳一戳" 消息

Link copied to clipboard
open suspend fun queryProfile(): UserProfile
Content copied to clipboard

查询用户信息

Link copied to clipboard
open suspend override fun sendMessage(message: String): MessageReceipt<Stranger>
Content copied to clipboard

发送纯文本消息

abstract suspend override fun sendMessage(message: Message): MessageReceipt<Stranger>
Content copied to clipboard

向这个对象发送消息.

Link copied to clipboard
expect abstract suspend fun uploadImage(resource: ExternalResource): Image
Content copied to clipboard

上传一个 资源 作为图片以备发送.

Properties

Link copied to clipboard
open val avatarUrl: String
Content copied to clipboard

头像下载链接, 规格默认为 AvatarSpec.LARGEST

Link copied to clipboard
expect abstract override val bot: Bot
Content copied to clipboard

这个联系对象所属 Bot.

Link copied to clipboard
abstract val coroutineContext: CoroutineContext
Content copied to clipboard
Link copied to clipboard
abstract override val id: Long
Content copied to clipboard

QQ 号码

Link copied to clipboard
abstract val nick: String
Content copied to clipboard

获取昵称

Link copied to clipboard
abstract val remark: String
Content copied to clipboard

备注信息

Extensions

Link copied to clipboard
fun Stranger.asFriend(): Friend
Content copied to clipboard

得到此陌生人作为好友的对象.

Link copied to clipboard
fun Stranger.asFriendOrNull(): Friend?
Content copied to clipboard

得到此陌生人作为好友的对象, 当此成员不是好友时返回 null