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

Package net.mamoe.mirai.contact

Types

AnonymousMember

@NotStableForInheritance

interface AnonymousMember : Member

代表匿名群成员.

AudioSupported

@NotStableForInheritance

interface AudioSupported : Contact

支持发送语音的 Contact

BotIsBeingMutedException

class BotIsBeingMutedException @MiraiInternalApi constructor(target: Group, originalMessage: Message) : SendMessageFailedException

发送消息时 bot 正处于被禁言状态时抛出的异常.

ClientKind

enum ClientKind : Enum<ClientKind>

详细设备类型. 在登录时查询到的设备列表中无此信息. 只在 OtherClientOnlineEvent 才有.

Contact

@NotStableForInheritance

interface Contact : ContactOrBot, CoroutineScope

联系对象, 即可以与 Bot 互动的对象. 包含用户, 和群.

ContactList

class ContactList<out C : Contact> @MiraiInternalApi constructor(delegate: MutableCollection<@UnsafeVariance C>) : Collection<C>

只读联系人列表. 元素列表仍可能会被 mirai 内部修改.

ContactOrBot

@NotStableForInheritance

interface ContactOrBot : CoroutineScope

拥有 id 的对象. 此为 Contact 与 Bot 的唯一公共接口.

FileSupported

@NotStableForInheritance

interface FileSupported : Contact

支持文件操作的 Contact. 目前仅 Group.

Friend

@NotStableForInheritance

interface Friend : User, CoroutineScope, AudioSupported, RoamingSupported

代表一位好友.

Group

@NotStableForInheritance

interface Group : Contact, CoroutineScope, FileSupported, AudioSupported

群.

GroupSettings

interface GroupSettings

群设置

Member

@NotStableForInheritance

interface Member : User

代表一位群成员.

MemberPermission

enum MemberPermission : Enum<MemberPermission> , Comparable<MemberPermission>

群成员的权限.

MessageTooLargeException

class MessageTooLargeException(target: Contact, originalMessage: Message, messageAfterEvent: Message, exceptionMessage: String) : SendMessageFailedException

发送消息时消息过长抛出的异常.

NormalMember

@NotStableForInheritance

interface NormalMember : Member

代表一位普通的群成员.

OtherClient

@NotStableForInheritance

interface OtherClient : Contact

其他设备. 如当 Bot 以 ANDROID_PHONE 登录时, 还可以有其他设备以 ANDROID_PAD, iOS, PC 或其他设备登录.

OtherClientInfo

data class OtherClientInfo @MiraiInternalApi constructor(appId: Int, platform: Platform?, deviceName: String, deviceKind: String)

PermissionDeniedException

class PermissionDeniedException : IllegalStateException

权限不足

Platform

enum Platform : Enum<Platform>

SendMessageFailedException

open class SendMessageFailedException @MiraiInternalApi constructor(target: Contact, reason: SendMessageFailedException.Reason, originalMessage: Message) : RuntimeException

发送消息失败时抛出的异常

Stranger

@NotStableForInheritance

interface Stranger : User, CoroutineScope

代表一位陌生人.

TempUser

@MiraiInternalApi(message = "其他渠道的临时会话暂未支持. ")

@NotStableForInheritance

interface TempUser : User

临时会话用户, 非群成员.

User

@NotStableForInheritance

interface User : Contact, UserOrBot, CoroutineScope

代表一个用户.

UserOrBot

@NotStableForInheritance

interface UserOrBot : ContactOrBot

Functions

asFriend

fun Member.asFriend(): Friend

得到此成员作为好友的对象.

fun Stranger.asFriend(): Friend

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

asFriendOrNull

fun Member.asFriendOrNull(): Friend?

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

fun Stranger.asFriendOrNull(): Friend?

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

asStranger

fun Member.asStranger(): Stranger

得到此成员作为陌生人的对象.

asStrangerOrNull

fun Member.asStrangerOrNull(): Stranger?

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

checkBotPermission

inline fun Group.checkBotPermission(required: MemberPermission, crossinline lazyMessage: () -> String = { "Permission denied: required $required, got actual $botPermission for $bot in group $id" })

要求 Bot 在这个群里的权限至少为 required, 否则抛出异常 PermissionDeniedException

getMember

inline fun Group.getMember(id: Long): NormalMember?

同 get. 在一些不适合使用 get 的情境下使用 getMember.

getMemberOrFail

inline fun Group.getMemberOrFail(id: Long): NormalMember

同 getMemberOrFail. 在一些不适合使用 getOrFail 的情境下使用 getMemberOrFail.

isAdministrator

inline fun Member.isAdministrator(): Boolean

inline fun MemberPermission.isAdministrator(): Boolean

判断权限是否为管理员

isOperator

inline fun Member.isOperator(): Boolean

inline fun MemberPermission.isOperator(): Boolean

判断权限是否为管理员或群主

isOwner

inline fun Member.isOwner(): Boolean

inline fun MemberPermission.isOwner(): Boolean

判断权限是否为群主

mute

@ExperimentalTime

inline suspend fun NormalMember.mute(duration: Duration)

mute00

~~inline suspend~~ ~~fun~~ NormalMember.~~mute00~~(~~duration~~: Duration)

recallMessage

inline suspend fun Contact.recallMessage(source: MessageChain)

inline suspend fun Contact.recallMessage(source: MessageSource)

Properties

botMuteRemaining

val BotIsBeingMutedException.botMuteRemaining: Int

deviceKind

val OtherClient.deviceKind: String

deviceName

val OtherClient.deviceName: String

isBotMuted

val Group.isBotMuted: Boolean

返回机器人是否正在被禁言

isFriend

val Member.isFriend: Boolean

当此成员同时是 Bot 的好友时返回 true

isStranger

val Member.isStranger: Boolean

当此成员同时是 Bot 的陌生人时返回 true

nameCardOrNick

val Member.nameCardOrNick: String

获取非空群名片或昵称.

nameCardOrNick

val User.nameCardOrNick: String

获取非空群名片或昵称.

nameCardOrNick

val UserOrBot.nameCardOrNick: String

获取非空群名片或昵称.

platform

val OtherClient.platform: Platform?

remarkOrNameCard

val Member.remarkOrNameCard: String

获取非空备注或群名片.

remarkOrNameCardOrNick

val Member.remarkOrNameCardOrNick: String

获取非空备注或群名片或昵称.

remarkOrNick

val User.remarkOrNick: String

获取非空备注或昵称.