# 发版说明 (/zh-CN/realtime-media/rtc-server-sdk/reference/release-notes/cpp) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 4.4.33 版 [#4433-版] 该版本于 2026 年 11 月 03 日发布。 ### 新增特性 [#新增特性] #### 视频 Metadata [#视频-metadata] 该版本支持随视频发送和接收 Metadata。你可以通过 [`ILocalVideoTrack::registerVideoMetadataObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track#a551cacb9f56b75ffd2b4bdf9db721eb4) 注册 [`IMetadataObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer),并通过以下回调设置和接收视频附属信息: - [`getMaxMetadataSize`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer#aa1d7b729f373d985a5bbdd855c4e85d5):设置 Metadata 的最大缓冲区大小,默认值为 512 字节,最大为 1024 字节。 - [`onReadyToSendMetadata`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer#afc9b177f803cc0f0bb18b36c51be84f0):在 SDK 准备发送 Metadata 时填入数据和大小。 - [`onMetadataReceived`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer#a890f087351519bdeba5f17e824158d03):接收远端用户发送的 Metadata。 不再需要监听时,调用 [`unregisterVideoMetadataObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track#a46680142338456fb129a1e7fe9ac0aba) 注销观测器。详见[发送和接收视频 Metadata](/zh-CN/realtime-media/rtc-server-sdk/build/video-metadata)。 新增的注册和注销接口均提供默认实现,默认返回 `0`。 #### 服务配置路径和参数入口 [#服务配置路径和参数入口] [`AgoraServiceConfiguration`](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1base-1-1-agora-service-configuration) 提供以下配置字段,默认值均为 `NULL`: - [`configDir`](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1base-1-1-agora-service-configuration#a77320f26cea585d9795b45496483ca9a):配置文件目录。为 `NULL` 时,使用 SDK 默认配置目录。 - [`dataDir`](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1base-1-1-agora-service-configuration#a3c772897c7f42b84d3b061f0c571cc59):数据文件目录。为 `NULL` 时,使用 SDK 默认数据目录。 - [`parameters`](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1base-1-1-agora-service-configuration#af1554e9a7042aba783dd366740341bfd):本版本新增,支持在初始化时通过 JSON 字符串配置 SDK,用于技术预览功能或特殊定制。请在技术支持指导下配置。 #### 获取 NTP 时间 [#获取-ntp-时间] 该版本新增 [`IAgoraService::getNtpWallTimeInMs`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1base-1-1-i-agora-service#a96496d23dd3aac1eae15e630fa714f37),用于获取以毫秒为单位的 Unix 时间戳。NTP 服务不可用时,该方法返回 `0`。 ### 问题修复 [#问题修复] - 修复了 Token 中包含未知 service type 时,有概率导致 SDK 崩溃的问题。 - 修复了创建连接后立即销毁时,服务端有概率无法及时感知用户退出的问题。 - 修复了开启内容加密后,无法使用 String 型用户 ID 的问题。 - 修复了音频 IO 线程和播放线程并发访问有概率导致 SDK 崩溃的问题。 - 修复了使用 String 型用户 ID 时的音画不同步问题。 - 修复了音频立体声场景下,弱网环境中有概率出现杂音的问题。 ## 4.4.32 版 [#4432-版] 该版本于 2025 年 4 月 28 日发布。 ### 改进 [#改进] - 提高了 SDK 在收发 PCM 音频流时的并发性能。 ### 问题修复 [#问题修复-1] - 修复了特定场景下可能出现的色差问题。 - 修复了偶现的 App 崩溃和内存泄漏问题。 ## 4.4.30 版 [#4430-版] 该版本于 2024 年 10 月 24 日发布。 ### 升级必看 [#升级必看] #### 日志加密行为变更 [#日志加密行为变更] 出于安全性和性能考虑,自该版本起,SDK 对日志进行加密,并且不再支持通过控制台打印明文日志。针对不同的需求,请参考以下解决方案: - 如果需要得知 API 的调用情况,请查看 API 的日志并自行打印 SDK 回调日志。 - 如有其他特殊需求,请[联系技术支持](https://ticket.shengwang.cn/)并附上对应的加密日志。 ### 新增特性 [#新增特性-1] #### 设置音频发送缓冲区 [#设置音频发送缓冲区] 在 AI 交互等应用场景中,发送端发送音频帧的频率可能不均匀。如果 SDK 按照实际的发送频率去发送给声网服务器,则接收端可能会有卡顿、丢帧等不良体验。为优化音频传输性能,该版本在 `ILocalAudioTrack` 类中新增了设置音频发送缓冲区的方法: - [`setMaxBufferedAudioFrameNumber`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track#a0f1adbf17ef048ba5c10d5dbbb4f8631):设置音频发送缓冲区的最大容量。 - [`ClearSenderBuffer`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track#a8e1c4f96b49e21c972e15344642453ec):清除当前音频发送缓冲区,用于人机对话场景中的音频打断。 - [`setAudioFrameSendDelayMs`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track#a6f315590feb863960f7959ec7946890d):设置音频发送缓冲区允许发送的最小数据时长,用于精确控制音频传输时延。 #### 添加音频标记 [#添加音频标记] 该版本新增了音频标记能力 (`AudioLabel`)。通过添加音频标记,你可以直观地获取到用户的音频能量、基频、语音类型等,方便对音频进行后处理。联系 sales@shengwang.cn 开通并使用该功能。 #### 支持 22050 Hz 音频发送采样率 [#支持-22050-hz-音频发送采样率] 该版本支持 22050 Hz 音频发送采样率,你可以在调用 [`sendAudioPcmData`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-audio-pcm-data-sender#a4d9b47199892e4f9d06abf7673f1fd12) 方法发送原始音频数据时设置。 #### 设置 SDK 全局定制化参数 [#设置-sdk-全局定制化参数] 该版本在 `IAgoraService` 类中新增了 [`getAgoraParameter`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1base-1-1-i-agora-service#a97df07f6f57f0d5b00e52a70065f1804) 方法。该方法和 `IRtcConnection` 类中的 [`getAgoraParameter`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection#af6f657c7f744cac441f1a5518b84ce42) 方法的区别是: - `IAgoraService::getAgoraParameter` 对 SDK 全局有效。 - `IRtcConnection::getAgoraParameter` 仅对当前 Connection 有效。 ### 改进 [#改进-1] 该版本降低了多频道场景下的 CPU 功耗。 ### 问题修复 [#问题修复-2] 该版本修复了 `onPlaybackAudioFrameBeforeMixing` 回调中 `channelId` 指针为 `null` 导致的问题。 ## 4.2.32 版 [#4232-版] 该版本于 2024 年 8 月 29 日发布。 ### 改进 [#改进-2] 该版本提升了 FFmpeg 库在解码 H.264 和 H.265 视频数据时的效率和性能,改善用户观看体验。 ### 问题修复 [#问题修复-3] 该版本修复了 socket 文件描述符泄漏的问题,确保网络连接资源能够被正确管理。 ## 4.2.31 版 [#4231-版] 该版本于 2024 年 3 月 28 日发布。 ### 新增特性 [#新增特性-2] 该版本新增音频多声道编解码功能,你可以至多设置 8 声道,获得更丰富、更立体的音频效果。联系 sales@shengwang.cn 开通并使用该功能。 ## 4.2.30 版 [#4230-版] 该版本于 2024 年 2 月 4 日发布。 ### 新增特性 [#新增特性-3] #### 多路径网络传输 [#多路径网络传输] 该版本新增多路径(Multipath)网络传输功能,能够同时使用多条网络路径传输音视频流。例如,当你在设备端插入两张物联网卡时,SDK 可以同时使用两张物联网卡传输音视频流,从而提升音视频传输的稳定性和可靠性。联系 sales@shengwang.cn 开通并使用该功能。 #### 硬件编码加速 [#硬件编码加速] 该版本具备与 NVIDIA GPU 协同工作的能力,可以利用 GPU 的硬件加速功能来执行视频编码任务,从而减轻 CPU 的负担、提高硬件编码的效率和性能。联系 sales@shengwang.cn 开通并使用该功能。 #### 本地代理设置 [#本地代理设置] 该版本新增 `SetLocalAccessPoint` 方法,用于在成功部署声网混合云、私有化平台后,指定 Local Access Point 来设置本地代理。你可以联系 sales@shengwang.cn 了解和部署声网混合云或声网私有化平台。 ### 改进 [#改进-3] #### 音频发送时间戳 [#音频发送时间戳] 该版本在 `sendAudioPcmData` 方法中新增 `presentation_ms` 参数,用于设置音频数据的发送时间戳。在视频会议、远程协作等场景中,你可以通过该参数提升音画同步的准确性。 ### 问题修复 [#问题修复-4] 该版本修复了以下问题: - 接收 H.264 视频裸数据导致的 App 内存增长。 - 同时使用 String 型用户 ID 和数据流功能的情况下,接收到的数据流出现乱码。 ## 4.0.1 版 [#401-版] 该版本于 2022 年 12 月 27 日发布。 ### 新增特性 [#新增特性-4] #### 直推 CDN [#直推-cdn] 该版本新增直推 CDN 功能,能将主播的音视频流由声网私有协议转换为 RTMP 标准协议,然后推到 CDN;CDN 观众点击对应的 URL 即可观看直播。该版本提供 `IRtmpConnection` 类和 `IRtmpLocalUser` 类,你可以建立 SDK 与 CDN 的连接、设置音视频流的编码属性并推流到 CDN。如需了解 SDK 与 CDN 的连接状态、音视频流的推送状态,你还可以注册 `IRtmpConnectionObserver` 和 `IRtmpLocalUserObserver` 对象,监听相关回调。 #### 流消息 [#流消息] 为支持在数字人等数字化场景中收发消息,该版本新增流消息功能。发送端可以先后调用 `createDataStream` 和 `sendStreamMessage` 方法创建数据流并发送数据流消息;接收端可以通过 `onStreamMessage` 回调获取已接收的数据。 ### 改进 [#改进-4] #### 自渲染视频背景 [#自渲染视频背景] 为增添音视频互动的趣味性,本地用户有时会想要将远端用户的背景修改为符合自己喜好的背景。为满足这类需求,该版本在 `ExternalVideoFrame` 类中增加了 `alphaBuffer` 参数,在自定义视频渲染场景下,该参数可帮助用户将视频背景在本地渲染为各种效果,例如:透明、纯色、图片、视频等等。对同一远端用户,不同用户可以在本地渲染不同的视频背景,互不影响。 :::info[信息] 如需使用该功能,[联系技术支持](https://ticket.shengwang.cn)。 ::: #### 监测音频体验质量 [#监测音频体验质量] 该版本在 `RemoteAudioTrackStats` 中新增 `qoe_quality` 和 `quality_changed_reason` 参数,可以监测本地用户在接收远端音频时的主观体验质量以及造成主观体验质量较差的原因。 #### 会议场景 [#会议场景] 为提升多人会议的音频体验,该版本在 `AUDIO_SCENARIO_TYPE` 中新增 `AUDIO_SCENARIO_MEETING(8)`。 #### 物联网卡域名限制 [#物联网卡域名限制] 有些对安全性要求高的场景会使用定向物联网卡,并限制物联网卡可以访问的网络域名。该版本在 `AgoraServiceConfiguration` 中新增 `domainLimit` 参数,你可以通过该参数开启域名限制,使 SDK 仅访问指定域名的网络,从而保证使用定向物联网卡的设备与其他设备互通。 :::info[信息] 如需使用该功能,[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 3.8.202.20 版 [#3820220-版] 该版本于 2022 年 6 月 27 日发布。 ### 新增特性 [#新增特性-5] #### 合图 [#合图] 你可以通过 `IVideoMixerSource` 类实现合图功能。详见[合图](/zh-CN/realtime-media/rtc-server-sdk/build/mix-video)。 #### 加密 [#加密] 媒体流加密新增以下模式: - AES_128_ECB - AES_128_XTS - AES_256_XTS - AES-128-GCM - AES-256-GCM - AES-128-GCM2(推荐) - AES-256-GCM2(推荐) 详见[媒体流加密](/zh-CN/realtime-media/rtc-server-sdk/build/encryption)。 #### 云代理 [#云代理] 云代理新增了 Force UDP 云代理模式和 Force TCP 云代理模式。详见[云代理](/zh-CN/realtime-media/rtc-server-sdk/build/cloud-proxy)。 ## 3.7.200.20 版 [#3720020-版] 该版本于 2022 年 4 月 26 日发布。 ### 改进 [#改进-5] - 根据产品定位对 API 进行了精简,剔除了无用接口。 - 支持 128 人功能,即单个频道可支持最多 128 位主播同时在线并同时发布音视频流。 - 优化了 SDK 性能。 - 修复了一些问题。 - 提高了接收视频裸数据 API 的易用性。 - 优化了快速开始等开发者指南文档。 - 新增关于区域访问限制、 String 型用户 ID 等开发者指南文档 。 ## 3.4.236 版 [#34236-版] 该版本于 2021 年 12 月 17 日发布。主要提升了 SDK 的稳定性。 ## 3.4.217 版 [#34217-版] 该版本于 2021 年 8 月 11 日发布。 ### 改进 [#改进-6] - 优化了使用云代理进行多频道推流时的稳定性。 - 优化特定的 iOS(iPhone)设备端硬编码 h264 推流的体验。 ## 3.4.211 版 [#34211-版] 该版本于 2021 年 7 月 9 日发布。 ### 新增特性 [#新增特性-6] #### 支持发送 YUV 视频 [#支持发送-yuv-视频] 支持使用 Intel、NVIDIA 硬件编码,提升编码性能。具体的 API 调用请参考 `sample_send_yuv_hw.cpp`。 相关 API 为: - `agoraParameter->setString(KEY_RTC_VIDEO_ENABLED_HW_ENCODER, "true");` - `agoraParameter->setString(KEY_RTC_VIDEO_HW_ENCODER_PROVIDER, "your provider");` ```shell tab="NVIDIA" tabGroup="codec" sudo apt update sudo ubuntu-drivers devices sudo ubuntu-drivers install sudo reboot sudo nvidia-smi ``` ```shell tab="Intel" tabGroup="codec" wget https://github.com/Intel-Media-SDK/MediaSDK/releases/download/intel-mediasdk-21.1.3/MediaStack.tar.gz tar -zxf MediaStack.tar.gz chmod +x ./MediaStack/install_media.sh ./MediaStack/install_media.sh ``` #### 支持 IPv6 [#支持-ipv6] 该版本新增支持 IPv6。 ### API 变更 [#api-变更] - 新增如下枚举值用以设置 PCM 数据的位宽。 ```cpp enum BYTES_PER_SAMPLE { /** * two bytes per sample */ TWO_BYTES_PER_SAMPLE = 2, }; ``` - 新增如下回调函数,用于获取返回远端视频流的状态。 ```cpp ILocalUserObserver::onRemoteVideoStreamInfoUpdated(const agora::rtc::RemoteVideoStreamInfo& info) ``` ## 3.3.206 版 [#33206-版] 该版本于 2021 年 4 月 2 日发布。 ### 新增特性 [#新增特性-7] 该版本新增支持区域访问限制。通过在 `AgoraServiceConfiguration` 结构体中增加 `areaCode` 字段实现。具体的配置方法可以查看 `AgoraBase.h` 文件中的 `AREA_CODE` 枚举类。 ### 问题修复 [#问题修复-5] 该版本修复了发送 H.264 格式的视频数据时,水晶球中显示的分辨率不准确的问题。 ## 3.3.201 版 [#33201-版] 该版本于 2021 年 1 月 8 日发布。 ### 新增特性 [#新增特性-8] 新增支持媒体附属信息(metadata)接口。 ## 3.3.200 版 [#33200-版] 该版本于 2020 年 12 月 25 日发布。本次发版为声网服务端 SDK 的第一次发版,主要包括以下功能: - 发送和接收多种格式的音视频数据。 - 可同时发送和接收媒体流、仅发送或仅接收媒体流、音频和视频的发送和接收相互独立。 - 同时针对多个频道发送或接收媒体流。 - 支持使用 string 型 UID 加入频道。 - 支持接收频道内指定 UID 的流。 - 支持将接收的多路音频流进行混音。 - 支持 128 位国密 SM4 加密,ECB 模式。 - 支持云代理服务。用户只需要在防火墙上将特定的 IP 及端口列入白名单,就可以实现内网访问声网服务。