From cb090132c6023dc695cc034b7b57380905147f73 Mon Sep 17 00:00:00 2001
From: Cilla-luodan
Date: Mon, 11 Sep 2023 03:52:27 +0000
Subject: [PATCH 01/47] Sync cn prototype to en prototype
---
en-US/dita/RTC-NG/API/api_ibasespatialaudioengine_release.dita | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/en-US/dita/RTC-NG/API/api_ibasespatialaudioengine_release.dita b/en-US/dita/RTC-NG/API/api_ibasespatialaudioengine_release.dita
index 1d9cbd1a770..31a4a1635cb 100644
--- a/en-US/dita/RTC-NG/API/api_ibasespatialaudioengine_release.dita
+++ b/en-US/dita/RTC-NG/API/api_ibasespatialaudioengine_release.dita
@@ -14,7 +14,7 @@
-
+ + (void)destroy NS_SWIFT_NAME(destroy());
virtual void release() = 0;
abstract release(): void;
abstract release(): void;
From 32a0b0dfad5f183f76be7991759cb1910bd46e14 Mon Sep 17 00:00:00 2001
From: Cilla-luodan
Date: Tue, 12 Sep 2023 18:12:36 +0800
Subject: [PATCH 02/47] add
---
dita/RTC-NG/API/class_externalvideoframe.dita | 101 ++++++++++--------
.../API/enum_localaudiostreamerror.dita | 4 +-
.../API/enum_localvideostreamerror.dita | 24 +++++
dita/RTC-NG/API/enum_videopixelformat.dita | 4 +
.../RTC-NG/config/keys-rtc-ng-api-cpp.ditamap | 49 +++++++++
.../config/keys-rtc-ng-api-macos.ditamap | 7 ++
6 files changed, 143 insertions(+), 46 deletions(-)
diff --git a/dita/RTC-NG/API/class_externalvideoframe.dita b/dita/RTC-NG/API/class_externalvideoframe.dita
index c9562c79cff..e8ea9e8c11c 100644
--- a/dita/RTC-NG/API/class_externalvideoframe.dita
+++ b/dita/RTC-NG/API/class_externalvideoframe.dita
@@ -50,49 +50,54 @@
@property(assign, nonatomic) int rotation;
@end
struct ExternalVideoFrame {
- ExternalVideoFrame()
- : type(VIDEO_BUFFER_RAW_DATA),
- format(VIDEO_PIXEL_DEFAULT),
- buffer(NULL),
- stride(0),
- height(0),
- cropLeft(0),
- cropTop(0),
- cropRight(0),
- cropBottom(0),
- rotation(0),
- timestamp(0),
- eglContext(NULL),
- eglType(EGL_CONTEXT10),
- textureId(0),
- metadata_buffer(NULL),
- metadata_size(0){}
- enum EGL_CONTEXT_TYPE {
- EGL_CONTEXT10 = 0,
- EGL_CONTEXT14 = 1,
- };
- enum VIDEO_BUFFER_TYPE {
- VIDEO_BUFFER_RAW_DATA = 1,
- VIDEO_BUFFER_ARRAY = 2,
- VIDEO_BUFFER_TEXTURE = 3,
- };
- VIDEO_BUFFER_TYPE type;
- VIDEO_PIXEL_FORMAT format;
- void* buffer;
- int stride;
- int height;
- int cropLeft;
- int cropTop;
- int cropRight;
- int cropBottom;
- int rotation;
- long long timestamp;
- void *eglContext;
- EGL_CONTEXT_TYPE eglType;
- int textureId;
- uint8_t* metadata_buffer;
- int metadata_size;
- };
+ ExternalVideoFrame()
+ : type(VIDEO_BUFFER_RAW_DATA),
+ format(VIDEO_PIXEL_DEFAULT),
+ buffer(NULL),
+ stride(0),
+ height(0),
+ cropLeft(0),
+ cropTop(0),
+ cropRight(0),
+ cropBottom(0),
+ rotation(0),
+ timestamp(0),
+ eglContext(NULL),
+ eglType(EGL_CONTEXT10),
+ textureId(0),
+ metadata_buffer(NULL),
+ metadata_size(0),
+ d3d11_texture_2d(NULL),
+ texture_slice_index(0){}
+ enum EGL_CONTEXT_TYPE {
+ EGL_CONTEXT10 = 0,
+ EGL_CONTEXT14 = 1,
+ };
+ enum VIDEO_BUFFER_TYPE {
+ VIDEO_BUFFER_RAW_DATA = 1,
+ VIDEO_BUFFER_ARRAY = 2,
+ VIDEO_BUFFER_TEXTURE = 3,
+ };
+ VIDEO_BUFFER_TYPE type;
+ VIDEO_PIXEL_FORMAT format;
+ void* buffer;
+ int stride;
+ int height;
+ int cropLeft;
+ int cropTop;
+ int cropRight;
+ int cropBottom;
+ int rotation;
+ long long timestamp;
+ void *eglContext;
+ EGL_CONTEXT_TYPE eglType;
+ int textureId;
+ float matrix[16];
+ uint8_t* metadata_buffer;
+ int metadata_size;
+ void *d3d11_texture_2d;
+ int texture_slice_index;
+};
export class ExternalVideoFrame {
type?: VideoBufferType;
format?: VideoPixelFormat;
@@ -401,6 +406,14 @@
metadataSize
该参数仅适用于 Texture 格式的视频数据。指 MetaData 的大小,默认值为 0。
+
+ *d3d11_texture_2d
+ 该参数仅适用于 Windows Texture 格式的视频数据。为一个指向 ID3D11Texture2D 类型对象的指针,该类型对象被视频帧所使用。
+
+
+ texture_slice_index
+ 该参数仅适用于 Windows Texture 格式的视频数据。表示在 ID3D11Texture2D 数组中,被视频帧使用的某一个 ID3D11Texture2D 纹理对象的索引。
+
cropLeft
原始数据相关字段。指定左边裁剪掉的像素数量。默认为 0。
@@ -415,7 +428,7 @@
cropRight
- 原始数据相关字段。指定右边裁剪掉的像素数量。默认为 0。
+ 原始数据相关字段。指定右边裁剪掉的像素数量。默认为 0。
该参数仅适用于非 Texture 格式的视频数据。
该参数仅适用于原始视频数据。
diff --git a/dita/RTC-NG/API/enum_localaudiostreamerror.dita b/dita/RTC-NG/API/enum_localaudiostreamerror.dita
index 8eb2eafab09..fd4c29e71e1 100644
--- a/dita/RTC-NG/API/enum_localaudiostreamerror.dita
+++ b/dita/RTC-NG/API/enum_localaudiostreamerror.dita
@@ -46,9 +46,9 @@
7:(仅适用于 Windows)无本地音频播放设备。请提示用户在设备的控制面板中检查扬声器是否与设备连接正常,检查扬声器是否正常工作。
-
+
- 8:(仅适用于 Android 和 iOS)本地音频采集被系统来电、Siri、闹钟中断。如需恢复本地音频采集,请用户中止电话、Siri、闹钟。
+ 8:(仅适用于 Android 和 iOS)本地音频采集被系统来电、Siri、闹钟中断。如需恢复本地音频采集,请用户中止电话、Siri、闹钟。
预留。
diff --git a/dita/RTC-NG/API/enum_localvideostreamerror.dita b/dita/RTC-NG/API/enum_localvideostreamerror.dita
index ee42338e33f..1f287f82738 100644
--- a/dita/RTC-NG/API/enum_localvideostreamerror.dita
+++ b/dita/RTC-NG/API/enum_localvideostreamerror.dita
@@ -90,6 +90,30 @@
21:(仅适用于 Windows)当前采集的窗口无数据。
+
+
+ 22:(仅适用于 Windows)不具备采集屏幕的权限。
+
+
+
+ 23:(仅适用于 Windows)屏幕采集已暂停。报告该错误码的常见场景:该屏幕已切换到安全桌面,例如 UAC 对话框,或者 Winlogon 桌面。
+
+
+
+ 24:(仅适用于 Windows)屏幕采集已从暂停状态中恢复。
+
+
+
+ 25:(仅适用于 Windows)当前屏幕采集的窗口处于隐藏状态,并且在当前屏幕上不可见。
+
+
+
+ 26:(仅适用于 Windows)进行屏幕采集的窗口已经从隐藏状态中恢复。
+
+
+
+ 27:(仅适用于 Windows)进行屏幕采集的窗口已经从最小化状态中恢复。
+
101:由于系统压力过大,导致当前视频采集设备不可用。
diff --git a/dita/RTC-NG/API/enum_videopixelformat.dita b/dita/RTC-NG/API/enum_videopixelformat.dita
index f889a3a9bc1..51933533039 100644
--- a/dita/RTC-NG/API/enum_videopixelformat.dita
+++ b/dita/RTC-NG/API/enum_videopixelformat.dita
@@ -60,6 +60,10 @@
16: I422 格式。
+
+
+ 17: ID3D11TEXTURE2D 格式。目前支持的类型有 DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_B8G8R8A8_TYPELESS, DXGI_FORMAT_NV12。
+
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
index 10497616e20..990aa48c7a1 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
@@ -9144,6 +9144,48 @@
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_NO_PERMISSION
+
+
+
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED
+
+
+
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED
+
+
+
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_HIDDEN
+
+
+
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_RECOVER_FROM_HIDDEN
+
+
+
+
+
+
+ LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_RECOVER_FROM_MINIMIZED
+
+
+
@@ -12077,6 +12119,13 @@
+
+
+
+ VIDEO_TEXTURE_ID3D11TEXTURE2D
+
+
+
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
index c8b44dce985..aa3160496b1 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
@@ -8120,6 +8120,13 @@
+
+
+
+ AgoraLocalVideoStreamErrorScreenCaptureNoPermission
+
+
+
From 85c5b394668daf92ccb42c0999b274e03f11be19 Mon Sep 17 00:00:00 2001
From: Cilla-luodan
Date: Wed, 13 Sep 2023 12:07:52 +0800
Subject: [PATCH 03/47] 1
---
dita/RTC-NG/API/enum_localvideostreamerror.dita | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/dita/RTC-NG/API/enum_localvideostreamerror.dita b/dita/RTC-NG/API/enum_localvideostreamerror.dita
index 1f287f82738..ca4bebc4568 100644
--- a/dita/RTC-NG/API/enum_localvideostreamerror.dita
+++ b/dita/RTC-NG/API/enum_localvideostreamerror.dita
@@ -92,7 +92,7 @@
- 22:(仅适用于 Windows)不具备采集屏幕的权限。
+ 22:(仅适用于 Windows 和 macOS)不具备采集屏幕的权限。
From 0fdddef2fb3f8ea3bbadced24888ff4659922446 Mon Sep 17 00:00:00 2001
From: Cilla-luodan
Date: Tue, 12 Sep 2023 13:14:13 +0800
Subject: [PATCH 04/47] fix codeph+xref keref format
---
.../API/api_icloudspatialaudioengine_initialize.dita | 2 +-
.../API/api_ilocalspatialaudioengine_initialize.dita | 2 +-
...api_imediaengine_registervideoencodedframeobserver.dita | 2 +-
.../API/api_irtcengine_adjustaudiomixingplayoutvolume.dita | 2 +-
.../API/api_irtcengine_adjustaudiomixingpublishvolume.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita | 2 +-
.../API/api_irtcengine_getaudiomixingcurrentposition.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_getaudiomixingduration.dita | 2 +-
.../API/api_irtcengine_getaudiomixingplayoutvolume.dita | 2 +-
.../API/api_irtcengine_getaudiomixingpublishvolume.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_getaudiotrackcount.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_pullaudioframe2.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_selectaudiotrack.dita | 2 +-
.../API/api_irtcengine_setaudiomixingdualmonomode.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setaudiomixingpitch.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setaudiomixingposition.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setaudioprofile.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setclientrole.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_setcloudproxy.dita | 4 ++--
dita/RTC-NG/API/api_irtcengine_setdualstreammode.dita | 4 ++--
.../api_irtcengine_setremotedefaultvideostreamtype.dita | 2 +-
.../API/api_irtcengine_setremotevideostreamtype.dita | 2 +-
.../API/api_irtcengine_setrouteincommunicationmode.dita | 2 +-
dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita | 2 +-
.../RTC-NG/API/api_irtcengine_updatechannelmediarelay.dita | 2 +-
dita/RTC-NG/API/api_irtcengineex_setdualstreammodeex.dita | 4 ++--
.../API/api_irtcengineex_setremotevideostreamtypeex.dita | 2 +-
.../API/api_irtcengineex_updatechannelmediarelayex.dita | 2 +-
.../callback_irtcengineeventhandler_onextensionerror.dita | 2 +-
...callback_irtcengineeventhandler_onextensionstarted.dita | 2 +-
...callback_irtcengineeventhandler_onextensionstopped.dita | 2 +-
...lback_irtcengineeventhandler_onfacepositionchanged.dita | 2 +-
...engineeventhandler_onfirstlocalaudioframepublished.dita | 2 +-
dita/RTC-NG/API/rtc_api_overview_ng.dita | 2 +-
dita/RTC-NG/config/keys-rtc-ng-links.ditamap | 7 +++++++
36 files changed, 45 insertions(+), 38 deletions(-)
diff --git a/dita/RTC-NG/API/api_icloudspatialaudioengine_initialize.dita b/dita/RTC-NG/API/api_icloudspatialaudioengine_initialize.dita
index 4c2f23146fc..c0a7dceaaed 100644
--- a/dita/RTC-NG/API/api_icloudspatialaudioengine_initialize.dita
+++ b/dita/RTC-NG/API/api_icloudspatialaudioengine_initialize.dita
@@ -26,7 +26,7 @@
详情
- - 你需要在 () 后调用该方法。
+ - 你需要在 () 后调用该方法。
- 你需要在 后调用该方法。
- 在调用 类的其他方法前,你需要先调用该方法初始化 。
- SDK 只支持每个 app 创建一个 实例。
diff --git a/dita/RTC-NG/API/api_ilocalspatialaudioengine_initialize.dita b/dita/RTC-NG/API/api_ilocalspatialaudioengine_initialize.dita
index 8ae3b9d29d4..00e00fd0b8b 100644
--- a/dita/RTC-NG/API/api_ilocalspatialaudioengine_initialize.dita
+++ b/dita/RTC-NG/API/api_ilocalspatialaudioengine_initialize.dita
@@ -26,7 +26,7 @@
详情
- - 你需要在 () 后调用该方法。
+ - 你需要在 () 后调用该方法。
- 你需要在 后调用该方法。
- 在调用 类的其他方法前,你需要先调用该方法初始化 。
- SDK 只支持每个 app 创建一个 实例。
diff --git a/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita b/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
index 62fe098af1e..db3a9288d83 100644
--- a/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
+++ b/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
@@ -36,7 +36,7 @@
- 在加入频道前调用 注册原始视频帧观测器。
- 在加入频道前调用 注册编码后的视频帧观测器。
- 加入频道后通过 获取 B 组用户的 ID,然后调用 设置该组用户的 encodedFrameOnly 为 。
- - 调用 (),开始接收所有远端用户的视频流。此时:
+
- 调用 (),开始接收所有远端用户的视频流。此时:
- 可通过 中的回调获取 A 组用户的原始视频数据,SDK 默认对该数据进行渲染。
diff --git a/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingplayoutvolume.dita b/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingplayoutvolume.dita
index 3d800d747b7..397ae4c4377 100644
--- a/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingplayoutvolume.dita
+++ b/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingplayoutvolume.dita
@@ -25,7 +25,7 @@
详情
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到 () 回调后调用该方法。
参数
diff --git a/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingpublishvolume.dita b/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingpublishvolume.dita
index 9674dc56452..fd56d83be52 100644
--- a/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingpublishvolume.dita
+++ b/dita/RTC-NG/API/api_irtcengine_adjustaudiomixingpublishvolume.dita
@@ -26,7 +26,7 @@
详情
该方法调节混音音乐文件在远端的播放音量大小。
- 你需要在调用 并收到 () 回调后调用该方法。
+
你需要在调用 并收到 () 回调后调用该方法。
diff --git a/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita b/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
index fe1f721b534..552b90462fb 100644
--- a/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
+++ b/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
@@ -25,7 +25,7 @@
详情
当用户加入频道时,音频功能默认是开启的。该方法可以关闭或重新开启本地音频功能,即停止或重新开始本地音频采集。
- 该方法不影响接收远端音频流,() 适用于只听不发的用户场景。
+ 该方法不影响接收远端音频流,() 适用于只听不发的用户场景。
音频功能关闭或重新开启后,会收到 回调,并报告 (0) 或 (1)。
diff --git a/dita/RTC-NG/API/api_irtcengine_getaudiomixingcurrentposition.dita b/dita/RTC-NG/API/api_irtcengine_getaudiomixingcurrentposition.dita
index 108a1f5a203..88c089405c2 100644
--- a/dita/RTC-NG/API/api_irtcengine_getaudiomixingcurrentposition.dita
+++ b/dita/RTC-NG/API/api_irtcengine_getaudiomixingcurrentposition.dita
@@ -27,7 +27,7 @@
该方法获取当前音乐文件播放进度,单位为毫秒。
- - 你需要在调用 并收到 () 回调后调用该方法。
+ - 你需要在调用 并收到 () 回调后调用该方法。
- 如需多次调用 ,请确保调用间隔大于 500 ms。
diff --git a/dita/RTC-NG/API/api_irtcengine_getaudiomixingduration.dita b/dita/RTC-NG/API/api_irtcengine_getaudiomixingduration.dita
index aff67c1ffc6..f19eb4258fe 100644
--- a/dita/RTC-NG/API/api_irtcengine_getaudiomixingduration.dita
+++ b/dita/RTC-NG/API/api_irtcengine_getaudiomixingduration.dita
@@ -26,7 +26,7 @@
详情
该方法获取音乐文件总时长,单位为毫秒。
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到 () 回调后调用该方法。
返回值
diff --git a/dita/RTC-NG/API/api_irtcengine_getaudiomixingplayoutvolume.dita b/dita/RTC-NG/API/api_irtcengine_getaudiomixingplayoutvolume.dita
index f711ab735f0..e1f1d5391ad 100644
--- a/dita/RTC-NG/API/api_irtcengine_getaudiomixingplayoutvolume.dita
+++ b/dita/RTC-NG/API/api_irtcengine_getaudiomixingplayoutvolume.dita
@@ -26,7 +26,7 @@
详情
该方法获取混音的音乐文件本地播放音量,方便排查音量相关问题。
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到() 回调后调用该方法。
返回值
diff --git a/dita/RTC-NG/API/api_irtcengine_getaudiomixingpublishvolume.dita b/dita/RTC-NG/API/api_irtcengine_getaudiomixingpublishvolume.dita
index 9fbec96528e..2a930eab629 100644
--- a/dita/RTC-NG/API/api_irtcengine_getaudiomixingpublishvolume.dita
+++ b/dita/RTC-NG/API/api_irtcengine_getaudiomixingpublishvolume.dita
@@ -25,7 +25,7 @@
详情
该接口可以方便开发者排查音量相关问题。
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到 () 回调后调用该方法。
返回值
diff --git a/dita/RTC-NG/API/api_irtcengine_getaudiotrackcount.dita b/dita/RTC-NG/API/api_irtcengine_getaudiotrackcount.dita
index 88cff26b696..2eea2889018 100644
--- a/dita/RTC-NG/API/api_irtcengine_getaudiotrackcount.dita
+++ b/dita/RTC-NG/API/api_irtcengine_getaudiotrackcount.dita
@@ -26,7 +26,7 @@
详情
- - 你需要在调用 并收到 () 回调后调用该方法。
+ - 你需要在调用 并收到() 回调后调用该方法。
返回值
diff --git a/dita/RTC-NG/API/api_irtcengine_pullaudioframe2.dita b/dita/RTC-NG/API/api_irtcengine_pullaudioframe2.dita
index 30f1c726dda..bd798f0d920 100644
--- a/dita/RTC-NG/API/api_irtcengine_pullaudioframe2.dita
+++ b/dita/RTC-NG/API/api_irtcengine_pullaudioframe2.dita
@@ -24,7 +24,7 @@
详情
- 使用该方法前,你需要调用 (enabled: ) 通知 app 开启并设置外部渲染。
+ 使用该方法前,你需要调用 (enabled: ) 通知 app 开启并设置外部渲染。
调用该方法后,app 会采取主动拉取的方式获取远端已解码和混音后的音频数据,用于音频播放。
diff --git a/dita/RTC-NG/API/api_irtcengine_selectaudiotrack.dita b/dita/RTC-NG/API/api_irtcengine_selectaudiotrack.dita
index f1dde6b2138..74878791b96 100644
--- a/dita/RTC-NG/API/api_irtcengine_selectaudiotrack.dita
+++ b/dita/RTC-NG/API/api_irtcengine_selectaudiotrack.dita
@@ -28,7 +28,7 @@
- 该方法支持的音频文件格式见 。
- - 你需要在调用 并收到 () 回调后调用该方法。
+ - 你需要在调用 并收到 () 回调后调用该方法。
参数
diff --git a/dita/RTC-NG/API/api_irtcengine_setaudiomixingdualmonomode.dita b/dita/RTC-NG/API/api_irtcengine_setaudiomixingdualmonomode.dita
index abf16c9c0bc..40ce02fa9c3 100644
--- a/dita/RTC-NG/API/api_irtcengine_setaudiomixingdualmonomode.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setaudiomixingdualmonomode.dita
@@ -27,7 +27,7 @@
在双声道音频文件中,左声道和右声道可以存储不同的音频数据。根据实际需要,你可以设置声道模式为原始模式、左声道模式、右声道模式或混合模式。例如,在 KTV 场景中,音频文件的左声道存储了伴奏,右声道存储了原唱的歌声。如果你只需听伴奏,调用该方法设置音频文件的声道模式为左声道模式;如果你需要同时听伴奏和原唱,调用该方法设置声道模式为混合模式。
- - 你需要在调用 并收到 () 回调后调用该方法。
+ - 你需要在调用 并收到 () 回调后调用该方法。
- 该方法仅适用于双声道的音频文件。
diff --git a/dita/RTC-NG/API/api_irtcengine_setaudiomixingpitch.dita b/dita/RTC-NG/API/api_irtcengine_setaudiomixingpitch.dita
index 3a092937a0b..0899eac86f9 100644
--- a/dita/RTC-NG/API/api_irtcengine_setaudiomixingpitch.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setaudiomixingpitch.dita
@@ -25,7 +25,7 @@
详情
本地人声和播放的音乐文件混音时,调用该方法可以仅调节音乐文件的音调。
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到 () 回调后调用该方法。
参数
diff --git a/dita/RTC-NG/API/api_irtcengine_setaudiomixingposition.dita b/dita/RTC-NG/API/api_irtcengine_setaudiomixingposition.dita
index f51faf30440..66dbe896604 100644
--- a/dita/RTC-NG/API/api_irtcengine_setaudiomixingposition.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setaudiomixingposition.dita
@@ -25,7 +25,7 @@
详情
该方法可以设置音频文件的播放位置,这样你可以根据实际情况播放文件,而非从头到尾播放整个文件。
- 你需要在调用 并收到 () 回调后调用该方法。
+ 你需要在调用 并收到 () 回调后调用该方法。
参数
diff --git a/dita/RTC-NG/API/api_irtcengine_setaudioprofile.dita b/dita/RTC-NG/API/api_irtcengine_setaudioprofile.dita
index 06df383f48f..c4aadebaebb 100644
--- a/dita/RTC-NG/API/api_irtcengine_setaudioprofile.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setaudioprofile.dita
@@ -43,7 +43,7 @@ int SetAudioProfile(EAUDIO_PROFILE_TYPE profile = EAUDIO_PROFILE_TYPE::AUDIO_PRO
- 该方法在加入频道前后均可调用。
- - 在有高音质需求的场景(例如音乐教学场景)中,建议将 profile 设置为 (4),scenario 设置为 (3)。
+ - 在有高音质需求的场景(例如音乐教学场景)中,建议将 profile 设置为 (4),scenario 设置为 (3)。
参数
diff --git a/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita b/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita
index 70cfe578b2e..a5cfc9051c6 100644
--- a/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita
@@ -28,7 +28,7 @@ int SetAudioProfile(EAUDIO_PROFILE_TYPE profile = EAUDIO_PROFILE_TYPE::AUDIO_PRO
- 该方法在加入频道前后均可调用。
- - 在有高音质需求的场景(例如音乐教学场景)中,建议将 profile 设置为 (4)。
+ - 在有高音质需求的场景(例如音乐教学场景)中,建议将 profile 设置为 (4)。
- 如果你想设置音频应用场景,可以直接调用 方法进行设置,也可以调用 并设置 结构体中的 mAudioScenarioaudioScenario。
diff --git a/dita/RTC-NG/API/api_irtcengine_setclientrole.dita b/dita/RTC-NG/API/api_irtcengine_setclientrole.dita
index 51f1270dcd7..f677faa321e 100644
--- a/dita/RTC-NG/API/api_irtcengine_setclientrole.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setclientrole.dita
@@ -36,7 +36,7 @@
- 本地会触发 回调。
- - 远端会触发 或 () 回调。
+ - 远端会触发 或 () 回调。
diff --git a/dita/RTC-NG/API/api_irtcengine_setcloudproxy.dita b/dita/RTC-NG/API/api_irtcengine_setcloudproxy.dita
index 6629d8e82e9..7e8390f7a5f 100644
--- a/dita/RTC-NG/API/api_irtcengine_setcloudproxy.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setcloudproxy.dita
@@ -27,8 +27,8 @@
当用户的网络访问受到防火墙限制时,你需要将声网提供的 IP 和端口号添加到防火墙白名单,然后调用该方法开启云代理,并通过 proxyType 参数设置云代理类型。
成功连接云代理后,SDK 会触发 (, ) 回调。
- 如果你想关闭已设置的 Force UDP 或 Force TCP 云代理,请调用 ()。
- 如果你想更改已设置的云代理类型,请先调用 (),再调用 并传入你期望的 proxyType 值。
+
如果你想关闭已设置的 Force UDP 或 Force TCP 云代理,请调用 ()。
+ 如果你想更改已设置的云代理类型,请先调用 (),再调用 并传入你期望的 proxyType 值。
diff --git a/dita/RTC-NG/API/api_irtcengine_setdualstreammode.dita b/dita/RTC-NG/API/api_irtcengine_setdualstreammode.dita
index a0bbb7c9ca9..41c507f27a0 100644
--- a/dita/RTC-NG/API/api_irtcengine_setdualstreammode.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setdualstreammode.dita
@@ -34,8 +34,8 @@
- 如果你在进行修改后又想恢复该默认行为,可重新调用该方法,并将 mode 设置为 。
该方法和 的区别与联系如下:
- - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
- - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
+ - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
+ - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
- 两种方法均可在加入频道前后调用,若同时使用,则以后调用的方法中的设置为准。
diff --git a/dita/RTC-NG/API/api_irtcengine_setremotedefaultvideostreamtype.dita b/dita/RTC-NG/API/api_irtcengine_setremotedefaultvideostreamtype.dita
index 36f191fcaa0..3a2c61870de 100644
--- a/dita/RTC-NG/API/api_irtcengine_setremotedefaultvideostreamtype.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setremotedefaultvideostreamtype.dita
@@ -24,7 +24,7 @@
详情
- 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
+ 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
正常情况下,用户默认接收大流。如需默认接收所有用户的视频小流,可以调用本方法进行切换。SDK 会根据视频窗口的大小动态调整对应视频流的大小,以节约带宽和计算资源。视频小流默认的宽高比和视频大流的宽高比一致。根据当前大流的宽高比,系统会自动分配小流的分辨率、帧率及码率。
diff --git a/dita/RTC-NG/API/api_irtcengine_setremotevideostreamtype.dita b/dita/RTC-NG/API/api_irtcengine_setremotevideostreamtype.dita
index fdf4b16c44f..fe69eb8ff87 100644
--- a/dita/RTC-NG/API/api_irtcengine_setremotevideostreamtype.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setremotevideostreamtype.dita
@@ -32,7 +32,7 @@
详情
- 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以调用该方法选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
+ 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以调用该方法选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
正常情况下,用户默认接收大流。如需接收小流,可以调用本方法进行切换。SDK 会根据视频窗口的大小动态调整对应视频流的大小,以节约带宽和计算资源。视频小流默认的宽高比和视频大流的宽高比一致。根据当前大流的宽高比,系统会自动分配小流的分辨率、帧率及码率。
SDK 默认在发送端开启小流 auto 模式(不主动发送小流),主播身份的接收端可以调用本方法在接收端发起小流申请(观众角色的接收端调用该方法不生效),发送端收到申请后自动切换为小流模式。
该方法在加入频道前后都能调用。如果既调用了 ,也调用了 ,则 SDK 以 中的设置为准。
diff --git a/dita/RTC-NG/API/api_irtcengine_setrouteincommunicationmode.dita b/dita/RTC-NG/API/api_irtcengine_setrouteincommunicationmode.dita
index 44eca1bdc4c..03b308d61ca 100644
--- a/dita/RTC-NG/API/api_irtcengine_setrouteincommunicationmode.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setrouteincommunicationmode.dita
@@ -29,7 +29,7 @@
v4.2.2
- 该方法用于在通话音量模式()下,将音频路由从蓝牙耳机切换为听筒、有线耳机或扬声器。该方法调用成功后,SDK 会触发 回调,报告修改后的路由。
+ 该方法用于在通话音量模式()下,将音频路由从蓝牙耳机切换为听筒、有线耳机或扬声器。该方法调用成功后,SDK 会触发 回调,报告修改后的路由。
该方法与 同时使用时可能引起冲突。声网建议你单独使用 。
- 该方法仅适用于 Android。
- 该方法与 同时使用时可能引起冲突。声网建议你单独使用 。
diff --git a/dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita b/dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita
index 36f7dee8767..dee7f56356b 100644
--- a/dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita
+++ b/dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita
@@ -40,7 +40,7 @@ int StartAudioMixing(FString filePath, bool loopback, int cycle, int startPos =
详情
- 该方法支持将本地或在线音乐文件和麦克风采集的音频进行混音或替换。成功播放音乐文件后,本地会触发 () 回调。播放结束后,本地会触发 () 回调。
+ 该方法支持将本地或在线音乐文件和麦克风采集的音频进行混音或替换。成功播放音乐文件后,本地会触发 () 回调。播放结束后,本地会触发 () 回调。
该方法支持播放以 content:// 开头的 URI 文件。
diff --git a/dita/RTC-NG/API/api_irtcengine_updatechannelmediarelay.dita b/dita/RTC-NG/API/api_irtcengine_updatechannelmediarelay.dita
index b8f991d0d9f..fafc89351a4 100644
--- a/dita/RTC-NG/API/api_irtcengine_updatechannelmediarelay.dita
+++ b/dita/RTC-NG/API/api_irtcengine_updatechannelmediarelay.dita
@@ -38,7 +38,7 @@
成功开始跨频道转发媒体流后,如果你希望将流转发到多个目标频道,或退出当前的转发频道,可以调用该方法。
成功调用该方法后,SDK 会触发 回调, 并在回调中报告状态码 (7)。
- 请在成功调用 方法并收到 (, ) 后调用该方法;否则,方法调用会失败。
+ 请在成功调用 方法并收到 (, ) 后调用该方法;否则,方法调用会失败。
参数
diff --git a/dita/RTC-NG/API/api_irtcengineex_setdualstreammodeex.dita b/dita/RTC-NG/API/api_irtcengineex_setdualstreammodeex.dita
index 876bd5575eb..2556109df8d 100644
--- a/dita/RTC-NG/API/api_irtcengineex_setdualstreammodeex.dita
+++ b/dita/RTC-NG/API/api_irtcengineex_setdualstreammodeex.dita
@@ -50,8 +50,8 @@
该方法和 的区别与联系如下:
- - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
- - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
+ - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
+ - 调用该方法并设置 mode 为 时,跟 () 的效果相同。
- 两种方法均可在加入频道前后调用,若同时使用,则以后调用的方法中的设置为准。
diff --git a/dita/RTC-NG/API/api_irtcengineex_setremotevideostreamtypeex.dita b/dita/RTC-NG/API/api_irtcengineex_setremotevideostreamtypeex.dita
index 127b7348d76..756b410aee7 100644
--- a/dita/RTC-NG/API/api_irtcengineex_setremotevideostreamtypeex.dita
+++ b/dita/RTC-NG/API/api_irtcengineex_setremotevideostreamtypeex.dita
@@ -37,7 +37,7 @@
详情
- 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以调用该方法选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
+ 在网络条件受限的情况下,如果发送端没有调用 () 关闭双流模式,接收端可以调用该方法选择接收大流还是小流。其中,大流为高分辨率高码率的视频流,小流则是低分辨率低码率的视频流。
正常情况下,用户默认接收大流。如需接收小流,可以调用本方法进行切换。SDK 会根据视频窗口的大小动态调整对应视频流的大小,以节约带宽和计算资源。视频小流默认的宽高比和视频大流的宽高比一致。根据当前大流的宽高比,系统会自动分配小流的分辨率、帧率及码率。
SDK 默认在发送端开启小流 auto 模式(不主动发送小流),接收端主播可以调用本方法在接收端发起小流申请,发送端收到申请后自动切换为小流模式。
diff --git a/dita/RTC-NG/API/api_irtcengineex_updatechannelmediarelayex.dita b/dita/RTC-NG/API/api_irtcengineex_updatechannelmediarelayex.dita
index f3fcf09f806..17c149b0357 100644
--- a/dita/RTC-NG/API/api_irtcengineex_updatechannelmediarelayex.dita
+++ b/dita/RTC-NG/API/api_irtcengineex_updatechannelmediarelayex.dita
@@ -41,7 +41,7 @@
成功开始跨频道转发媒体流后,如果你希望将流转发到多个目标频道,或退出当前的转发频道,可以调用该方法。
成功调用该方法后,SDK 会触发 回调, 并在回调中报告状态码 (7)。
- 请在成功调用 方法并收到 (, ) 后调用该方法;否则,方法调用会失败。
+ 请在成功调用 方法并收到 (, ) 后调用该方法;否则,方法调用会失败。
参数
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita
index f18cd2771d5..f004901c3e8 100644
--- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita
+++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita
@@ -44,7 +44,7 @@
- 当调用 (
) 启用插件失败或者插件运行出错时, 插件会触发该回调并上报错误码和错误原因。
+ 当调用 () 启用插件失败或者插件运行出错时, 插件会触发该回调并上报错误码和错误原因。
参数
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita
index 9879c82c450..6ae564b260f 100644
--- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita
+++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita
@@ -28,7 +28,7 @@
- 当调用 (
) 启用插件成功时,插件会触发该回调。
+ 当调用 () 启用插件成功时,插件会触发该回调。
参数
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita
index 468a0a831d6..422e643588f 100644
--- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita
+++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita
@@ -28,7 +28,7 @@
- 当调用 (
) 禁用插件成功时,插件会触发该回调。
+ 当调用 () 禁用插件成功时,插件会触发该回调。
参数
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onfacepositionchanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onfacepositionchanged.dita
index b60761339eb..25ab1f948ba 100644
--- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onfacepositionchanged.dita
+++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onfacepositionchanged.dita
@@ -45,7 +45,7 @@
- 调用 () 开启本地人脸检测后,你可以通过该回调实时获取以下人脸检测的信息:
+
调用 () 开启本地人脸检测后,你可以通过该回调实时获取以下人脸检测的信息:
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onfirstlocalaudioframepublished.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onfirstlocalaudioframepublished.dita
index b9d80a5c39c..5261f7e04a3 100644
--- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onfirstlocalaudioframepublished.dita
+++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onfirstlocalaudioframepublished.dita
@@ -35,7 +35,7 @@
SDK 会在以下时机触发该回调:
- 开启本地音频的情况下,调用 成功加入频道后。
- - 调用 (),再调用 () 后。
+ - 调用 (),再调用 () 后。
- 调用 ,再调用 后。
- 调用 成功向 SDK 推送音频帧后。
- 调用 成功向 SDK 推送音频帧后。
diff --git a/dita/RTC-NG/API/rtc_api_overview_ng.dita b/dita/RTC-NG/API/rtc_api_overview_ng.dita
index e5f852d1dd5..e6a02e718f8 100644
--- a/dita/RTC-NG/API/rtc_api_overview_ng.dita
+++ b/dita/RTC-NG/API/rtc_api_overview_ng.dita
@@ -650,7 +650,6 @@
描述
-
音频设备集合
@@ -670,6 +669,7 @@
方法
描述
+