diff --git a/dita/RTC-NG/API/api_irtcengine_setvideoprofile2.dita b/dita/RTC-NG/API/api_irtcengine_setvideoprofile2.dita index 89f5b0d7a07..03db553c3fa 100644 --- a/dita/RTC-NG/API/api_irtcengine_setvideoprofile2.dita +++ b/dita/RTC-NG/API/api_irtcengine_setvideoprofile2.dita @@ -6,7 +6,7 @@ - + diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechangefailed.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechangefailed.dita index 6d6523d7632..ee27c3d349b 100644 --- a/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechangefailed.dita +++ b/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechangefailed.dita @@ -61,8 +61,18 @@
  • (1): 频道内主播人数达到上限。 该枚举仅在开启 128 人功能后报告。主播人数的上限根据开启 128 人功能时实际配置的人数而定。
  • (2): 请求被服务端拒绝。建议提示用户重新尝试切换用户角色。
    • -
  • (3): （已废弃）请求超时。建议提示用户检查网络连接状况后重新尝试切换用户角色。
    • -
  • (4): （已废弃）网络连接断开。可根据 报告的 reason，排查网络连接失败的具体原因。
    • +
  • (3): 请求超时。建议提示用户检查网络连接状况后重新尝试切换用户角色。 +
    + +
    废弃：
    +
    该枚举值自 v4.4.0 起废弃，不建议使用。
    +
    • +
  • (4): 网络连接断开。可根据 报告的 reason，排查网络连接失败的具体原因。 +
    + +
    废弃：
    +
    该枚举值自 v4.4.0 起废弃，不建议使用。
    +
    • diff --git a/dita/RTC-NG/API/class_externalvideoframe.dita b/dita/RTC-NG/API/class_externalvideoframe.dita index 472a78ae077..b6a7e96bd6c 100644 --- a/dita/RTC-NG/API/class_externalvideoframe.dita +++ b/dita/RTC-NG/API/class_externalvideoframe.dita @@ -75,7 +75,7 @@ @property(strong, nonatomic) IMAGE_CLASS * _Nullable image; @property(strong, nonatomic) NSData *_Nullable dataBuf; @property(strong, nonatomic) NSData *_Nullable alphaBuf; -@property(assign, nonatomic) int alphaStitchMode; +@property(assign, nonatomic) AgoraAlphaStitchMode alphaStitchMode; @property(assign, nonatomic) int cropLeft; @property(assign, nonatomic) int cropTop; @property(assign, nonatomic) int cropRight; @@ -435,8 +435,8 @@ class ExternalVideoFrame { fillAlphaData 该参数仅适用于 BGRA 或 RGBA 格式的视频数据。设置是否提取视频帧中的 Alpha 通道数据并自动填入到 alphaBuffer 中： 对于 BGRA 或 RGBA 格式的视频数据，你可以任选一种方式设置 Alpha 通道数据：
      diff --git a/dita/RTC-NG/API/class_videoframe.dita b/dita/RTC-NG/API/class_videoframe.dita index 827dc09ae50..329f1fbc6e2 100644 --- a/dita/RTC-NG/API/class_videoframe.dita +++ b/dita/RTC-NG/API/class_videoframe.dita @@ -39,9 +39,7 @@ @CalledByNative("I422Buffer") int getStrideU(); @CalledByNative("I422Buffer") int getStrideV(); } - public interface RgbaBuffer extends Buffer { - @CalledByNative("RgbaBuffer") ByteBuffer getData(); - } + public interface RgbaBuffer extends Buffer { @CalledByNative("RgbaBuffer") ByteBuffer getData(); } public interface TextureBuffer extends Buffer { enum Type { OES(GLES11Ext.GL_TEXTURE_EXTERNAL_OES), @@ -295,7 +293,7 @@ @property (nonatomic, assign) int avSyncType; @property(assign, nonatomic) CVPixelBufferRef _Nullable pixelBuffer; @property (nonatomic, assign) uint8_t* _Nullable alphaBuffer; -@property (nonatomic, assign) int alphaStitchMode; +@property (nonatomic, assign) AgoraAlphaStitchMode alphaStitchMode; @property(nonatomic, strong) NSDictionary *_Nonnull metaInfo; @end struct VideoFrame { @@ -730,13 +728,13 @@ class VideoFrame { alphaStitchMode - 当视频帧中包含 Alpha 通道数据时，设置 alphaBuffer 和视频帧的相对位置： -
        -
      • 0：（默认）仅视频帧，即 alphaBuffer 不和视频帧拼接。
        • -
      • 1：alphaBuffer 位于视频帧的上方。
        • -
      • 2：alphaBuffer 位于视频帧的下方。
        • -
      • 3：alphaBuffer 位于视频帧的左侧。
        • -
      • 4：alphaBuffer 位于视频帧的右侧。
        • + 当视频帧中包含 Alpha 通道数据时，设置 alphaBuffer 和视频帧的相对位置。详见 。 +
          +
        • (0)：（默认）仅视频帧，即 alphaBuffer 不和视频帧拼接。
          • +
        • (1)：alphaBuffer 位于视频帧的上方。
          • +
        • (2)：alphaBuffer 位于视频帧的下方。
          • +
        • (3)：alphaBuffer 位于视频帧的左侧。
          • +
        • (4)：alphaBuffer 位于视频帧的右侧。
         diff --git a/dita/RTC-NG/API/enum_alphastitchmode.dita b/dita/RTC-NG/API/enum_alphastitchmode.dita new file mode 100644 index 00000000000..80e9845abf7 --- /dev/null +++ b/dita/RTC-NG/API/enum_alphastitchmode.dita @@ -0,0 +1,40 @@ + + + + <ph keyref="ALPHA_STITCH_MODE"/> + alphaBuffer 和视频帧的相对位置。 + +
        +
        + +
        自从
        +
        v4.4.0
        +         +
        +
        +
        + 枚举值 + + + + 0：（默认）仅视频帧，即 alphaBuffer 不和视频帧拼接。 + + + + 1：alphaBuffer 位于视频帧的上方。 + + + + 2：alphaBuffer 位于视频帧的下方。 + + + + 3：alphaBuffer 位于视频帧的左侧。 + + + + 4：alphaBuffer 位于视频帧的右侧。 + + +
        +         diff --git a/dita/RTC-NG/API/rtc_api_overview.dita b/dita/RTC-NG/API/rtc_api_overview.dita index 2a1fc6a3ed7..d48f3117e99 100644 --- a/dita/RTC-NG/API/rtc_api_overview.dita +++ b/dita/RTC-NG/API/rtc_api_overview.dita @@ -2648,14 +2648,6 @@ 方法/回调 描述 - - - - - - - - diff --git a/dita/RTC-NG/API/rtc_api_sunset.dita b/dita/RTC-NG/API/rtc_api_sunset.dita index b66c1b5a890..dfe6b9b31d3 100644 --- a/dita/RTC-NG/API/rtc_api_sunset.dita +++ b/dita/RTC-NG/API/rtc_api_sunset.dita @@ -190,33 +190,23 @@ - + API 描述 替代 API 删除版本 - - setVideoProfile - 设置视频编码配置。 - - v4.4.0 - - - setVideoProfile [1/2] + + + + setVideoProfilesetVideoProfile:profile:swapWidthAndHeight: 设置视频编码配置。 v4.4.0 - - setVideoProfile [2/2] - 手动设置视频编码配置。 - - v4.4.0 - - setRemoteRenderMode [1/2] + setRemoteRenderMode(userId, renderMode)setRemoteRenderMode:uid:mode: 设置远端视图显示模式。 v4.4.0 @@ -233,14 +223,8 @@ Android 原生的 。 v4.4.0 - - openWithCustomSource - 打开自定义媒体资源文件。 - - v4.4.0 - - - openWithCustomSourceAtStartPos + + openWithCustomSourceopenWithCustomSourceAtStartPos 打开自定义媒体资源文件。 v4.4.0 @@ -248,29 +232,17 @@ setVideoQualityParameters 设置视频优化选项（仅适用于直播）。 - 建议使用 类中的 degradationPreference 参数设置视频质量偏好。 - v4.4.0 - - - startEchoTest [1/3] - 开始语音通话回路测试。 - - v4.4.0 - - - startEchoTest - 开始语音通话回路测试。 - + 使用 类中的 degradationPreference 参数 v4.4.0 - - startEchoTest [2/3] + + startEchoTest()startEchoTest 开始语音通话回路测试。 v4.4.0 - - startEchoTestWithInterval + + startEchoTest(intervalInSeconds)startEchoTestWithInterval 开始语音通话回路测试。 v4.4.0 @@ -287,63 +259,33 @@ v4.4.0 - - onExtensionEvent - 插件事件回调。 - - v4.4.0 - - - onEvent + + onExtensionEventonEvent 插件事件回调。 v4.4.0 - - onExtensionStarted - 插件启用回调。 - - v4.4.0 - - - onStarted + + onExtensionStartedonStarted 插件启用回调。 v4.4.0 - - onExtensionStopped - 插件禁用回调。 - - v4.4.0 - - - onStopped + + onExtensionStoppedonStopped 插件禁用回调。 v4.4.0 - - onExtensionError - 插件出错回调。 - - v4.4.0 - - - onError + + onExtensionErroronError 插件出错回调。 v4.4.0 - - - - - - - + - \ No newline at end of file + diff --git a/dita/RTC-NG/API/rtc_lite_api.dita b/dita/RTC-NG/API/rtc_lite_api.dita index c25820a0ce3..4f98a9b05b6 100644 --- a/dita/RTC-NG/API/rtc_lite_api.dita +++ b/dita/RTC-NG/API/rtc_lite_api.dita @@ -28,8 +28,6 @@
        • -
        • -
        • @@ -111,9 +109,17 @@
        • -
        • +
      • 在 中，以下跟屏幕采集相关的参数设置无效： +
          +
        • publishScreenCaptureVideo
          • +
        • publishScreenCaptureAudio
          • +
        • -
        • +
      • 在 中，以下跟屏幕采集相关的参数设置无效： +
          +
        • publishScreenCaptureVideo
          • +
        • publishScreenCaptureAudio
          • +
        • @@ -218,8 +224,6 @@
        • -
        • -
        • @@ -255,7 +259,6 @@
        • -
        • @@ -276,7 +279,6 @@
        • -
        • @@ -320,14 +322,13 @@
        • -
      • 中，以下跟屏幕采集相关的参数设置无效： +
      • 在 中，以下跟屏幕采集相关的参数设置无效：
        • publishScreenCaptureVideo
        • publishScreenCaptureAudio
        • -
        • @@ -378,7 +379,7 @@
        • -
      • 中，以下跟屏幕采集相关的参数设置无效： +
      • 在 中，以下跟屏幕采集相关的参数设置无效：
        • publishScreenCaptureVideo
        • publishScreenCaptureAudio
          • @@ -512,7 +513,6 @@
          • -
          • @@ -535,7 +535,6 @@
          • -
          • diff --git a/dita/RTC-NG/RTC_NG_API_Android.ditamap b/dita/RTC-NG/RTC_NG_API_Android.ditamap index 18f38397800..828d4a19a6e 100644 --- a/dita/RTC-NG/RTC_NG_API_Android.ditamap +++ b/dita/RTC-NG/RTC_NG_API_Android.ditamap @@ -251,7 +251,6 @@ - @@ -351,13 +350,10 @@ - - - @@ -460,7 +456,6 @@ - @@ -718,8 +713,6 @@ - - @@ -728,8 +721,6 @@ - - diff --git a/dita/RTC-NG/RTC_NG_API_CPP.ditamap b/dita/RTC-NG/RTC_NG_API_CPP.ditamap index 950d45c10fb..e7f27c551b8 100644 --- a/dita/RTC-NG/RTC_NG_API_CPP.ditamap +++ b/dita/RTC-NG/RTC_NG_API_CPP.ditamap @@ -464,7 +464,6 @@ - @@ -786,8 +785,6 @@ - - @@ -796,8 +793,6 @@ - - diff --git a/dita/RTC-NG/RTC_NG_API_iOS.ditamap b/dita/RTC-NG/RTC_NG_API_iOS.ditamap index b6de10ba006..47fe0be1f55 100644 --- a/dita/RTC-NG/RTC_NG_API_iOS.ditamap +++ b/dita/RTC-NG/RTC_NG_API_iOS.ditamap @@ -256,9 +256,7 @@ - - @@ -364,7 +362,6 @@ - @@ -463,7 +460,6 @@ - @@ -713,8 +709,6 @@ - - @@ -722,8 +716,6 @@ - - diff --git a/dita/RTC-NG/RTC_NG_API_macOS.ditamap b/dita/RTC-NG/RTC_NG_API_macOS.ditamap index 639dbed2d14..29f437107bb 100644 --- a/dita/RTC-NG/RTC_NG_API_macOS.ditamap +++ b/dita/RTC-NG/RTC_NG_API_macOS.ditamap @@ -250,10 +250,8 @@ - - @@ -357,7 +355,6 @@ - @@ -449,7 +446,6 @@ - @@ -657,8 +653,6 @@ - - @@ -666,8 +660,6 @@ - - diff --git a/dita/RTC-NG/API/api_imediaplayer_openwithcustomsource.dita b/dita/RTC-NG/archive/api_imediaplayer_openwithcustomsource.dita similarity index 100% rename from dita/RTC-NG/API/api_imediaplayer_openwithcustomsource.dita rename to dita/RTC-NG/archive/api_imediaplayer_openwithcustomsource.dita diff --git a/dita/RTC-NG/API/api_irtcengine_createrendererview.dita b/dita/RTC-NG/archive/api_irtcengine_createrendererview.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_createrendererview.dita rename to dita/RTC-NG/archive/api_irtcengine_createrendererview.dita diff --git a/dita/RTC-NG/API/api_irtcengine_createtextureview.dita b/dita/RTC-NG/archive/api_irtcengine_createtextureview.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_createtextureview.dita rename to dita/RTC-NG/archive/api_irtcengine_createtextureview.dita diff --git a/dita/RTC-NG/API/api_irtcengine_setencryptionmode.dita b/dita/RTC-NG/archive/api_irtcengine_setencryptionmode.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_setencryptionmode.dita rename to dita/RTC-NG/archive/api_irtcengine_setencryptionmode.dita diff --git a/dita/RTC-NG/API/api_irtcengine_setencryptionsecret.dita b/dita/RTC-NG/archive/api_irtcengine_setencryptionsecret.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_setencryptionsecret.dita rename to dita/RTC-NG/archive/api_irtcengine_setencryptionsecret.dita diff --git a/dita/RTC-NG/API/api_irtcengine_setremoterendermode.dita b/dita/RTC-NG/archive/api_irtcengine_setremoterendermode.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_setremoterendermode.dita rename to dita/RTC-NG/archive/api_irtcengine_setremoterendermode.dita diff --git a/dita/RTC-NG/API/api_irtcengine_setvideoprofile.dita b/dita/RTC-NG/archive/api_irtcengine_setvideoprofile.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_setvideoprofile.dita rename to dita/RTC-NG/archive/api_irtcengine_setvideoprofile.dita diff --git a/dita/RTC-NG/API/api_irtcengine_setvideoqualityparameters.dita b/dita/RTC-NG/archive/api_irtcengine_setvideoqualityparameters.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_setvideoqualityparameters.dita rename to dita/RTC-NG/archive/api_irtcengine_setvideoqualityparameters.dita diff --git a/dita/RTC-NG/API/api_irtcengine_startechotest.dita b/dita/RTC-NG/archive/api_irtcengine_startechotest.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_startechotest.dita rename to dita/RTC-NG/archive/api_irtcengine_startechotest.dita diff --git a/dita/RTC-NG/API/api_irtcengine_startechotest2.dita b/dita/RTC-NG/archive/api_irtcengine_startechotest2.dita similarity index 100% rename from dita/RTC-NG/API/api_irtcengine_startechotest2.dita rename to dita/RTC-NG/archive/api_irtcengine_startechotest2.dita 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 d958b478e3a..9590b0026eb 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap @@ -873,13 +873,6 @@ - - - - openWithCustomSource - - - @@ -2574,24 +2567,10 @@ - - - - startEchoTest [1/3] - - - - - - - startEchoTest [2/3] - - - - startEchoTest [3/3] + startEchoTest @@ -3004,20 +2983,6 @@ - - - - setEncryptionMode - - - - - - - setEncryptionSecret - - - @@ -5913,6 +5878,48 @@ + + + + ALPHA_STITCH_MODE + + + + + + + NO_ALPHA_STITCH + + + + + + + ALPHA_STITCH_UP + + + + + + + ALPHA_STITCH_BELOW + + + + + + + ALPHA_STITCH_LEFT + + + + + + + ALPHA_STITCH_RIGHT + + + diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap index b7d717a85c0..cd725f593a0 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap @@ -775,13 +775,6 @@ - - - - openWithCustomSourceAtStartPos - - - @@ -1038,13 +1031,6 @@ - - - - setVideoQualityParameters - - - @@ -1087,17 +1073,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1157,17 +1136,10 @@ - - - - setVideoProfile [1/2] - - - - setVideoProfile [2/2] + setVideoProfile @@ -2453,20 +2425,6 @@ - - - - startEchoTest - - - - - - - startEchoTestWithInterval - - - @@ -2909,13 +2867,6 @@ - - - - setEncryptionMode - - - @@ -2923,13 +2874,6 @@ - - - - setEncryptionSecret - - - @@ -5464,6 +5408,48 @@ + + + + AgoraAlphaStitchMode + + + + + + + AgoraNoAlphaStitch + + + + + + + AgoraAlphaStitchUp + + + + + + + AgoraAlphaStitchBelow + + + + + + + AgoraAlphaStitchLeft + + + + + + + AgoraAlphaStitchRight + + + diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap index 2a322f05dfe..bdb5cc17bf3 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap @@ -774,13 +774,6 @@ - - - - openWithCustomSource - - - @@ -1058,17 +1051,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1079,20 +1065,6 @@ - - - - CreateRendererView - - - - - - - CreateTextureView - - - @@ -1149,13 +1121,6 @@ - - - - setVideoProfile - - - @@ -2706,24 +2671,10 @@ - - - - startEchoTest [1/3] - - - - - - - startEchoTest [2/3] - - - - startEchoTest [3/3] + startEchoTest @@ -3159,20 +3110,6 @@ - - - - setEncryptionMode - - - - - - - setEncryptionSecret - - - @@ -5743,6 +5680,41 @@ + + + + VIDEO_NO_ALPHA_STITCH + + + + + + + VIDEO_ALPHA_STITCH_UP + + + + + + + VIDEO_ALPHA_STITCH_BELOW + + + + + + + VIDEO_ALPHA_STITCH_LEFT + + + + + + + VIDEO_ALPHA_STITCH_RIGHT + + + 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 87f2e3b1e1a..9a13b510c1d 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap @@ -732,13 +732,6 @@ - - - - openWithCustomSourceAtStartPos - - - @@ -995,13 +988,6 @@ - - - - setVideoQualityParameters - - - @@ -1044,17 +1030,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1114,17 +1093,10 @@ - - - - setVideoProfile [1/2] - - - - setVideoProfile [2/2] + setVideoProfile @@ -2420,20 +2392,6 @@ - - - - startEchoTest - - - - - - - startEchoTestWithInterval - - - @@ -2855,13 +2813,6 @@ - - - - setEncryptionMode - - - @@ -2869,13 +2820,6 @@ - - - - setEncryptionSecret - - - @@ -5036,6 +4980,48 @@ + + + + AgoraAlphaStitchMode + + + + + + + AgoraNoAlphaStitch + + + + + + + AgoraAlphaStitchUp + + + + + + + AgoraAlphaStitchBelow + + + + + + + AgoraAlphaStitchLeft + + + + + + + AgoraAlphaStitchRight + + + diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap index ac4c31f9bb3..6a70cb45ff8 100644 --- a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap +++ b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap @@ -2219,8 +2219,6 @@ - - @@ -2420,8 +2418,6 @@ - - @@ -2459,7 +2455,6 @@ - @@ -2481,10 +2476,8 @@ - - @@ -2495,8 +2488,6 @@ - - @@ -2760,7 +2751,6 @@ - diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita index 48c1390fae9..7460746fbd7 100644 --- a/dita/RTC-NG/release/release_notes.dita +++ b/dita/RTC-NG/release/release_notes.dita @@ -10,10 +10,10 @@ 升级必看 -

          该版本对部分功能的实现方式进行了优化，包括 SDK 的行为变更、API 的改名或删除，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。 +

          该版本对部分功能的实现方式进行了优化，包括 SDK 的行为变更、API 的改名或删除，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。 自 v4.4.0 起，RTC SDK 提供 API 下架说明，包含各版本废弃及删除的 API 信息。详见 API 下架说明API 下架说明API 下架说明API 下架说明。

            -
          1. 为区分不同插件回调中的上下文信息，该版本将原有的插件相关回调删除并新增可标识插件上下文信息的对应回调（见下表），你可以通过各回调中的 了解插件的名称、使用该插件的用户 ID、和提供插件的服务商名等信息。 +
          2. 为区分不同插件回调中的上下文信息，该版本将原有的插件相关回调删除并新增可标识插件上下文信息的对应回调（见下表），你可以通过各回调中的 了解插件的名称、使用该插件的用户 ID、和提供插件的服务商名等信息。 原有回调 @@ -38,8 +38,8 @@
          3. 在 v4.4.0 之前，当你的用户角色为观众时，调用 将音频场景设为聊天室场景（）会收到申请麦克风权限的弹窗提示。自 v4.4.0 起，SDK 通过 iOS 原生的 API 控制麦克风开关，因此观众角色在聊天室场景下不会再收到申请麦克风权限的弹窗。
            4. -
          4. 改版本将 receiveMetadata 回调改名为 ，并删除了回调中的 data、timeStamp 参数，你可以通过新增的 metadata 参数来获取 Metadata 的相关信息，包括 timeStamp（发送数据的时间戳）、uid（用户 ID）、channelId（源频道名称）等。
            5. -
          5. 改版本删除了 回调中的 buffer、uid、timeStampMs 参数，你可以通过新增的 metadata 参数来获取 Metadata 的相关信息，包括 timeStampMs（发送数据的时间戳）、uid（用户 ID）、channelId（源频道名称）等。
            6. +
          6. 改版本将 receiveMetadata 回调改名为 ，并删除了回调中的 data、timeStamp 参数，你可以通过新增的 metadata 参数来获取 Metadata 的相关信息，包括 timeStamp（发送数据的时间戳）、uid（用户 ID）、channelId（源频道名称）等。
            7. +
          7. 改版本删除了 回调中的 buffer、uid、timeStampMs 参数，你可以通过新增的 metadata 参数来获取 Metadata 的相关信息，包括 timeStampMs（发送数据的时间戳）、uid（用户 ID）、channelId（源频道名称）等。
           @@ -50,7 +50,7 @@
        • Lite SDK

          自该版本起，声网推出 Lite 版 SDK，该 SDK 中仅包含音视频基础能力、对高阶音视频处理的功能进行部分裁剪，可有效减少集成 SDK 后的 App 体积。

            -
          • Lite SDK 支持手动集成或三方仓库集成，详见 和 。
            • +
          • Lite SDK 支持手动集成或三方仓库集成，详见和。
          • Lite SDK 包含的动态库信息详见。
          • Lite SDK 支持的 API 清单详见 Lite SDK API 列表Lite SDK API 列表。
          • @@ -92,14 +92,12 @@
        • 其他改进

          该版本还进行了如下改进：

            -
          • 优化了传输策略，调用 不再对传输链路的安全性产生影响。
            • -
          • 回调中新增 枚举，表示进行屏幕采集的显示器已断开连接。(Windows, macOS)
            • -
          • 优化了共享窗口的视频链路，降低了 CPU 占用率。(macOS)
          • 优化了屏幕共享场景下的回声消除。
            • -
          • 该版本在 中新增 channelId 参数，用于获取发送 Metadata 的源频道名称。
            • +
          • 该版本在 中新增 channelId 参数，用于获取发送 Metadata 的源频道名称。
            • +
          • 废弃了 中的冗余枚举值 、。
          • 优化了以下 API 的参数类型。此改进有助于提升代码的可读性，减少潜在的错误，并便于后续维护。
            • 废弃了 option 参数为 int 类型的 ，新增了 option 参数为 类型的重载函数 。
            • 废弃了 streamType 参数为 int 类型的 、、，新增了 streamType 参数为 类型的重载函数 、、。
            • diff --git a/en-US/dita/RTC-NG/API/class_externalvideoframe.dita b/en-US/dita/RTC-NG/API/class_externalvideoframe.dita index 931f6d3d447..6c15172e256 100644 --- a/en-US/dita/RTC-NG/API/class_externalvideoframe.dita +++ b/en-US/dita/RTC-NG/API/class_externalvideoframe.dita @@ -75,7 +75,7 @@ @property(strong, nonatomic) IMAGE_CLASS * _Nullable image; @property(strong, nonatomic) NSData *_Nullable dataBuf; @property(strong, nonatomic) NSData *_Nullable alphaBuf; -@property(assign, nonatomic) int alphaStitchMode; +@property(assign, nonatomic) AgoraAlphaStitchMode alphaStitchMode; @property(assign, nonatomic) int cropLeft; @property(assign, nonatomic) int cropTop; @property(assign, nonatomic) int cropRight; diff --git a/en-US/dita/RTC-NG/API/class_videoframe.dita b/en-US/dita/RTC-NG/API/class_videoframe.dita index d6540955825..759f0db91d7 100644 --- a/en-US/dita/RTC-NG/API/class_videoframe.dita +++ b/en-US/dita/RTC-NG/API/class_videoframe.dita @@ -39,9 +39,7 @@ @CalledByNative("I422Buffer") int getStrideU(); @CalledByNative("I422Buffer") int getStrideV(); } - public interface RgbaBuffer extends Buffer { - @CalledByNative("RgbaBuffer") ByteBuffer getData(); - } + public interface RgbaBuffer extends Buffer { @CalledByNative("RgbaBuffer") ByteBuffer getData(); } public interface TextureBuffer extends Buffer { enum Type { OES(GLES11Ext.GL_TEXTURE_EXTERNAL_OES), @@ -295,7 +293,7 @@ @property (nonatomic, assign) int avSyncType; @property(assign, nonatomic) CVPixelBufferRef _Nullable pixelBuffer; @property (nonatomic, assign) uint8_t* _Nullable alphaBuffer; -@property (nonatomic, assign) int alphaStitchMode; +@property (nonatomic, assign) AgoraAlphaStitchMode alphaStitchMode; @property(nonatomic, strong) NSDictionary *_Nonnull metaInfo; @end struct VideoFrame { diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap index d958b478e3a..9590b0026eb 100644 --- a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap +++ b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap @@ -873,13 +873,6 @@ - - - - openWithCustomSource - - - @@ -2574,24 +2567,10 @@ - - - - startEchoTest [1/3] - - - - - - - startEchoTest [2/3] - - - - startEchoTest [3/3] + startEchoTest @@ -3004,20 +2983,6 @@ - - - - setEncryptionMode - - - - - - - setEncryptionSecret - - - @@ -5913,6 +5878,48 @@ + + + + ALPHA_STITCH_MODE + + + + + + + NO_ALPHA_STITCH + + + + + + + ALPHA_STITCH_UP + + + + + + + ALPHA_STITCH_BELOW + + + + + + + ALPHA_STITCH_LEFT + + + + + + + ALPHA_STITCH_RIGHT + + + diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap index b7d717a85c0..cd725f593a0 100644 --- a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap +++ b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap @@ -775,13 +775,6 @@ - - - - openWithCustomSourceAtStartPos - - - @@ -1038,13 +1031,6 @@ - - - - setVideoQualityParameters - - - @@ -1087,17 +1073,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1157,17 +1136,10 @@ - - - - setVideoProfile [1/2] - - - - setVideoProfile [2/2] + setVideoProfile @@ -2453,20 +2425,6 @@ - - - - startEchoTest - - - - - - - startEchoTestWithInterval - - - @@ -2909,13 +2867,6 @@ - - - - setEncryptionMode - - - @@ -2923,13 +2874,6 @@ - - - - setEncryptionSecret - - - @@ -5464,6 +5408,48 @@ + + + + AgoraAlphaStitchMode + + + + + + + AgoraNoAlphaStitch + + + + + + + AgoraAlphaStitchUp + + + + + + + AgoraAlphaStitchBelow + + + + + + + AgoraAlphaStitchLeft + + + + + + + AgoraAlphaStitchRight + + + diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap index 2a322f05dfe..bdb5cc17bf3 100644 --- a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap +++ b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap @@ -774,13 +774,6 @@ - - - - openWithCustomSource - - - @@ -1058,17 +1051,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1079,20 +1065,6 @@ - - - - CreateRendererView - - - - - - - CreateTextureView - - - @@ -1149,13 +1121,6 @@ - - - - setVideoProfile - - - @@ -2706,24 +2671,10 @@ - - - - startEchoTest [1/3] - - - - - - - startEchoTest [2/3] - - - - startEchoTest [3/3] + startEchoTest @@ -3159,20 +3110,6 @@ - - - - setEncryptionMode - - - - - - - setEncryptionSecret - - - @@ -5743,6 +5680,41 @@ + + + + VIDEO_NO_ALPHA_STITCH + + + + + + + VIDEO_ALPHA_STITCH_UP + + + + + + + VIDEO_ALPHA_STITCH_BELOW + + + + + + + VIDEO_ALPHA_STITCH_LEFT + + + + + + + VIDEO_ALPHA_STITCH_RIGHT + + + diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap index 87f2e3b1e1a..9a13b510c1d 100644 --- a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap +++ b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap @@ -732,13 +732,6 @@ - - - - openWithCustomSourceAtStartPos - - - @@ -995,13 +988,6 @@ - - - - setVideoQualityParameters - - - @@ -1044,17 +1030,10 @@ - - - - setRemoteRenderMode [1/2] - - - - setRemoteRenderMode [2/2] + setRemoteRenderMode @@ -1114,17 +1093,10 @@ - - - - setVideoProfile [1/2] - - - - setVideoProfile [2/2] + setVideoProfile @@ -2420,20 +2392,6 @@ - - - - startEchoTest - - - - - - - startEchoTestWithInterval - - - @@ -2855,13 +2813,6 @@ - - - - setEncryptionMode - - - @@ -2869,13 +2820,6 @@ - - - - setEncryptionSecret - - - @@ -5036,6 +4980,48 @@ + + + + AgoraAlphaStitchMode + + + + + + + AgoraNoAlphaStitch + + + + + + + AgoraAlphaStitchUp + + + + + + + AgoraAlphaStitchBelow + + + + + + + AgoraAlphaStitchLeft + + + + + + + AgoraAlphaStitchRight + + +