From b095f49a80236fdcfabc81ea67ac83197bd4b26a Mon Sep 17 00:00:00 2001 From: jinyu Date: Tue, 31 Oct 2023 10:59:37 +0800 Subject: [PATCH 01/12] remove redundant whitespace --- ..._irtcengine_setplaybackaudioframebeforemixingparameters.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dita/RTC-NG/API/api_irtcengine_setplaybackaudioframebeforemixingparameters.dita b/dita/RTC-NG/API/api_irtcengine_setplaybackaudioframebeforemixingparameters.dita index 039f6162d47..3d3acafb05a 100644 --- a/dita/RTC-NG/API/api_irtcengine_setplaybackaudioframebeforemixingparameters.dita +++ b/dita/RTC-NG/API/api_irtcengine_setplaybackaudioframebeforemixingparameters.dita @@ -46,7 +46,7 @@ channel -

音频数据声道数，可设置为 1（单声道） 或 2（双声道） 。

+

音频数据声道数，可设置为 1（单声道）或 2（双声道）。

 From d12c86cc9d2ef8d7a18d80bcda8735a4f9e8ff74 Mon Sep 17 00:00:00 2001 From: jinyu Date: Tue, 31 Oct 2023 11:00:23 +0800 Subject: [PATCH 02/12] modify call sequence --- .../API/api_irtcengine_setcameracapturerconfiguration.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita b/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita index d19250a1902..ea70698337a 100644 --- a/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita +++ b/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita @@ -34,7 +34,7 @@
  • 该方法仅适用于 Android 和 iOS。
    • -
  • 该方法必须在开启摄像头后调用，如 和 后调用。
    • +
  • 该方法必须在开启摄像头前调用，如 和 后调用。
参数 From dd3e6cae6986d473bfff510375eb1ac9468862b0 Mon Sep 17 00:00:00 2001 From: Nero-Hu Date: Wed, 1 Nov 2023 15:27:29 +0800 Subject: [PATCH 03/12] RN: remove onAudioDeviceVolumeChanged --- ...api_irtcengine_startlastmileprobetest.dita | 44 ++++++++----------- dita/RTC-NG/RTC_NG_API_RN.ditamap | 1 - dita/RTC-NG/config/keys-rtc-ng-api-rn.ditamap | 9 ---- 3 files changed, 18 insertions(+), 36 deletions(-) diff --git a/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita b/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita index e87234dfdaf..74740f65c1c 100644 --- a/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita +++ b/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita @@ -27,33 +27,25 @@
详情

开始通话前网络质量探测，向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。

-

- 启用该方法后，SDK 会依次返回如下 2 个回调： - - - -

    -
  • ，视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量，更贴近用户的主观感受。 -
    • -
  • ，视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量，更加客观。 -
    • -

-

- 该方法主要用于以下两种场景： - - - -

    -
  • 用户加入频道前，可以调用该方法判断和预测目前的上行网络质量是否足够好。
    • -
  • 直播场景下，当用户角色想由观众切换为主播时，可以调用该方法判断和预测目前的上行网络质量是否足够好。
    • -

+

启用该方法后，SDK 会依次返回如下 2 个回调： +

    +
  • ，视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量，更贴近用户的主观感受。
    • +
  • ，视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量，更加客观。
    • +
+

+

该方法主要用于以下两种场景： +

    +
  • 用户加入频道前，可以调用该方法判断和预测目前的上行网络质量是否足够好。
    • +
  • 直播场景下，当用户角色想由观众切换为主播时，可以调用该方法判断和预测目前的上行网络质量是否足够好。
    • +
+

-
    -
  • - 调用该方法后，在收到 和 回调之前请不要调用其他方法，否则可能会由于 API 操作过于频繁导致此方法无法执行。 -
    • -
  • 在直播场景中，如果本地用户为主播，请勿加入频道后调用该方法。
    • -
+
    +
  • 调用该方法后，在收到 和 回调之前请不要调用其他方法，否则可能会由于 API 操作过于频繁导致此方法无法执行。
    • +
  • 在直播场景中，如果本地用户为主播，请勿加入频道后调用该方法。
    • +
