mirror of
https://github.com/mamoe/mirai.git
synced 2025-03-26 07:20:09 +08:00
122 lines
3.7 KiB
Kotlin
122 lines
3.7 KiB
Kotlin
/*
|
|
* Copyright 2019-2021 Mamoe Technologies and contributors.
|
|
*
|
|
* 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
|
|
* Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
|
|
*
|
|
* https://github.com/mamoe/mirai/blob/master/LICENSE
|
|
*/
|
|
|
|
@file:Suppress("unused", "NOTHING_TO_INLINE")
|
|
|
|
package net.mamoe.mirai
|
|
|
|
import net.mamoe.mirai.utils.BotConfiguration
|
|
|
|
/**
|
|
* 构造 [Bot] 的工厂. 这是 [Bot] 唯一的构造方式.
|
|
*
|
|
* @see IMirai.BotFactory
|
|
*/
|
|
public interface BotFactory {
|
|
/**
|
|
* 相当于 Kotlin lambda `BotConfiguration.() -> Unit` 和 Java `Consumer<BotConfiguration>`
|
|
*
|
|
* @see newBot
|
|
*/
|
|
public fun interface BotConfigurationLambda {
|
|
public operator fun BotConfiguration.invoke()
|
|
}
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// Plain Password
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
* 使用指定的 [配置][configuration] 构造 [Bot] 实例
|
|
*/
|
|
public fun newBot(qq: Long, password: String, configuration: BotConfiguration): Bot
|
|
|
|
/**
|
|
* 使用指定的 [配置][configuration] 构造 [Bot] 实例
|
|
*
|
|
* Kotlin:
|
|
* ```
|
|
* newBot(123, "") {
|
|
* // this: BotConfiguration
|
|
* fileBasedDeviceInfo()
|
|
* }
|
|
* ```
|
|
*
|
|
* Java:
|
|
* ```java
|
|
* newBot(123, "", configuration -> {
|
|
* configuration.fileBasedDeviceInfo()
|
|
* })
|
|
* ```
|
|
*/
|
|
public fun newBot(
|
|
qq: Long,
|
|
password: String,
|
|
configuration: BotConfigurationLambda /* = BotConfiguration.() -> Unit */
|
|
): Bot = newBot(qq, password, configuration.run { BotConfiguration().apply { invoke() } })
|
|
|
|
/**
|
|
* 使用 [默认配置][BotConfiguration.Default] 构造 [Bot] 实例
|
|
*/
|
|
public fun newBot(qq: Long, password: String): Bot = newBot(qq, password, BotConfiguration.Default)
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// MD5 Password
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
* 使用指定的 [配置][configuration] 构造 [Bot] 实例
|
|
*
|
|
* @param passwordMd5 16 bytes
|
|
*/
|
|
public fun newBot(qq: Long, passwordMd5: ByteArray, configuration: BotConfiguration): Bot
|
|
|
|
/**
|
|
* 使用指定的 [配置][configuration] 构造 [Bot] 实例
|
|
*
|
|
* Kotlin:
|
|
* ```
|
|
* newBot(123, password) {
|
|
* // this: BotConfiguration
|
|
* fileBasedDeviceInfo()
|
|
* }
|
|
* ```
|
|
*
|
|
* Java:
|
|
* ```java
|
|
* newBot(123, password, configuration -> {
|
|
* configuration.fileBasedDeviceInfo()
|
|
* })
|
|
* ```
|
|
*
|
|
* @param passwordMd5 16 bytes
|
|
*/
|
|
public fun newBot(
|
|
qq: Long,
|
|
passwordMd5: ByteArray,
|
|
configuration: BotConfigurationLambda /* = BotConfiguration.() -> Unit */
|
|
): Bot = newBot(qq, passwordMd5, configuration.run { BotConfiguration().apply { invoke() } })
|
|
|
|
/**
|
|
* 使用 [默认配置][BotConfiguration.Default] 构造 [Bot] 实例
|
|
*
|
|
* @param passwordMd5 16 bytes
|
|
*/
|
|
public fun newBot(qq: Long, passwordMd5: ByteArray): Bot = newBot(qq, passwordMd5, BotConfiguration.Default)
|
|
|
|
public companion object INSTANCE : BotFactory {
|
|
override fun newBot(qq: Long, password: String, configuration: BotConfiguration): Bot {
|
|
return Mirai.BotFactory.newBot(qq, password, configuration)
|
|
}
|
|
|
|
override fun newBot(qq: Long, passwordMd5: ByteArray, configuration: BotConfiguration): Bot {
|
|
return Mirai.BotFactory.newBot(qq, passwordMd5, configuration)
|
|
}
|
|
}
|
|
} |