From a75422fc356a4f457cd7bf78de2266449b832c67 Mon Sep 17 00:00:00 2001
From: Suri539
Date: Mon, 4 Nov 2024 18:10:28 +0800
Subject: [PATCH] update release notes and add android only methods
---
.../config/keys-rtc-ng-links-android.ditamap | 14 +++++
dita/RTC-NG/release/release_notes.dita | 52 +++++++++----------
2 files changed, 38 insertions(+), 28 deletions(-)
diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap
index 15eab2386c8..8449ddbc3a5 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap
@@ -108,6 +108,13 @@
+
+
+
+ 秀场直播
+
+
+
@@ -167,5 +174,12 @@
+
+
+
+ Support 16 KB page sizes
+
+
+
diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita
index 1fbf0c30a0e..ddb19b0e60c 100644
--- a/dita/RTC-NG/release/release_notes.dita
+++ b/dita/RTC-NG/release/release_notes.dita
@@ -3,7 +3,7 @@
v4.5.0
- 该版本于 2034 年 11 月 x 日发布。
+ 该版本于 2024 年 11 月 x 日发布。
@@ -58,15 +58,16 @@
- 自动安装虚拟声卡
+ 自动安装虚拟声卡 (macOS)
自该版本起,SDK 支持自动安装虚拟声卡功能,当你第一次调用 时,SDK 会自动安装内置的声网自研虚拟声卡 AgoraALD。安装成功后,音频路由会自动切换为虚拟声卡,同时使用虚拟声卡进行采集。
强效视频降噪实现变更
该版本调整了强效视频降噪的实现方式,在 中删除了 ,改为调用 启用视频降噪后,调用 方法启用美颜磨皮功能,二者搭配使用以获得更好的视频降噪效果。实现强效降噪时,推荐磨皮参数设置详见
此外,受该调整影响,实现画质优先的暗光增强效果时,需要先开启视频降噪并采用特定设置,详见
- 摄像头插拔状态变更 (macOS, Windows)
-
+ 摄像头插拔状态变更 (macOS, Windows)
+ 在之前版本中,当摄像头拔出并重新插入时, 回调会将设备状态报告为 (1)(设备正在使用)。该版本起,摄像头重新插入后,设备状态将改为 (0)(设备就绪)。
+ 在之前版本中,摄像头拔出并重新插入后不会自动恢复采集。该版本起,摄像头重新插入后将自动恢复采集。
视频编码偏好变更
为提升用户的视频互动体验,该版本优化了视频编码时的默认偏好:
@@ -76,7 +77,7 @@
16 KB 内存页大小 (Android)
-
+ 自 Android 15 起,系统新增了对 16 KB 内存页大小的支持,详见 。为了保证 App 的稳定性和性能表现,自该版本起,SDK 支持 16 KB 内存页大小,确保可以在使用 4 KB 和 16 KB 内存页大小的设备上无缝运行,提升兼容性并避免崩溃。
- - 高级美颜
-
- - 秀场直播场景
-
-
- 高级美颜
该版本新增以下两种高级美颜功能:
@@ -103,12 +96,17 @@
目前,高级美颜功能为限时免费,详见。
+ - 秀场直播场景
+
该版本在 类下新增枚举 (3)(秀场直播),你可以调用 将视频业务场景设置为。针对该场景对首帧出图时间和画质清晰度的高要求,SDK 进行了策略调优,重点提升了首帧出图体验和画质表现,同时增强了在弱网环境和低端设备上的画质和流畅度表现。
+
- 限制视频渲染帧率
该版本新增 和 方法,支持设置视频在本地和远端渲染时的最大帧率,SDK 进行视频渲染的实际帧率会尽量接近该值。
在对视频渲染帧率要求不高的场景(例如:屏幕共享、在线教育)或者远端使用中低端设备的场景下,你可以通过这一组方法限制视频渲染帧率,从而减小 CPU 消耗、提升系统性能。
- URL 拉流播放
-
+
URL 拉流播放功能主要用于直播场景,观众端可以直接通过 OpenWithUrl 打开特定的 URL 来播放实时媒体流,无需加入频道、订阅等步骤,极大简化了观众端观看直播流的 API 调用。
+ 在播放的过程中,观众端可以通过 设置订阅视频大小流,并可以在大小流之间实现平滑切换。如果对视频体验有更高要求,可以联系开通 ABR(Adaptive Bitrate,自适应码率)功能。启用该功能后,可以自定义不同层级的视频流分辨率,观众可以实现不同分辨率视频流的平滑切换。
+ 当网络情况不稳定时,观众端可以调用 来设置订阅的视频流的回退选项。SDK 会以你指定的最低质量层级对应的视频流分辨率为下限,在此范围内根据网络状况动态调整分辨率。有关该功能的实现步骤,详见 。
- 滤镜效果
@@ -127,17 +125,16 @@
如果你具备自行申请 MediaProjection 的开发能力,可通过该功能实现更加灵活的屏幕采集。有关具体实现方法,详见《屏幕共享》。
- EGL 环境上下文 (Android)
-
+
该版本新增了 方法,用于设置远端视频流渲染的 EGL 环境上下文。使用 Texture 格式的视频数据进行远端视频自渲染时,你可以通过该方法替换 SDK 默认的远端 EGL 环境上下文,实现统一的 EGL 上下文管理。
- 色彩空间设置
-
-
- -
-
+
该版本在 中新增了 和 ,你可以通过 获取视频帧的色彩空间属性,并通过 对其进行自定义设置。默认情况下,色彩空间采用 Full Range 和 BT.709 标准配置,开发者可以根据自采集或自渲染的需求灵活调整,进一步提升视频处理的定制化能力。
+ 该版本在 和 中新增了 colorSpace,你可以通过该参数设置视频帧的色彩空间属性。默认情况下,色彩空间采用 Full Range 和 BT.709 标准配置,你可以根据自采集或自渲染的需求灵活调整,进一步提升视频处理的定制化能力。
- 其他
- 回调新增 枚举,表示当前正在使用的视频采集设备已经断开连接(例如,被拔出)。(Windows)
+ - 新增 枚举,表示设备已插入。