Releases · mamoe/mirai

23 Apr 13:01

Him188

0.39.0

9903ef4

0.39.0 Pre-release

Pre-release

二进制不兼容的修改: Bot.instances 现在返回 List<Bot>, 而不是 List<WeakRef<Bot>> 由于他们在 JVM 签名相同, 无法做兼容.

Contact 架构改变

原有 Member 继承 QQ, QQ 继承 Contact 架构改变.

新架构为:

弃用 QQ 命名 (二进制兼容到 1.0.0)
新增 User 继承 Contact, 作为 Member 和 Friend 的父类
Member 继承 User
Friend 继承 User

迁移

由于 Member 不再是 QQ 子类, 而原本表示 '好友' 意义的 QQ 删除,
需要根据实际情况替换 QQ 的引用为 Friend 或 Group

因修改, 新增以下 API:

fun Member.asFriend(): Friend: 得到此成员作为好友的对象或抛出异常
fun Member.asFriendOrNull(): Friend: 得到此成员作为好友的对象或返回 null
inline val Member.isFriend: Boolean: 判断此成员是否为好友

同时有以下修改:

val User.nameCardOrNick: 获取非空群名片 (如果是群员) 或昵称
弃用 fun Member.isMuted() 而改为属性 val Member.isMuted

图片

构造所有类型图片时只接受唯一一个参数 imageId: String.
所有类型图片只能获取唯一一个属性 imageId: String (以前可以获取长宽等数据)
提高发送图片的性能
优化 BufferedImage.toExternalImage 的性能
统一图片后缀: { ... }.mirai

消息

新增合并转发及其 DSL
新增 OfflineMessageSource 构造
新增 MessageSource 修改: MessageSource.copyAmend(block)
修复 'sequence not yet available' 问题 (#)
修复好友消息的消息源 id 错误的问题 (#247)
如果群成员是好友, 则发送好友消息, 而不是临时会话消息.
添加 MessageSource.internalId 以便将来使用
添加 OnlineMessageSource.toOffline
添加 ContactMessage.time
添加 ContactMessage.senderName

`OfflineMessageSource` 构造

可使用 DSL 构造离线消息, 修改其发送人, 发送时间, 发送内容等. 这对于跨群转发等情况十分有用.
OfflineMessageSource.kt: Line 90
DSL 总览:

val source: OfflineMessageSource = bot.buildMessageSource {
    bot sendTo target // 指定发送人和发送目标
    metadata(source) // 从另一个消息源复制 id, internalId, time

    messages { // 指定消息内容
        +"hi"
    }
}

合并转发及其 DSL

合并转发: ForwardMessage
DSL: ForwardMessageBuilder

DSL 总览:

buildForwardMessage {
    123456789 named "鸽子 A" says "咕"
    100200300 named "鸽子 C" at 1582315452 says "咕咕咕" // at 设置时间
    987654321 named "鸽子 B" says "咕"
    myFriend says "咕"
    bot says { // 构造消息链, 同 `buildMessageChain`
        +"发个图片试试"
        +Image("{90CCED1C-2D64-313B-5D66-46625CAB31D7}.jpg")
    }
}

不支持解析别人的转发.

其他

支持 bot 名片被其他人修改时的同步
修复登录时遇到服务器不可用时无法继续重连的问题
更名 Identified 到 ContactOrBot, 去掉其 '实验性' 注解
Bot.instances 现在返回 List<Bot>, 而不是 List<WeakRef<Bot>> (二进制兼容)
更名 subscribingGet 到 syncFromEvent, 并将其定义为稳定 API.
更名 subscribingGetAsync 到 asyncFromEvent, 并将其定义为稳定 API.
添加接受 eventClass: KClass<Event> 参数的事件监听 subscribe
在 MessageSubscribersBuilder 添加 sentBy(User), sentFrom(Group), atAll, at DSL
修复某些时候未处理 BotOfflineEvent.Force 的问题

Assets 2

20 Apr 14:10

Him188

0.38.0

8c3b76e

0.38.0 Pre-release

Pre-release

新增自定义消息 (实验性): CustomMessage
新增 MessageChain.contentEquals
新增 Message.isPlain, Message.isNotPlain
新增 MessageChain.allContent, MessageChain.noneContent
修复 CombinedMessage.toString 顺序错误, 添加缓存
新增 BotConfiguration.inheritCoroutineContext
将 Java API MessageChain.getOrNull 更名为 MessageChain.firstOrNull
将 Java API MessageChain.get 更名为 MessageChain.first
将 Java API MessageReceipt.recall(long) 更名为 MessageReceipt.recallIn(long) 以与其他 API 保持一致
优化 MessageChainBuilder 构建逻辑