BotConfiguration
Bot 配置. 用于 BotFactory.newBot.
部分平台相关配置位于 AbstractBotConfiguration, 例如 fileBasedDeviceInfo
.
Kotlin 使用方法:
val bot = BotFactory.newBot(...) {
// 在这里配置 Bot
bogLoggerSupplier = { bot -> ... }
fileBasedDeviceInfo()
inheritCoroutineContext() // 使用 `coroutineScope` 的 Job 作为父 Job
}
Java 使用方法:
Bot bot = BotFactory.newBot(..., new BotConfiguration() {{
setBogLoggerSupplier((Bot bot) -> { ... })
fileBasedDeviceInfo()
...
}})
Types
标注一个配置 DSL 函数
联系人信息缓存配置
心跳策略.
Functions
设置 autoReconnectOnForceOffline 为 true
, 即在被挤下线时自动重连.
禁止保存 account.secrets
.
禁用好友列表和群成员列表的缓存.
启用好友列表和群成员列表的缓存.
使用文件存储设备信息.
使用当前协程的 coroutineContext 作为 parentCoroutineContext.
使用特定由 DeviceInfo 序列化产生的 JSON 的设备信息
不显示网络日志. 不推荐.
使用随机设备信息.
Properties
在被挤下线时 (BotOfflineEvent.Force) 自动重连. 默认为 false
.
日志记录器
联系人信息缓存配置. 将会保存在 cacheDir
中 contacts
目录
是否处理接受到的特殊换行符, 默认为 true
设备信息覆盖. 在没有手动指定时将会通过日志警告, 并使用随机设备信息.
连接心跳包周期. 过长会导致被服务器断开连接.
每次心跳时等待结果的时间. 一旦心跳超时, 整个网络服务将会重启 (将消耗约 1s). 除正在进行的任务 (如图片上传) 会被中断外, 事件和插件均不受影响.
Highway 通道上传图片, 语音, 文件等资源时的协程数量.
是否显示过于冗长的事件日志
登录缓存.
验证码处理器
网络层日志构造器
父 CoroutineContext. Bot 创建后会使用 SupervisorJob 覆盖其 Job, 但会将这个 Job 作为父 Job
使用协议类型
最多尝试多少次重连
状态心跳包周期. 过长会导致掉线. 该值会在登录时根据服务器下发的配置自动进行更新.