该版本于 2022 年 12 月 27 日发布。
1. 旁路推流
该版本新增旁路推流功能,能将主播的音视频流由声网私有协议转换为 RTMP 标准协议,然后推到 CDN;CDN 观众点击对应的 URL 即可观看直播。该版本提供 IRtmpConnection
类和 IRtmpLocalUser
类,你可以建立 SDK 与 CDN 的连接、设置音视频流的编码属性并推流到 CDN。如需了解 SDK 与 CDN 的连接状态、音视频流的推送状态,你还可以注册 IRtmpConnectionObserver
和 IRtmpLocalUserObserver
对象,监听相关回调。
2. 流消息
为支持在数字人等数字化场景中收发消息,该版本新增流消息功能。发送端可以先后调用 createDataStream
和 sendStreamMessage
方法创建数据流并发送数据流消息;接收端可以通过 onStreamMessage
回调获取已接收的数据。
1. 自渲染视频背景
为增添音视频互动的趣味性,本地用户有时会想要将远端用户的背景修改为符合自己喜好的背景。为满足这类需求,该版本在 ExternalVideoFrame
类中增加了 alphaBuffer
参数,在自定义视频渲染场景下,该参数可帮助用户将视频背景在本地渲染为各种效果,例如:透明、纯色、图片、视频等等。对同一远端用户,不同用户可以在本地渲染不同的视频背景,互不影响。
2. 监测音频体验质量
该版本在 RemoteAudioTrackStats
中新增 qoe_quality
和 quality_changed_reason
参数,可以监测本地用户在接收远端音频时的主观体验质量以及造成主观体验质量较差的原因。
3. 会议场景
为提升多人会议的音频体验,该版本在 AUDIO_SCENARIO_TYPE
中新增 AUDIO_SCENARIO_MEETING(8)
。
4. 物联网卡域名限制
有些对安全性要求高的场景会使用定向物联网卡,并限制物联网卡可以访问的网络域名。该版本在 AgoraServiceConfiguration
中新增 domainLimit
参数,你可以通过该参数开启域名限制,使 SDK 仅访问指定域名的网络,从而保证使用定向物联网卡的设备与其他设备互通。
该版本于 2022 年 6 月 27 日发布。新增如下特性:
合图
你可以通过 IVideoMixerSource
类实现合图功能。详见合图。
加密
媒体流加密新增以下模式:
详见媒体流加密。
云代理
云代理新增了Force UDP 云代理模式和 Force UDP 云代理模式。详见云代理。
该版本于 2022 年 4 月 26 日发布。进行了如下优化:
该版本于 2021 年 12 月 17 日发布。主要提升了 SDK 的稳定性。
该版本于 2021 年 8 月 11 日发布。进行了如下优化:
该版本于 2021 年 7 月 9 日发布。
新增功能
支持发送 YUV 视频。支持使用 Intel、Nvdia 硬件编码,提升编码性能。
对于硬件编码,需要参考如下命令配置环境:
NVIDIA:
sudo apt update
sudo ubuntu-drivers devices
sudo ubuntu-drivers install
sudo reboot
sudo nvidia-smi
Intel:
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
相关API为:
agoraParameter->setString(KEY_RTC_VIDEO_ENABLED_HW_ENCODER, "true");
agoraParameter->setString(KEY_RTC_VIDEO_HW_ENCODER_PROVIDER, "your provider");
当前支持 NVIDIA 以及 Intel(集成显卡)的硬件编码加速,具体的 API 调用请参考 sample_send_yuv_hw.cpp
。
API变更
enum BYTES_PER_SAMPLE {
/**
* two bytes per sample
*/
TWO_BYTES_PER_SAMPLE = 2,
};
ILocalUserObserver::onRemoteVideoStreamInfoUpdated(const agora::rtc::RemoteVideoStreamInfo& info)
该版本于 2021 年 4 月 2 日发布。
该版本新增支持区域访问限制。通过在 AgoraServiceConfiguration
结构体中增加 areaCode
字段实现。具体的配置方法可以查看 AgoraBase.h
文件中的 AREA_CODE
枚举类。
该版本还修复了发送 H.264 格式的视频数据时,水晶球中显示的分辨率不准确的问题。
该版本于 2021 年 1 月 8 日发布。新增支持媒体附属信息(metadata)接口。
该版本于 2020 年 12 月 25 日发布。本次发版为声网 Linux SDK 的第一次发版,主要包括以下功能: