mirai-core-api/net.mamoe.mirai.auth/BotAuthorization/authorize

authorize

abstract suspend fun authorize(session: BotAuthSession, info: BotAuthInfo): BotAuthResult

此方法控制 Bot 如何进行登录.

Bot 只能使用一种登录方式, 但是可以在一种登录方式失败的时候尝试其他登录方式

异常类型

抛出一个 LoginFailedException 以正常地终止登录, 并可建议系统进行重连或停止 bot (通过 LoginFailedException.killBot). 例如抛出 RetryLaterException 可让 bot 重新进行一次登录.

抛出任意其他 Throwable 将视为鉴权选择器的自身错误.

示例代码

override suspend fun authorize(
     authComponent: BotAuthSession,
     bot: BotAuthInfo,
) {
     return kotlin.runCatching {
         authComponent.authByQRCode()
     }.recover {
         authComponent.authByPassword("...")
     }.getOrThrow()
}