+ +
参数 diff --git a/dita/RTC-NG/RTC_NG_API_RN.ditamap b/dita/RTC-NG/RTC_NG_API_RN.ditamap index cc988f44646..306e84ff1bf 100644 --- a/dita/RTC-NG/RTC_NG_API_RN.ditamap +++ b/dita/RTC-NG/RTC_NG_API_RN.ditamap @@ -635,7 +635,6 @@ - diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-rn.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-rn.ditamap index 1bc254cf0a4..82312a62b75 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-rn.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-rn.ditamap @@ -4303,15 +4303,6 @@ - - - - - onAudioDeviceVolumeChanged - - - - From bde82d09b3cbf6566113e3f703e3b725dbdb7205 Mon Sep 17 00:00:00 2001 From: Cilla-luodan Date: Wed, 1 Nov 2023 16:28:14 +0800 Subject: [PATCH 04/12] =?UTF-8?q?fix=20=E8=A3=B8=E6=95=B0=E6=8D=AE+faceUni?= =?UTF-8?q?ty=E9=BB=91=E5=B1=8F=E7=9A=84=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...rameobserver_getvideoformatpreference.dita | 35 +++++-------------- ...ideoframeobserver_oncapturevideoframe.dita | 8 ++--- 2 files changed, 13 insertions(+), 30 deletions(-) diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita index 22691c0fe96..53312d9e629 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita @@ -29,35 +29,18 @@

-

如果你想获取 YUV 420 格式以外的原始视频数据，需要在调用 方法时注册该回调。 成功注册视频数据观测器后，SDK 会在捕捉到每个视频帧时触发该回调，你需要在该回调返回值中设置期望的视频数据格式。

- 如果你想获取发送端采集的原始视频格式，则在返回值中设置原始视频数据格式为 。在不同的平台上，原始视频像素格式也不同，实际的视频像素格式以 为准。
+

你需要在调用 方法时注册该回调。成功注册视频数据观测器后，SDK 会在捕捉到每个视频帧时触发该回调，你需要在该回调的返回值中设置期望的视频数据格式。

+
返回值 -

设置 SDK 输出的原始数据格式。详见 。

+

设置 SDK 输出的原始数据格式。详见 。

+

在默认情况下，原始视频像素格式 () 存在以下类型： +

  • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
    • +
  • 默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
    • +
  • 在 iOS 和 macOS 平台上，默认的视频帧类型可能为 I420 或 CVPixelBufferRef。
    • +
  • 默认的视频帧类型可能为 I420 或 CVPixelBufferRef。
    • +
  • 在 Windows 平台上，默认为 YUV420。

- -

在不同观测位置和采集场景下，该枚举值对应的实际视频像素格式都不同，建议你不要使用该值。以下列出了一些常见的情况。

-
    -
  • 观测位置为 时： -
      -
    • 仅支持像素格式为 CVPixelBufferRef 的视频。
      • -
    • 在用户采集 YUV 格式的视频数据、或采集的视频分辨率小于 256 × 256 时，支持的视频像素格式为 I420；其他情况下，支持 Texture 格式。
      • -
    • 仅支持像素格式为 I420 的视频。
      • -
    • -
  • 观测位置为 时： -
      -
    • 仅支持像素格式为 CVPixelBufferRef 的视频。
      • -
    • 在用户采集 YUV 格式的视频数据、或采集的视频分辨率小于 256 × 256 时，支持的视频像素格式为 I420；其他情况下，支持 Texture 格式。
      • -
    • 仅支持像素格式为 I420 的视频。
      • -
    • -
  • 观测位置为 时： -
      -
    • 默认支持像素格式为 CVPixelBufferRef 的视频。
      • -
    • 默认支持像素格式为 Texture 的视频。
      • -
    • 支持像素格式为 I420 的视频。
      • -
    • -
-
  • (0): 原始视频像素格式。
  • (1): I420 格式。
    • diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita index 3e99ba560b6..8ae3772d4af 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita @@ -35,7 +35,7 @@

    完成前处理后，你可以在该回调中直接修改 videoFrame，并将返回值设置为 ，即可将修改后的视频数据发送给 SDK。

      -
    • 此处获取的视频数据未经过前处理，如水印、裁剪、旋转和美颜等。
      • +
    • 此处获取的视频数据未经过水印、裁剪和旋转等前处理。
    • 如果你获取到的视频数据类型为 RGBA，SDK 不支持对 alpha 通道的值进行处理。
    • 由于 Flutter 框架的限制，该回调不支持将处理后的视频数据发送回 SDK。
