# 发版说明 (/zh-CN/realtime-media/rtc-server-sdk/reference/release-notes/java) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 4.4.32 版 [#4432-版-1] 该版本于 2025 年 5 月 28 日发布。 ### 新增特性 [#新增特性-9] #### 音频 Metadata 数据 [#音频-metadata-数据] 该版本新增发送和接收音频 Metadata 数据功能。在需要发送音频附属信息,如播放进度等的场景下,你可以调用 [`sendAudioMetadata`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user#a10bb7ca5b7d12999f0e3f4bb6b3e9d61) 方法进行发送,远端用户会在 [`onAudioMetadataReceived`](/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-local-user-observer#a84c4706b0f30c43b6274b480ceaa9638) 回调中接收到发送的信息。 #### 原始音频数据支持 VAD [#原始音频数据支持-vad] 为支持获取原始音频数据中的 VAD 信息,该版本新增重载的 [`registerAudioFrameObserver`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user#registeraudioframeobserver-22) 方法,支持通过 `enableVad` 参数开启 VAD 监测功能。 开启后,你可以通过 [`onPlaybackAudioFrameBeforeMixing`](/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-audio-frame-observer#a8a44837f2c54f22fe35aeaaf5d4f50f8) 回调中的 `vadResult` 参数获取 VAD 状态信息。 #### 接收编码后的音频数据 [#接收编码后的音频数据] 该版本新增支持接收编码后的音频数据。相关接口如下: - [`registerAudioEncodedFrameObserver`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user#aef2cc197030fcd418c10d35a692fd5a6):注册编码后的音频数据观测器 - [`IAudioEncodedFrameObserver`](/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-audio-encoded-frame-observer):编码后的音频数据接口类。你可以在该接口类中,通过 [`onEncodedAudioFrameReceived`](/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-audio-encoded-frame-observer#a15dd0f01400dc3b630df2820dba6715b) 回调接收编码后的音频数据。 #### 外部视频源支持自定义颜色空间 [#外部视频源支持自定义颜色空间] 该版本在 [`ExternalVideoFrame`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-external-video-frame) 中增加 `colorSpace` 属性,支持对外部采集到的视频数据自定义颜色空间。 #### 支持域名管理 [#支持域名管理] 该版本在 [`AgoraServiceConfig`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service-config) 中增加 `domainLimit` 参数,支持对连接的域名进行设置和管理。 ### 改进 [#改进-7] #### 音视频数据发送模块接口易用性改进 [#音视频数据发送模块接口易用性改进] 为提升音视频数据发送模块的易用性,该版本对如下接口和方法进行了优化: - `AgoraAudioPcmDataSender` 中,废弃了原来的 `send` 方法,新增 [`sendAudioPcmData`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-pcm-data-sender#a1a109d7059fdffdfebfa9dc476957ab4) 进行取代。 - `AgoraAudioEncodedFrameSender` 中,删除了原来的 `send` 方法,新增 [`sendEncodedAudioFrame`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-encoded-frame-sender#a96ab51c07987dcf9adf7c1bc1a05c1e2) 进行取代。 - `AgoraVideoEncodedImageSender` 中,删除了原来的 `send` 方法,新增 [`sendEncodedVideoImage`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-video-encoded-image-sender#ab9073bfd03dab3922d1594ce4bc507c8) 进行取代。 - `AgoraVideoFrameSender` 中,移除 `send` 方法,新增 [`sendVideoFrame`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-video-frame-sender#a6cff413f3767180045f5bf3c9b2d1a04) 进行取代。 #### 新增 sendStreamMessage 重载 [#新增-sendstreammessage-重载] 该版本新增了 [`sendStreamMessage`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a1286a74a33789cc9777bf58a04f777c0) 的重载方法。和已有的 `sendStreamMessage` 相比,该方法删除了 `length` 参数,并将 `message` 的数据类型由 `String` 改为 `byte[]`。 ### 问题修复 [#问题修复-6] - 修复了 `VideoFrame` 中 `alphaBuffer` 和 `metadataBuffer` 的处理问题 - 修复了 `destroy` 方法可能导致的崩溃问题 - 修复了多处内存泄露和多线程问题,提高了系统稳定性 ## 4.4.30 版 [#4430-版-1] 该版本于 2024 年 10 月 24 日发布。 ### 升级必看 [#升级必看-1] #### 日志加密行为变更 [#日志加密行为变更-1] 出于安全性和性能考虑,自该版本起,SDK 对日志进行加密,并且不再支持通过控制台打印明文日志。针对不同的需求,请参考以下解决方案: - 如果需要得知 API 的调用情况,请查看 API 的日志并自行打印 SDK 回调日志。 - 如有其他特殊需求,请[联系技术支持](https://ticket.shengwang.cn/)并附上对应的加密日志。 #### Maven 库名变更 [#maven-库名变更] 该版本将 Maven 库名由 `linux-sdk` 变更为 `linux-java-sdk`,集成时请将项目的 XML 文件代码进行如下修改: - v4.0.1 版本 ```xml io.agora.rtc // highlight-start linux-sdk // highlight-end 4.0.1 ``` - v4.4.30 及以上版本 ```xml io.agora.rtc // highlight-start linux-java-sdk 4.4.30 // highlight-end ``` ### 新增特性 [#新增特性-10] #### 设置音频发送缓冲区 [#设置音频发送缓冲区-1] 在 AI 交互等应用场景中,发送端发送音频帧的频率可能不均匀。如果 SDK 按照实际的发送频率去发送给声网服务器,则接收端可能会有卡顿、丢帧等不良体验。为优化音频传输性能,该版本在 `AgoraLocalAudioTrack` 类中新增了设置音频发送缓冲区的方法: - [`setMaxBufferedAudioFrameNumber`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track#a3e4526e6402becdd5f25573513ce6a36):设置音频发送缓冲区的最大容量。 - [`clearSenderBuffer`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track#a90054e0f30419b0ee2eea512db67f535):清除当前音频发送缓冲区,用于人机对话场景中的音频打断。 - [`setSendDelayMs`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track#ac16dee95915656c401981f1107183370):设置音频发送缓冲区允许发送的最小数据时长,用于精确控制音频传输时延。 #### 添加音频标记 [#添加音频标记-1] 该版本新增了音频标记能力 (`AudioLabel`)。通过添加音频标记,你可以直观地获取到用户的音频能量、基频、语音类型等,方便对音频进行后处理。联系 sales@shengwang.cn 开通并使用该功能。 #### 支持 22050 Hz 音频发送采样率 [#支持-22050-hz-音频发送采样率-1] 该版本支持 22050 Hz 音频发送采样率,你可以在调用 [`AgoraAudioPcmDataSender.send`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-pcm-data-sender#acc86f76c61b53307024b3d768bdc8c13) 方法发送原始音频数据时设置。 #### 设置 SDK 全局定制化参数 [#设置-sdk-全局定制化参数-1] 该版本在 `AgoraService` 类中新增了 [`getAgoraParameter`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service#af776ee9767ecb895b3e7aec2e38d1c0c) 方法。该方法和 `AgoraRtcConn` 类中的 [`getAgoraParameter`](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a4887841b3c2232730440ad6ca3d74570) 方法的区别是: - `AgoraService.getAgoraParameter` 对 SDK 全局有效。 - `AgoraRtcConn.getAgoraParameter` 仅对当前 Connection 有效。 ### 改进 [#改进-8] 该版本进行了如下改进: - 降低了多频道场景下的 CPU 功耗。 - 优化了音频帧回调函数 `onPlaybackAudioFrameBeforeMixing`、`onRecordAudioFrame`、`onPlaybackAudioFrame`、`onMixedAudioFrame` 的内存管理机制,提升了 `AudioFrame` 处理的效率和稳定性。 ### 问题修复 [#问题修复-7] 该版本修复了如下问题: - `onPlaybackAudioFrameBeforeMixing` 回调中 `channelId` 指针为 `null` 导致的问题。 - `onRemoteAudioTrackStatistics`、`onUserAudioTrackSubscribed`、`onUserAudioTrackStateChanged`、`onUserVideoTrackSubscribed`、`onUserVideoTrackStateChanged`、`onRemoteVideoTrackStatistics` 回调偶现的崩溃。 ## 4.0.1 版 [#401-版-1] 该版本于 2023 年 1 月 13 日发布。 ### 新增特性 [#新增特性-11] #### 流消息 [#流消息-1] 为支持在数字人等数字化场景中收发消息,该版本新增流消息功能。发送端可以先后调用 `createDataStream` 和 `sendStreamMessage` 方法创建数据流并发送数据流消息;接收端可以通过 `onStreamMessage` 回调获取已接收的数据。 ## 3.7.200.21 版 [#3720021-版] 该版本于 2022 年 8 月 1 日发布,支持以下功能: - 发送和接收不同格式的音视频数据。 - 相互独立的音视频收发流程。 - 在单进程中运行多个 SDK 实例。 - String 型用户 ID。 - 混音。 - 媒体流加密。 - 云代理。 - 地理区域限制。