Merge pull request #3586 from AgoraIO/release/rtc-ng/4.3.1

Release/rtc ng/4.3.1
AgoraIO · Apr 16, 2024 · b7c5d97 · b7c5d97
2 parents dc41565 + ea025bf
commit b7c5d97
Show file tree

Hide file tree

Showing 20 changed files with 248 additions and 460 deletions.
diff --git a/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita b/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita
@@ -44,7 +44,7 @@
             <ul>
             <li props="cpp apple framework">App 退到后台，系统回收摄像头。</li>
             <li props="cpp unreal bp android unity flutter rn">Android 9 及以上版本，App 切后台一段时间后，系统会收回相机权限。</li>
-            <li props="cpp unreal bp android unity flutter rn">Android 6 及以上版本，如果相机被第三方 App 占用一段时间后释放，则 SDK 会触发该回调，并报告 <codeph><apiname keyref="onLocalVideoStateChanged"/>(<ph keyref="LOCAL_VIDEO_STREAM_STATE_CAPTURING"/>，<ph keyref="LOCAL_VIDEO_STREAM_REASON_OK"/>)</codeph> 回调。</li>
+            <li props="cpp unreal bp android unity flutter rn">Android 6 及以上版本，如果摄像头被第三方 App 占用一段时间后释放，则 SDK 会触发该回调，并报告 <codeph><apiname keyref="onLocalVideoStateChanged"/>(<ph keyref="LOCAL_VIDEO_STREAM_STATE_CAPTURING"/>，<ph keyref="LOCAL_VIDEO_STREAM_REASON_OK"/>)</codeph> 回调。</li>
             <li>摄像头正常启动，但连续 4 秒都没有输出采集的视频。</li>
             </ul></p>
             <p>摄像头输出采集的视频帧时，如果连续 15 帧中，所有视频帧都一样，SDK 触发 <apiname keyref="onLocalVideoStateChanged"/> 回调，状态为 <apiname keyref="LOCAL_VIDEO_STREAM_STATE_CAPTURING"/>，错误码为 <apiname keyref="LOCAL_VIDEO_STREAM_REASON_CAPTURE_FAILURE"/>。注意，帧重复检测仅针对分辨率大于 200 × 200、帧率大于等于 10 fps、码率小于 20 Kbps 的视频帧。</p>