@@ -51,9 +51,9 @@ 视频帧数据。详见 。 通过该回调获取的视频帧数据格式默认值如下：
    -
  • Android：texture
    • -
  • iOS：cvPixelBuffer
    • -
  • macOS：YUV 420
    • +
  • Android：I420 或 RGB 纹理格式
    • +
  • iOS：I420 或 CVPixelBufferRef
    • +
  • macOS：I420 或 CVPixelBufferRef
  • Windows：YUV 420
 From de9ee19aa6f6bff4b366e34be6ce061a59ddafc7 Mon Sep 17 00:00:00 2001 From: Suri539 Date: Wed, 1 Nov 2023 16:48:05 +0800 Subject: [PATCH 05/12] audiostate&streaminfo --- .../API/api_imediaplayer_getstreaminfo.dita | 7 ++-- ...venthandler_onaudiodevicestatechanged.dita | 35 ++++++++++++++++--- ...eventhandler_onlocalaudiostatechanged.dita | 1 - ...venthandler_onvideodevicestatechanged.dita | 2 +- 4 files changed, 35 insertions(+), 10 deletions(-) diff --git a/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita b/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita index f211af1b88d..b2a6b769af8 100644 --- a/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita +++ b/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita @@ -32,9 +32,8 @@ index - 媒体流索引值。 - 该参数需小于 的 count 参数。 - 该参数需小于 的返回值。 + 媒体流索引值。该参数需小于 的 count 参数。 + 媒体流索引值。该参数需小于 的返回值。 info @@ -52,4 +51,4 @@
  • < 0: 方法调用失败。详见了解详情和解决建议。
    • - \ No newline at end of file + diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita index 96b947b026c..2e131d66976 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita @@ -50,11 +50,38 @@     deviceType - 设备类型定义。详见 。 + 设备类型定义。详见 。 + 设备类型定义： +
      +
    • (-1): 设备类型未知。
      • +
    • (0): 音频播放设备。
      • +
    • (1): 音频采集设备。
      • +
    • (2): 视频渲染设备 (显卡)。
      • +
    • (3): 视频采集设备。
      • +
    • (4): 音频应用播放设备。
      • +
    • (5):（仅适用于 macOS）虚拟音频播放设备（虚拟声卡）。
      • +
    • (6):（仅适用于 macOS）虚拟音频采集设备（虚拟声卡）。
      • +
    - - - + + deviceState + 设备状态，详见 。 + 设备状态。 +
      +
    • 在 Windows 平台上： +
        +
      • (0): 准备就绪。
        • +
      • (1): 设备正在使用。
        • +
      • (2): 设备被禁用。
        • +
      • (4): 没有此设备。
        • +
      • (8): 设备被拔出。
        • +
      • +
    • 在 macOS 平台上： +
        +
      • 0: 设备就绪。
        • +
      • 8: 设备被拔出。
        • +
      • +
    diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalaudiostatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalaudiostatechanged.dita index c332253373a..012ad4cb14a 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalaudiostatechanged.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalaudiostatechanged.dita @@ -13,7 +13,6 @@

    - public virtual void OnLocalAudioStateChanged(RtcConnection connection, LOCAL_AUDIO_STREAM_STATE state, LOCAL_AUDIO_STREAM_ERROR error) {} public void onLocalAudioStateChanged(int state, int error) {} - (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine localAudioStateChanged:(AgoraAudioLocalState)state error:(AgoraAudioLocalError)error; diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita index 64cbae5c0a4..c4714f09a03 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita @@ -55,7 +55,7 @@ 设备状态。

      -
    • 在 Windows 平台上，详见 。
      • +
    • 在 Windows 平台上，详见 。
    • 在 Windows 平台上：
      • (0): 准备就绪。
        • From 72d88a1ff90924799c1df245b1e56d990ea1e34d Mon Sep 17 00:00:00 2001 From: Cilla-luodan Date: Wed, 1 Nov 2023 17:12:03 +0800 Subject: [PATCH 06/12] resolve review comments --- ...callback_ivideoframeobserver_getvideoformatpreference.dita | 2 +- .../API/callback_ivideoframeobserver_oncapturevideoframe.dita | 2 +- dita/RTC-NG/API/enum_videoobserverframetype.dita | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita index 53312d9e629..919b2145c94 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita @@ -33,7 +33,7 @@
    返回值 -

    设置 SDK 输出的原始数据格式。详见 。

    +

    设置 SDK 输出的原始数据格式。详见 。

    在默认情况下，原始视频像素格式 () 存在以下类型：

    • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
    • 默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
      • diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita index 8ae3772d4af..294f0f4d78b 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita @@ -54,7 +54,7 @@
    • Android：I420 或 RGB 纹理格式
    • iOS：I420 或 CVPixelBufferRef
    • macOS：I420 或 CVPixelBufferRef
      • -
    • Windows：YUV 420
    +
  • Windows：YUV420
    • diff --git a/dita/RTC-NG/API/enum_videoobserverframetype.dita b/dita/RTC-NG/API/enum_videoobserverframetype.dita index 7877aeeaf32..e38b0f11c15 100644 --- a/dita/RTC-NG/API/enum_videoobserverframetype.dita +++ b/dita/RTC-NG/API/enum_videoobserverframetype.dita @@ -13,11 +13,11 @@ - YUV 420 格式的视频数据。 + YUV420 格式的视频数据。 - YUV 422 格式的视频数据。 + YUV422 格式的视频数据。 From 30df01fd186b2bf63ebe5f8166f2684f2c503ddf Mon Sep 17 00:00:00 2001 From: Nero-Hu Date: Wed, 1 Nov 2023 17:54:07 +0800 Subject: [PATCH 07/12] fix blank spaces --- .../RTC-NG/API/api_irtcengine_startlastmileprobetest.dita | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita b/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita index 74740f65c1c..be73a4a037d 100644 --- a/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita +++ b/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita @@ -29,8 +29,8 @@

    开始通话前网络质量探测，向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。

    启用该方法后，SDK 会依次返回如下 2 个回调：

      -
    • ，视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量，更贴近用户的主观感受。
      • -
    • ，视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量，更加客观。
      • +
    • ，视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量，更贴近用户的主观感受。
      • +
    • ，视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量，更加客观。

    该方法主要用于以下两种场景： @@ -51,9 +51,7 @@ config - - Last mile 网络探测配置，详见 。 - + Last mile 网络探测配置，详见 。

    From 4c93b95261598c4fdd0ee9a82ac9509dcf8f27da Mon Sep 17 00:00:00 2001 From: Cilla-luodan Date: Thu, 2 Nov 2023 10:24:15 +0800 Subject: [PATCH 08/12] sync desc --- .../API/api_irtcengine_setvideoencoderconfiguration.dita | 3 ++- .../API/api_irtcengineex_setvideoencoderconfigurationex.dita | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/dita/RTC-NG/API/api_irtcengine_setvideoencoderconfiguration.dita b/dita/RTC-NG/API/api_irtcengine_setvideoencoderconfiguration.dita index f488384704e..9dd7bf4e67b 100644 --- a/dita/RTC-NG/API/api_irtcengine_setvideoencoderconfiguration.dita +++ b/dita/RTC-NG/API/api_irtcengine_setvideoencoderconfiguration.dita @@ -30,7 +30,8 @@
    详情 -

    设置本地视频的编码属性。

    +

    设置本地视频的编码属性。每一种视频编码属性对应一系列视频相关参数设置，包含分辨率、帧率和码率。

    +

    该方法的 config 参数设置是在理想网络状态下能达到的最大值。如果网络状态不好，视频引擎便不能使用该 config 渲染本地视频，它会自动降低到一个合适的视频参数设置。

    • 该方法在加入频道前后都能调用。如果用户在加入频道后不需要重新设置视频编码属性，则建议在 前调用该方法，可以加快首帧出图的时间。
      • diff --git a/dita/RTC-NG/API/api_irtcengineex_setvideoencoderconfigurationex.dita b/dita/RTC-NG/API/api_irtcengineex_setvideoencoderconfigurationex.dita index 697e3df1fe4..dba81c57aa9 100644 --- a/dita/RTC-NG/API/api_irtcengineex_setvideoencoderconfigurationex.dita +++ b/dita/RTC-NG/API/api_irtcengineex_setvideoencoderconfigurationex.dita @@ -2,7 +2,7 @@ <ph keyref="setVideoEncoderConfigurationEx" /> - 设置本地视频编码属性。 + 设置视频编码属性。 @@ -36,7 +36,7 @@
    详情 -

    每一种视频编码属性对应一系列视频相关参数设置，包含分辨率、帧率和码率。

    +

    设置本地视频的编码属性。每一种视频编码属性对应一系列视频相关参数设置，包含分辨率、帧率和码率。

    该方法的 config 参数设置是在理想网络状态下能达到的最大值。如果网络状态不好，视频引擎便不能使用该 config 渲染本地视频，它会自动降低到一个合适的视频参数设置。

    From a80a69f5262240e1eb83daad2e3bad132db66c65 Mon Sep 17 00:00:00 2001 From: Suri539 Date: Thu, 2 Nov 2023 10:53:43 +0800 Subject: [PATCH 09/12] fix --- .../API/api_imediaplayer_getstreaminfo.dita | 2 +- ...venthandler_onaudiodevicestatechanged.dita | 31 ++----------------- ...venthandler_onvideodevicestatechanged.dita | 20 +----------- 3 files changed, 4 insertions(+), 49 deletions(-) diff --git a/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita b/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita index b2a6b769af8..2fcc81b79f8 100644 --- a/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita +++ b/dita/RTC-NG/API/api_imediaplayer_getstreaminfo.dita @@ -33,7 +33,7 @@ index 媒体流索引值。该参数需小于 的 count 参数。 - 媒体流索引值。该参数需小于 的返回值。 + 媒体流索引值。该参数的值需小于 的返回值。 info diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita index 2e131d66976..71a076bac1f 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onaudiodevicestatechanged.dita @@ -50,38 +50,11 @@ deviceType - 设备类型定义。详见 。 - 设备类型定义： -
      -
    • (-1): 设备类型未知。
      • -
    • (0): 音频播放设备。
      • -
    • (1): 音频采集设备。
      • -
    • (2): 视频渲染设备 (显卡)。
      • -
    • (3): 视频采集设备。
      • -
    • (4): 音频应用播放设备。
      • -
    • (5):（仅适用于 macOS）虚拟音频播放设备（虚拟声卡）。
      • -
    • (6):（仅适用于 macOS）虚拟音频采集设备（虚拟声卡）。
      • -
    + 设备类型定义。详见 。     deviceState - 设备状态，详见 。 - 设备状态。 -
      -
    • 在 Windows 平台上： -
        -
      • (0): 准备就绪。
        • -
      • (1): 设备正在使用。
        • -
      • (2): 设备被禁用。
        • -
      • (4): 没有此设备。
        • -
      • (8): 设备被拔出。
        • -
      • -
    • 在 macOS 平台上： -
        -
      • 0: 设备就绪。
        • -
      • 8: 设备被拔出。
        • -
      • -
    + 设备状态，详见 。
    diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita index c4714f09a03..59cd1658dc0 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onvideodevicestatechanged.dita @@ -52,25 +52,7 @@ deviceState - 设备状态。 - -
      -
    • 在 Windows 平台上，详见 。
      • -
    • 在 Windows 平台上： -
        -
      • (0): 准备就绪。
        • -
      • (1): 设备正在使用。
        • -
      • (2): 设备被禁用。
        • -
      • (4): 没有此设备。
        • -
      • (8): 设备被拔出。
        • -
      • -
    • 在 macOS 平台上： - -
        -
      • 0: 设备就绪。
        • -
      • 8: 设备被拔出。
        • -
      • -
    + 设备状态。详见 。     From 518fcd10f0bdd0412c20fbf2dfdd954e9284548a Mon Sep 17 00:00:00 2001 From: jinyu Date: Thu, 2 Nov 2023 11:12:58 +0800 Subject: [PATCH 10/12] Update api_irtcengine_setcameracapturerconfiguration.dita --- .../API/api_irtcengine_setcameracapturerconfiguration.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita b/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita index ea70698337a..d66f7817fe3 100644 --- a/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita +++ b/dita/RTC-NG/API/api_irtcengine_setcameracapturerconfiguration.dita @@ -34,7 +34,7 @@
    • 该方法仅适用于 Android 和 iOS。
      • -
    • 该方法必须在开启摄像头前调用，如 和 后调用。
      • +
    • 该方法必须在开启本地摄像头采集前调用，如 和 前调用。
    参数 From 4d0473dc1e8e19cdfc497bb58f012b5e7f9e0c13 Mon Sep 17 00:00:00 2001 From: Cilla-luodan Date: Thu, 2 Nov 2023 11:36:13 +0800 Subject: [PATCH 11/12] fix props --- .../callback_ivideoframeobserver_getvideoformatpreference.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita index 919b2145c94..86a12cef7f5 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita @@ -33,7 +33,7 @@
    返回值 -

    设置 SDK 输出的原始数据格式。详见 。

    +

    设置 SDK 输出的原始数据格式。详见 。

    在默认情况下，原始视频像素格式 () 存在以下类型：

    • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
    • 默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。自 v4.2.3 起，TextureBuffer 类型的纹理格式不再包括 OES 格式，仅为 RGB 格式。你需要在处理视频数据时增加对 I420、RGB 纹理格式的适配。
      • From 8f7be0b278a04345822c565f8d8020d742a677b6 Mon Sep 17 00:00:00 2001 From: Nero-Hu Date: Thu, 2 Nov 2023 11:39:51 +0800 Subject: [PATCH 12/12] fix releations --- dita/RTC-NG/config/relations-rtc-ng-api.ditamap | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap index 416c53b6d84..0993755e758 100644 --- a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap +++ b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap @@ -2609,7 +2609,7 @@ - +