Package-level declarations

Types

Link copied to clipboard

BotConfiguration 的平台特别配置

BotConfiguration 的 JVM 平台特别配置

Link copied to clipboard
abstract class AbstractExternalResource constructor(displayName: String? = null, cleanup: AbstractExternalResource.ResourceCleanCallback? = null) : ExternalResource

一个实现了基本方法的外部资源

Link copied to clipboard
Link copied to clipboard
expect class DeviceInfo constructor(display: ByteArray, product: ByteArray, device: ByteArray, board: ByteArray, brand: ByteArray, model: ByteArray, bootloader: ByteArray, fingerprint: ByteArray, bootId: ByteArray, procVersion: ByteArray, baseBand: ByteArray, version: DeviceInfo.Version, simInfo: ByteArray, osType: ByteArray, macAddress: ByteArray, wifiBSSID: ByteArray, wifiSSID: ByteArray, imsiMd5: ByteArray, imei: String, apn: ByteArray, androidId: ByteArray)

表示设备信息

actual class DeviceInfo constructor(val display: ByteArray, val product: ByteArray, val device: ByteArray, val board: ByteArray, val brand: ByteArray, val model: ByteArray, val bootloader: ByteArray, val fingerprint: ByteArray, val bootId: ByteArray, val procVersion: ByteArray, val baseBand: ByteArray, val version: DeviceInfo.Version, val simInfo: ByteArray, val osType: ByteArray, val macAddress: ByteArray, val wifiBSSID: ByteArray, val wifiSSID: ByteArray, val imsiMd5: ByteArray, val imei: String, val apn: ByteArray, val androidId: ByteArray)

表示设备信息

Link copied to clipboard

DeviceInfo 的构建器.

Link copied to clipboard

属性 sms 为短信验证码验证方式, fallback 为其他验证方式. 两个属性至少有一个不为 null, 在不为 null 时表示支持该验证方式. 可任意选用偏好的验证方式.

Link copied to clipboard

设备验证的验证结果. 请不要自行实现此接口, 而是通过解决 DeviceVerificationRequests 中的其中一种验证获得.

Link copied to clipboard
class DirectoryLogger constructor(val identity: String, directory: <Error class: unknown class> = File(identity), retain: Long = 1.weeksToMillis) : SimpleLogger

将日志写入('append')到特定文件夹中的文件. 每日日志独立保存.

Link copied to clipboard
expect interface ExternalResource

一个不可变的外部资源. 仅包含资源内容, 大小, 文件类型, 校验值而不包含文件名, 文件位置等. 外部资源有可能是一个文件, 也有可能只存在于内存, 或者以任意其他方式实现.

actual interface ExternalResource

一个不可变的外部资源. 仅包含资源内容, 大小, 文件类型, 校验值而不包含文件名, 文件位置等. 外部资源有可能是一个文件, 也有可能只存在于内存, 或者以任意其他方式实现.

Link copied to clipboard
expect interface FileCacheStrategy

资源缓存策略.

actual interface FileCacheStrategy

资源缓存策略.

Link copied to clipboard

表明这个 API 是为了让 Java 使用者调用更方便.

Link copied to clipboard

org.slf4j.Logger, org.apache.logging.log4j.Logger 或 java.util.logging.Logger 到 MiraiLogger 的转换器.

Link copied to clipboard
abstract class LoginSolver

验证码, 设备锁解决器

Link copied to clipboard

标记这个类, 类型, 函数, 属性, 字段, 或构造器为实验性的 API.

Link copied to clipboard
annotation class MiraiInternalFile

标记为一个仅供 Mirai 内部使用的 API.

Link copied to clipboard
expect interface MiraiLogger

日志记录器.

actual interface MiraiLogger

日志记录器.

Link copied to clipboard

日志基类. 若 Mirai 自带的日志系统无法满足需求, 请继承这个类或 PlatformLogger 并实现其抽象函数.

Link copied to clipboard

带有开关的 Logger. 仅能通过 MiraiLogger.withSwitch 构造

Link copied to clipboard
annotation class NotStableForInheritance(val message: String = "This declaration is not stable for inheritance.")

标记一个定义在使用上是稳定的 (如果没有特殊说明), 但只应该由 mirai 内部实现.

Link copied to clipboard
Link copied to clipboard

当前平台的默认的日志记录器.

JVM 控制台日志实现

Link copied to clipboard
interface ProgressionCallback<in S, in P>

操作进度回调, 可供前端使用, 以提供进度显示.

Link copied to clipboard

不做任何事情的 logger, keep silent.

Link copied to clipboard
open class SimpleLogger(val identity: String?, logger: (priority: SimpleLogger.LogPriority, message: String?, e: Throwable?) -> Unit) : MiraiLoggerPlatformBase

简易日志记录, 所有类型日志都会被重定向 logger

Link copied to clipboard

将日志写入('append')到特定文件.

将日志写入('append')到特定文件.

Link copied to clipboard
class StandardCharImageLoginSolver @JvmOverloads constructor(input: suspend () -> String = { readlnOrNull() ?: @OptIn(MiraiInternalApi::class) throw NoStandardInputForCaptchaException() }, loggerSupplier: (bot: Bot) -> MiraiLogger = { it.logger }) : LoginSolver

CLI 环境 LoginSolver. 将验证码图片转为字符画并通过 output 输出, input 获取用户输入.

Link copied to clipboard
expect interface Streamable<T>

表示一个可以创建数据流的对象.

actual interface Streamable<T>

表示一个可以创建数据流 Flow 和 Stream 的对象.

Functions

Link copied to clipboard
Link copied to clipboard
inline fun MiraiLogger.debug(message: () -> String?)
inline fun MiraiLogger.debug(message: () -> String?, e: Throwable?)
Link copied to clipboard
inline fun MiraiLogger.error(message: () -> String?)
inline fun MiraiLogger.error(message: () -> String?, e: Throwable?)
Link copied to clipboard

不要使用这个 API, 此 API 在未来可能会被删除

Link copied to clipboard
inline fun MiraiLogger.info(message: () -> String?)
inline fun MiraiLogger.info(message: () -> String?, e: Throwable?)
Link copied to clipboard
inline fun <T : ExternalResource, R> T.runAutoClose(action: T.() -> R): R

执行 action, 如果 ExternalResource.isAutoClose, 在执行完成后调用 ExternalResource.close.

Link copied to clipboard

将此 DeviceInfo 序列化为字符串. 序列化的字符串可以在以后通过 DeviceInfo.deserializeFromString 反序列化为 DeviceInfo.

Link copied to clipboard
inline fun <T : ExternalResource, R> T.useAutoClose(action: (resource: T) -> R): R

执行 action, 如果 ExternalResource.isAutoClose, 在执行完成后调用 ExternalResource.close.

Link copied to clipboard
inline fun MiraiLogger.verbose(message: () -> String)
inline fun MiraiLogger.verbose(message: () -> String, e: Throwable?)
Link copied to clipboard
inline fun MiraiLogger.warning(message: () -> String?)
inline fun MiraiLogger.warning(message: () -> String?, e: Throwable?)
Link copied to clipboard
inline fun <T : ExternalResource, R> T.withAutoClose(action: () -> R): R

执行 action, 如果 ExternalResource.isAutoClose, 在执行完成后调用 ExternalResource.close.

Link copied to clipboard

给这个 logger 添加一个开关, 用于控制是否记录 log