diff --git a/dita/RTC-NG/API/class_channelmediaoptions.dita b/dita/RTC-NG/API/class_channelmediaoptions.dita
@@ -806,7 +806,7 @@ class ChannelMediaOptions {
             <plentry>
                 <pt>audioDelayMs</pt>
                 <pd>
-                    <p>发送音频帧的延时（毫秒）。在视频延迟较大的场景下，你可以通过该参数来设置需要发送的音频帧的延时，以确保音画同步。</p>
+                    <p>发送音频帧的延时（毫秒）。你可以通过该参数来设置需要发送的音频帧的延时，以确保音画同步。</p>
                     <p>如果要关闭延时，将此参数值设置为 0。</p>
                 </pd>
             </plentry>

diff --git a/dita/RTC-NG/API/enum_mediasourcetype.dita b/dita/RTC-NG/API/enum_mediasourcetype.dita
@@ -27,7 +27,7 @@
                     <pt><ph keyref="CUSTOM_VIDEO_SOURCE"/></pt>
                     <pd>6: 自定义采集的视频源。</pd>
             </plentry>
-            <plentry>
+            <plentry props="en">
                     <pt><ph keyref="SPEECH_DRIVEN_VIDEO_SOURCE"/></pt>
                     <pd>13: 视频源为语音驱动插件处理后的视频。</pd>
             </plentry>

diff --git a/dita/RTC-NG/API/enum_videosourcetype.dita b/dita/RTC-NG/API/enum_videosourcetype.dita
@@ -75,7 +75,7 @@
                 <pt><ph keyref="VIDEO_SOURCE_SCREEN_FOURTH"/></pt>
                 <pd>14：<ph props="cpp unreal bp flutter unity">（仅适用于 Windows 和 macOS）</ph><ph>视频源为第四个屏幕。</ph></pd>
             </plentry>
-            <plentry>
+            <plentry props="en">
                 <pt><ph keyref="VIDEO_SOURCE_SPEECH_DRIVEN"/></pt>
                 <pd>15：视频源为语音驱动插件处理后的视频。</pd>
             </plentry>

diff --git a/dita/RTC-NG/API/rtc_api_overview.dita b/dita/RTC-NG/API/rtc_api_overview.dita
@@ -1061,11 +1061,11 @@
                     <stentry><xref keyref="clearVideoWatermarkEx"/></stentry>
                     <stentry><ph conkeyref="clearVideoWatermarkEx/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="en">
                     <stentry><xref keyref="registerFaceInfoObserver"/></stentry>
                     <stentry><ph conkeyref="registerFaceInfoObserver/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="en">
                     <stentry><xref keyref="onFaceInfo"/></stentry>
                     <stentry><ph conkeyref="onFaceInfo/shortdesc"/></stentry>
                 </strow>

diff --git a/dita/RTC-NG/RTC_NG_API_Android.ditamap b/dita/RTC-NG/RTC_NG_API_Android.ditamap
@@ -25,7 +25,7 @@
             <topicref keyref="IAudioSpectrumObserver" toc="no"/>
             <topicref keyref="IBaseSpatialAudioEngine" toc="no"/>
             <topicref keyref="IDirectCdnStreamingEventHandler" toc="no"/>
-            <topicref keyref="IFaceInfoObserver" toc="no"/>
+            <topicref keyref="IFaceInfoObserver" toc="no" props="en"/>
             <topicref keyref="ILocalSpatialAudioEngine" toc="no"/>
             <topicref keyref="IMediaPlayer" toc="no"/>
             <topicref keyref="IMediaPlayerAudioFrameObserver" toc="no"/>
@@ -310,7 +310,7 @@
                     <topicref keyref="enableFaceDetection" toc="no"/>
                     <topicref keyref="onFacePositionChanged" toc="no"/>
                 </topicref>
-                <topicref href="API/toc_speech_driven.dita" chunk="to-content">
+                <topicref href="API/toc_speech_driven.dita" chunk="to-content" props="en">
                     <topicref keyref="registerFaceInfoObserver" toc="no"/>
                     <topicref keyref="onFaceInfo" toc="no"/>
                 </topicref>

diff --git a/dita/RTC-NG/RTC_NG_API_CPP.ditamap b/dita/RTC-NG/RTC_NG_API_CPP.ditamap
@@ -25,7 +25,7 @@
             <topicref keyref="IAudioSpectrumObserver" toc="no"/>
             <topicref keyref="IBaseSpatialAudioEngine" toc="no"/>
             <topicref keyref="IDirectCdnStreamingEventHandler" toc="no"/>
-            <topicref keyref="IFaceInfoObserver" toc="no"/>
+            <topicref keyref="IFaceInfoObserver" toc="no" props="en"/>
             <topicref keyref="ILocalSpatialAudioEngine" toc="no"/>
             <topicref keyref="IMediaEngine" toc="no"/>
             <topicref keyref="IMediaPlayer" toc="no"/>
@@ -320,7 +320,7 @@
                     <topicref keyref="enableFaceDetection" toc="no"/>
                     <topicref keyref="onFacePositionChanged" toc="no"/>
                 </topicref>
-                <topicref href="API/toc_speech_driven.dita" chunk="to-content">
+                <topicref href="API/toc_speech_driven.dita" chunk="to-content" props="en">
                     <topicref keyref="registerFaceInfoObserver" toc="no"/>
                     <topicref keyref="onFaceInfo" toc="no"/>
                 </topicref>

diff --git a/dita/RTC-NG/RTC_NG_API_iOS.ditamap b/dita/RTC-NG/RTC_NG_API_iOS.ditamap
@@ -25,7 +25,7 @@
             <topicref keyref="IAudioSpectrumObserver" toc="no"/>
             <topicref keyref="IBaseSpatialAudioEngine" toc="no"/>
             <topicref keyref="IDirectCdnStreamingEventHandler" toc="no"/>
-            <topicref keyref="IFaceInfoObserver" toc="no"/>
+            <topicref keyref="IFaceInfoObserver" toc="no" props="en"/>
             <topicref keyref="ILocalSpatialAudioEngine" toc="no"/>
             <topicref keyref="IMediaExtensionObserver" toc="no"/>
             <topicref keyref="IMediaPlayer" toc="no"/>
@@ -317,7 +317,7 @@
                     <topicref keyref="enableFaceDetection" toc="no"/>
                     <topicref keyref="onFacePositionChanged" toc="no"/>
                 </topicref>
-                <topicref href="API/toc_speech_driven.dita" chunk="to-content">
+                <topicref href="API/toc_speech_driven.dita" chunk="to-content" props="en">
                     <topicref keyref="registerFaceInfoObserver" toc="no"/>
                     <topicref keyref="onFaceInfo" toc="no"/>
                 </topicref>

diff --git a/dita/RTC-NG/RTC_NG_API_macOS.ditamap b/dita/RTC-NG/RTC_NG_API_macOS.ditamap
@@ -24,7 +24,7 @@
             <topicref keyref="IAudioSpectrumObserver" toc="no"/>
             <topicref keyref="IBaseSpatialAudioEngine" toc="no"/>
             <topicref keyref="IDirectCdnStreamingEventHandler" toc="no"/>
-            <topicref keyref="IFaceInfoObserver" toc="no"/>
+            <topicref keyref="IFaceInfoObserver" toc="no" props="en"/>
             <topicref keyref="ILocalSpatialAudioEngine" toc="no"/>
             <topicref keyref="IMediaExtensionObserver" toc="no"/>
             <topicref keyref="IMediaPlayer" toc="no"/>
@@ -311,7 +311,7 @@
                     <topicref keyref="setVideoDenoiserOptions" toc="no"/>
                     <topicref keyref="setVideoDenoiserOptions2" toc="no"/>
                 </topicref>
-                <topicref href="API/toc_speech_driven.dita" chunk="to-content">
+                <topicref href="API/toc_speech_driven.dita" chunk="to-content" props="en">
                     <topicref keyref="registerFaceInfoObserver" toc="no"/>
                     <topicref keyref="onFaceInfo" toc="no"/>
                </topicref>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
@@ -216,7 +216,7 @@
                 </keywords>
             </topicmeta>
         </keydef>
-        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita">
+        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita" props="en">
             <topicmeta>
                 <keywords>
                     <keyword>IFaceInfoObserver</keyword>
@@ -1295,7 +1295,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita">
+            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>registerFaceInfoObserver</keyword>
@@ -5116,7 +5116,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita">
+            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>onFaceInfo</keyword>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap
@@ -202,7 +202,7 @@
                 </keywords>
             </topicmeta>
         </keydef>
-        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita">
+        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita" props="en">
             <topicmeta>
                 <keywords>
                     <keyword>AgoraFaceInfoDelegate</keyword>
@@ -1258,7 +1258,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita">
+            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>setFaceInfoDelegate</keyword>
@@ -4567,7 +4567,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita">
+            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>onFaceInfo</keyword>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-java.ditamap
@@ -173,7 +173,7 @@
                 </keywords>
             </topicmeta>
         </keydef>
-        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita">
+        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita" props="en">
             <topicmeta>
                 <keywords>
                     <keyword>IFaceInfoObserver</keyword>
@@ -1250,7 +1250,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita">
+            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>registerFaceInfoObserver</keyword>
@@ -4778,7 +4778,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita">
+            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>onFaceInfo</keyword>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
@@ -173,7 +173,7 @@
                 </keywords>
             </topicmeta>
         </keydef>
-        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita">
+        <keydef keys="IFaceInfoObserver" href="../API/class_ifaceinfoobserver.dita" props="en">
             <topicmeta>
                 <keywords>
                     <keyword>AgoraFaceInfoDelegate</keyword>
@@ -1208,7 +1208,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita">
+            <keydef keys="registerFaceInfoObserver" href="../API/api_imediaengine_registerfaceinfoobserver.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>setFaceInfoDelegate</keyword>
@@ -4279,7 +4279,7 @@
                     </keywords>
                 </topicmeta>
             </keydef>
-            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita">
+            <keydef keys="onFaceInfo" href="../API/callback_ifaceinfoobserver_onfaceinfo.dita" props="en">
                 <topicmeta>
                     <keywords>
                         <keyword>onFaceInfo</keyword>

diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
@@ -939,7 +939,7 @@
                 <topicref keyref="EncodedVideoFrameInfo"/>
             </relcell>
         </relrow>
-        <relrow>
+        <relrow props="en">
             <relcell>
                 <topicref keyref="registerFaceInfoObserver"/>
             </relcell>
@@ -2358,7 +2358,7 @@
                 <topicref keyref="registerAudioFrameObserver" props="unity"/>
                 <topicref keyref="registerAudioSpectrumObserver"/>
                 <topicref keyref="registerExtension"/>
-                <topicref keyref="registerFaceInfoObserver" props="android apple"/>
+                <topicref keyref="registerFaceInfoObserver" props="hide"/>
                 <topicref keyref="registerLocalUserAccount"/>
                 <topicref keyref="registerMediaMetadataObserver"/>
                 <topicref keyref="registerPacketObserver" props="cpp unreal bp"/>
@@ -2912,7 +2912,7 @@
                 <topicref keyref="pushEncodedVideoImageEx" props="hide"/>
                 <topicref keyref="pushVideoFrame"/>
                 <topicref keyref="registerAudioFrameObserver"/>
-                <topicref keyref="registerFaceInfoObserver"/>
+                <topicref keyref="registerFaceInfoObserver" props="en"/>
                 <topicref keyref="registerVideoEncodedFrameObserver"/>
                 <topicref keyref="registerVideoFrameObserver"/>
                 <topicref keyref="setExternalAudioSink"/>
@@ -3215,7 +3215,7 @@
                 <topicref keyref="IMusicContentCenterEventHandler"/>
             </relcell>
         </relrow>
-        <relrow>
+        <relrow props="en">
             <relcell>
                 <topicref keyref="onFaceInfo"/>
             </relcell>