发版说明

1.5.1 版

该版本于 2022 年 12 月 13 日发布。

改进

该版本将 OpenSSL 升级到 1.1.1q。

新增功能

1. Token 过期提醒机制

由于 Token 具有一定的时效，在连接状态下如果 Token 即将失效，SDK 会提前 30 秒触发 OnTokenPrivilegeWillExpireHandler 回调，提醒用户更新 Token。当收到该回调时，用户需要重新在服务端生成新的 Token，然后调用 RenewToken 将新生成的 Token 传给 SDK。

相关参考：

• OnTokenPrivilegeWillExpireHandler
• CONNECTION_CHANGE_REASON > CONNECTION_CHANGE_REASON_TOKEN_EXPIRED (9)
• 使用 AccessToken2 鉴权

2. 细化离开频道失败原因

改版本新增 LEAVE_CHANNEL_ERR_KICKED (4) 错误码。当调用 Leave 方法离开频道时，如当前用户已被踢出频道，则返回此错误码。

相关参考：

• LEAVE_CHANNEL_ERR > LEAVE_CHANNEL_ERR_KICKED (4)

下架功能

富媒体传输 功能于该版本正式下线。旧版本 SDK 会继续支持，已集成富媒体传输功能的用户不受影响，需注意升级到该版本后无法使用。

删除了下列接口：

• CreateFileMessageByMediaId
• CreateFileMessageByUploading
• CreateImageMessageByMediaId
• CreateImageMessageByUploading
• CancelMediaUpload
• CancelMediaDownload
• DownloadMediaToFile
• DownloadMediaToMemory
• OnFileMessageReceivedHandler
• OnImageMessageReceivedHandler
• OnFileMessageReceivedFromPeerHandler
• OnImageMessageReceivedFromPeerHandler
• OnFileMediaUploadResultHandler
• OnImageMediaUploadResultHandler
• OnMediaUploadingProgressHandler
• OnMediaDownloadingProgressHandler
• OnMediaDownloadToFileResultHandler
• OnMediaDownloadToMemoryResultHandler
• OnMediaCancelResultHandler
• FileMessage
• ImageMessage
• DOWNLOAD_MEDIA_ERR_CODE
• UPLOAD_MEDIA_ERR_CODE
• CANCEL_MEDIA_ERR_CODE
• MediaOperationProgress

1.4.10 版

该版本于 2022 年 8 月 17 日发布。

修复了 iOS 上 RTM 和 RTC 同时使用的崩溃问题。

已知问题和局限性

SDK 自 1.4.8 版本起对 iOS 15 和 macOS Monterey 12 进行了兼容性适配。对于 1.4.8 以下版本，在 iOS 15 和 macOS Monterey 12 上高概率会发生崩溃。为避免该问题，请务必将 SDK 升级至 1.4.8 或之后版本。

1.4.8 版

该版本于 2021 年 8 月 18 日发布。

升级必看

兼容性变更

对 iOS 15 和 macOS Monterey 12 进行了兼容性适配。

改进

• 修复了 iOS 15 和 macOS Monterey 12 兼容性适配引发的潜在崩溃问题，提高了 SDK 稳定性。
• 提高了弱网状态下的登录成功率和消息投递成功率。
• 更新 Info.plist 文件内的 SDK 版本信息到最新版本。

问题修复

• 修复了 SDK 内存泄露的问题。
• 修复了一些崩溃问题。

1.4.4 版

该版本于 2021 年 4 月 20 日发布。

本次发版为云信令 Unity SDK 的首次发版。你可以参考以下文档集成 SDK，实现相应的实时消息发送和接收功能：

• 快速实现消息发送和接收
• API 参考

声网提供了开源的 Agora-Unity-RTM-SDK 示例项目，你也可以前往下载并体验。