From 0e7203e5240c0c86dcda848397e5ec5a334c6eb8 Mon Sep 17 00:00:00 2001 From: Suri539 Date: Wed, 13 Nov 2024 17:53:16 +0800 Subject: [PATCH 1/3] update desc --- ...llback_ivideoframeobserver_getvideoformatpreference.dita | 2 +- .../callback_ivideoframeobserver_oncapturevideoframe.dita | 6 +++++- .../callback_ivideoframeobserver_onrendervideoframe.dita | 3 +++ 3 files changed, 9 insertions(+), 2 deletions(-) diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita index f947e14ae73..5f0a26685f2 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita @@ -32,7 +32,7 @@

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

在默认情况下，原始视频像素格式 () 存在以下类型：
    -
  • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。视频帧类型固定为 I420Buffer 的情况包括但不限于：
      +
    • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。TextureBuffer 类型的纹理格式可能为 OES 格式或者 RGB 格式。如果 返回的视频帧类型为 ，你需要在处理视频数据时增加对 I420Buffer 或 TextureBuffer 的适配。视频帧类型固定为 I420Buffer 的情况包括但不限于：
      • 特定机型，例如：LG G5 SE (H848)，Google Pixel 4a，Samsung Galaxy A7 或 Xiaomi Mi Max。
      • 已集成视频增强插件并开启视频降噪或暗光增强功能。
      • diff --git a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita index 66729309792..39c9cf6b9c0 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita @@ -35,6 +35,10 @@

      你可以在回调中获取本地设备采集到的原始视频数据，并可根据需要进行前处理。完成前处理后，你可以在该回调中直接修改 videoFrame，并将返回值设置为 ，即可将修改后的视频数据发送给 SDK。

      如果你需要将处理后的数据发送给 SDK，需要先调用 方法，将视频处理模式设置为读写模式（）。

      你可以在回调中获取本地设备采集到的原始视频数据。

      + +

      该回调默认提供的视频数据格式为 I420Buffer 或 TextureBuffer，TextureBuffer 类型的纹理格式可能为 0ES 格式或者 RGB 格式。如果你需要其他格式的视频数据，可在 回调的返回值中设置预期的数据格式。

      +

      该回调默认提供的视频数据格式为 I420 或 CVPixelBufferRef，如果你需要其他格式的视频数据，可在 回调中返回预期的数据格式。

      +

      该回调默认提供的视频数据格式为 YUV420，如果你需要其他格式的视频数据，可在 getVideoFormatPreference 回调的返回值中设置预期的数据格式。
适用场景 @@ -45,7 +49,7 @@
触发时机

成功注册视频数据观测器后，SDK 捕捉到每个视频帧时。

-
+
使用限制

成功注册视频数据观测器后，SDK 会在捕捉到每个视频帧时触发该回调。你可以在回调中获取远端发送的渲染前的视频数据，然后根据场景需要，对视频数据进行处理。

+

该回调默认提供的视频数据格式为 I420Buffer 或 TextureBuffer，TextureBuffer 类型的纹理格式可能为 0ES 格式或者 RGB 格式。如果你需要其他格式的视频数据，可在 回调的返回值中设置预期的数据格式。

+

该回调默认提供的视频数据格式为 I420 或 CVPixelBufferRef，如果你需要其他格式的视频数据，可在 回调中返回预期的数据格式。

+

该回调默认提供的视频数据格式为 YUV420，如果你需要其他格式的视频数据，可在 getVideoFormatPreference 回调的返回值中设置预期的数据格式。

  • 如果你需要将处理后的数据发送给 SDK，需要先调用 方法，将视频处理模式设置为读写模式（）。
    • From 054eb99f61f66d3a7cb23c0862539ec1007cf65d Mon Sep 17 00:00:00 2001 From: Suri539 Date: Wed, 13 Nov 2024 17:56:02 +0800 Subject: [PATCH 2/3] Update callback_ivideoframeobserver_getvideoformatpreference.dita --- .../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 5f0a26685f2..0bc0f0a6797 100644 --- a/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita +++ b/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita @@ -32,7 +32,7 @@

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

    在默认情况下，原始视频像素格式 () 存在以下类型：
      -
    • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。TextureBuffer 类型的纹理格式可能为 OES 格式或者 RGB 格式。如果 返回的视频帧类型为 ，你需要在处理视频数据时增加对 I420Buffer 或 TextureBuffer 的适配。视频帧类型固定为 I420Buffer 的情况包括但不限于：
        +
      • 在 Android 平台上，默认的视频帧类型可能为 I420Buffer 或 TextureBuffer。TextureBuffer 类型的纹理格式可能为 OES 格式或者 RGB 格式。如果 返回的视频帧类型为 ，你需要在处理视频数据时增加对 I420Buffer 或 TextureBuffer 的适配。视频帧类型固定为 I420Buffer 的情况包括但不限于：
        • 特定机型，例如：LG G5 SE (H848)，Google Pixel 4a，Samsung Galaxy A7 或 Xiaomi Mi Max。
        • 已集成视频增强插件并开启视频降噪或暗光增强功能。
        • From 64f2b69eadf23cacde52c313fdc768628272f68e Mon Sep 17 00:00:00 2001 From: Suri539 Date: Wed, 13 Nov 2024 18:22:40 +0800 Subject: [PATCH 3/3] Update rtc_api_overview.dita --- dita/RTC-NG/API/rtc_api_overview.dita | 32 +++++++++++++-------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/dita/RTC-NG/API/rtc_api_overview.dita b/dita/RTC-NG/API/rtc_api_overview.dita index eccb06a52b1..080b7c27cf0 100644 --- a/dita/RTC-NG/API/rtc_api_overview.dita +++ b/dita/RTC-NG/API/rtc_api_overview.dita @@ -1108,37 +1108,37 @@ - + - - - + + + - + - - - + + + - + - - - + + + - + - - - + + +