From 2d2a6b67ea158301bb9db70ab50f6fac13936e08 Mon Sep 17 00:00:00 2001
From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com>
Date: Fri, 27 Sep 2024 17:05:23 +0800
Subject: [PATCH] New translations

---
 .../api_irtcengine_destroymediarecorder.dita  |   2 +-
 .../RTC-NG/API/api_irtcengine_renewtoken.dita |   7 -
 .../API/api_irtcengineex_leavechannelex.dita  |   2 +-
 .../API/api_irtcengineex_leavechannelex2.dita |   4 +-
 ...ngineeventhandler_onclientrolechanged.dita |   2 +
 ...neeventhandler_onrejoinchannelsuccess.dita |   2 +
 en-US/dita/RTC-NG/API/rtc_api_sunset.dita     | 154 +++++++++++++++++-
 7 files changed, 160 insertions(+), 13 deletions(-)

diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_destroymediarecorder.dita b/en-US/dita/RTC-NG/API/api_irtcengine_destroymediarecorder.dita
index f8507be2bb4..58b42db9dd1 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_destroymediarecorder.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_destroymediarecorder.dita
@@ -39,7 +39,7 @@
             <parml>
             <plentry>
                 <pt>mediaRecorder</pt>
-                <pd>The recording object to be destroyed.</pd>
+                <pd>待销毁的 <xref keyref="IMediaRecorder" /> 对象。</pd>
             </plentry>
             </parml> </section>
         <section id="return_values" conkeyref="setMediaRecorderObserver/return_values"> </section>
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_renewtoken.dita b/en-US/dita/RTC-NG/API/api_irtcengine_renewtoken.dita
index 8ffef744b4e..31aaeb73a70 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_renewtoken.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_renewtoken.dita
@@ -39,13 +39,6 @@
             <title>Restrictions</title>
             <p>None.</p>
         </section>
-        <section id="related" deliveryTarget="details">
-            <title>Related callbacks</title>
-            <ul><li><xref keyref="onTokenPrivilegeWillExpire"/></li>
-                 <li><xref keyref="onRequestToken"/></li>
-                <li><xref keyref="onConnectionStateChanged"/></li>
-                </ul>
-        </section>
         <section id="parameters" deliveryTarget="details">
             <title>Parameters</title>
             <parml>
diff --git a/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex.dita b/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex.dita
index cb8c9e903ea..7f8fe84932d 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex.dita
@@ -33,7 +33,7 @@
             <note type="attention">
                 <ul>
                     <li>This method call is asynchronous. When this method returns, it does not necessarily mean that the user has left the channel.</li>
-                    <li>If you call <xref keyref="leaveChannel"/> or <xref keyref="leaveChannel2"/>, you will leave all the channels you have joined by calling <xref keyref="joinChannel1"/>, <xref keyref="joinChannel2"/>, or <xref keyref="joinChannelEx"/>.</li>
+                    <li>If you call<xref keyref="leaveChannel"/>  or<xref keyref="leaveChannel2"/> , you will leave<xref keyref="joinChannel1"/> all the channels you have joined by calling ,<xref keyref="joinChannelEx"/> , or<xref keyref="joinChannel2"/> .</li>
                 </ul></note>
         </section>
         <section id="scenario" deliveryTarget="details">
diff --git a/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex2.dita b/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex2.dita
index 5728d019b0a..8583c716375 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex2.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengineex_leavechannelex2.dita
@@ -41,8 +41,8 @@
             <note type="attention">
                 <ul>
                     <li>This method call is asynchronous. When this method returns, it does not necessarily mean that the user has left the channel.</li>
-                    <li props="native unity cs unreal">If you call <xref keyref="leaveChannel"/> or <xref keyref="leaveChannel2"/>, you will leave all the channels you have joined by calling <xref keyref="joinChannel1"/>, <xref keyref="joinChannel2"/>, or <xref keyref="joinChannelEx"/>.</li>
-                    <li props="flutter electron rn bp">If you call <xref keyref="leaveChannel2"/>, you will leave all the channels you have joined by calling <xref keyref="joinChannel2"/> or <xref keyref="joinChannelEx"/>.</li>
+                    <li props="native unity cs unreal">If you call<xref keyref="leaveChannel"/>  or<xref keyref="leaveChannel2"/> , you will leave<xref keyref="joinChannel1"/> all the channels you have joined by calling ,<xref keyref="joinChannelEx"/> , or<xref keyref="joinChannel2"/> .</li>
+                    <li props="flutter electron rn bp">If you call<xref keyref="leaveChannel2"/> , you will leave<xref keyref="joinChannel2"/> all the channels you have joined by calling  or<xref keyref="joinChannelEx"/> .</li>
                 </ul></note>
             </section>
             <section id="scenario" deliveryTarget="details" conkeyref="leaveChannelEx/scenario">
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
index 4ca3440040a..115fd773e31 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
@@ -39,6 +39,8 @@ NS_SWIFT_NAME(rtcEngine(_:didClientRoleChanged:newRole:newRoleOptions:));</codeb
       ClientRoleOptions newRoleOptions)? onClientRoleChanged;</codeblock>
             <codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
         </section>
+        <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
+        </section>
         <section id="timing" deliveryTarget="details">
             <title>Trigger timing</title>
             <p props="native cs unity unreal">This callback will be triggered in any of the following situations:<ul>
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrejoinchannelsuccess.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrejoinchannelsuccess.dita
index 3cd440b0c7a..971e4d41d1d 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrejoinchannelsuccess.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrejoinchannelsuccess.dita
@@ -31,6 +31,8 @@
       onRejoinChannelSuccess;</codeblock>
             <codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
         </section>
+        <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
+        </section>
         <section id="timing" deliveryTarget="details">
             <title>Trigger timing</title>
             <p id="desc">When a user loses connection with the server because of network problems, the SDK automatically tries to reconnect and triggers this callback upon reconnection.</p>
diff --git a/en-US/dita/RTC-NG/API/rtc_api_sunset.dita b/en-US/dita/RTC-NG/API/rtc_api_sunset.dita
index fea1d4927e9..e62d3efdcd7 100644
--- a/en-US/dita/RTC-NG/API/rtc_api_sunset.dita
+++ b/en-US/dita/RTC-NG/API/rtc_api_sunset.dita
@@ -7,7 +7,7 @@
             <title>Deprecated APIs</title>
             <p>The deprecated APIs are expected to be officially deleted in approximately one year. Agora recommends that you promptly replace them with the recommended APIs to avoid any impact on your online services.</p>
             <!--如果预见到表格内的内容会超宽，则在 table 外侧套一个 div，用于限定 section 内的表格宽度-->
-                <div>
+            <div>
                 <table frame="all" rowsep="1" colsep="1" props="cn">
                 <!--CN 表格-->
                 <!--由于 table 中的 row 不能分级打 props，所以 cn 和 en 需要分两个表格维护：仅发 cn/en 的 API 只需要在对应表格中增加；cn 和 en 都发的 API 需要在两个表格中都加。-->
@@ -103,6 +103,18 @@
                             <entry><xref keyref="createDataStreamEx2"/></entry>
                             <entry>v4.0.0</entry>
                         </row>
+                        <row props="android">
+                            <entry><xref keyref="pushVideoFrame"/></entry>
+                            <entry><ph conkeyref="pushVideoFrame/shortdesc"/></entry>
+                            <entry><xref keyref="pushVideoFrame3"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                        <row props="android">
+                            <entry><xref keyref="pushVideoFrame2"/></entry>
+                            <entry><ph conkeyref="pushVideoFrame2/shortdesc"/></entry>
+                            <entry><xref keyref="pushVideoFrame4"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
                         <row>
                             <entry><xref keyref="setLocalVideoMirrorMode"/></entry>
                             <entry><ph conkeyref="setLocalVideoMirrorMode/shortdesc"/></entry>
@@ -127,6 +139,12 @@
                             <entry>使用 <xref keyref="initialize"/> 中的 <parmname props="cpp">context</parmname><parmname props="android apple">config</parmname> 参数</entry>
                             <entry>v4.0.0</entry>
                         </row>
+                            <row>
+                                <entry><xref keyref="setLogFilter"/></entry>
+                                <entry><ph conkeyref="setLogFilter/shortdesc"/></entry>
+                                <entry>使用 <xref keyref="initialize"/> 中的 <parmname props="cpp">context</parmname><parmname props="android apple">config</parmname> 参数</entry>
+                                <entry>v4.0.0</entry>
+                            </row>
                         <row>
                             <entry><xref keyref="setLogFile"/></entry>
                             <entry><ph conkeyref="setLogFile/shortdesc"/></entry>
@@ -151,6 +169,12 @@
                             <entry><xref keyref="setAudioProfile2"/> or <xref keyref="setAudioScenario"/></entry>
                             <entry>v4.0.0</entry>
                         </row>
+                            <row>
+                                <entry><xref keyref="startAudioMixing"/></entry>
+                                <entry><ph conkeyref="startAudioMixing/shortdesc"/></entry>
+                                <entry><xref keyref="startAudioMixing2" /></entry>
+                                <entry>v4.0.0</entry>
+                            </row>
                         <row props="android ios cpp">
                             <entry><xref keyref="preload"/></entry>
                             <entry><ph conkeyref="preload/shortdesc"/></entry>
@@ -199,6 +223,48 @@
                             <entry>-</entry>
                             <entry>v4.0.0</entry>
                         </row>
+                        <row>
+                            <entry><xref keyref="onAudioMixingFinished"/></entry>
+                            <entry><ph conkeyref="onAudioMixingFinished/shortdesc"/></entry>
+                            <entry><xref keyref="onAudioMixingStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                        <row>
+                            <entry><xref keyref="onAudioQuality"/></entry>
+                            <entry><ph conkeyref="onAudioQuality/shortdesc"/></entry>
+                            <entry><xref keyref="onRemoteAudioStats"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                         <row>
+                            <entry><xref keyref="onConnectionBanned"/></entry>
+                            <entry><ph conkeyref="onConnectionBanned/shortdesc"/></entry>
+                            <entry><xref keyref="onConnectionStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                         <row>
+                            <entry><xref keyref="onConnectionInterrupted"/></entry>
+                            <entry><ph conkeyref="onConnectionInterrupted/shortdesc"/></entry>
+                            <entry><xref keyref="onConnectionStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                         <row>
+                            <entry><xref keyref="onFirstRemoteAudioFrame"/></entry>
+                            <entry><ph conkeyref="onFirstRemoteAudioFrame/shortdesc"/></entry>
+                            <entry><xref keyref="onRemoteAudioStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                         <row>
+                            <entry><xref keyref="onFirstRemoteAudioDecoded"/></entry>
+                            <entry><ph conkeyref="onFirstRemoteAudioDecoded/shortdesc"/></entry>
+                            <entry><xref keyref="onRemoteAudioStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
+                         <row>
+                            <entry><xref keyref="onRemoteAudioTransportStats"/></entry>
+                            <entry><ph conkeyref="onRemoteAudioTransportStats/shortdesc"/></entry>
+                            <entry><xref keyref="onRemoteAudioStats"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
                         <row>
                             <entry><xref keyref="onRemoteVideoTransportStats"/></entry>
                             <entry><ph conkeyref="onRemoteVideoTransportStats/shortdesc"/></entry>
@@ -211,6 +277,12 @@
                             <entry><xref keyref="onRemoteVideoStateChanged"/></entry>
                             <entry>v4.0.0</entry>
                         </row>
+                        <row>
+                            <entry><xref keyref="onVideoStopped"/></entry>
+                            <entry><ph conkeyref="onVideoStopped/shortdesc"/></entry>
+                            <entry><xref keyref="onLocalVideoStateChanged"/></entry>
+                            <entry>v4.0.0</entry>
+                        </row>
                     </tbody>
                 </tgroup>
             </table>
@@ -305,6 +377,18 @@
                                 <entry><xref keyref="createDataStreamEx2"/></entry>
                                 <entry>v4.0.0</entry>
                             </row>
+                            <row props="android">
+                                <entry><xref keyref="pushVideoFrame"/></entry>
+                                <entry><ph conkeyref="pushVideoFrame/shortdesc"/></entry>
+                                <entry><xref keyref="pushVideoFrame3"/></entry>
+                                <entry>v4.0.0</entry>
+                            </row>
+                            <row props="android">
+                                <entry><xref keyref="pushVideoFrame2"/></entry>
+                                <entry><ph conkeyref="pushVideoFrame2/shortdesc"/></entry>
+                                <entry><xref keyref="pushVideoFrame4"/></entry>
+                                <entry>v4.0.0</entry>
+                            </row>
                             <row>
                                 <entry><xref keyref="setLocalVideoMirrorMode"/></entry>
                                 <entry><ph conkeyref="setLocalVideoMirrorMode/shortdesc"/></entry>
@@ -329,6 +413,12 @@
                                 <entry>使用 <xref keyref="initialize"/> 中的 <parmname props="cpp">context</parmname><parmname props="android apple">config</parmname> 参数</entry>
                                 <entry>v4.0.0</entry>
                             </row>
+                            <row>
+                                <entry><xref keyref="setLogFilter"/></entry>
+                                <entry><ph conkeyref="setLogFilter/shortdesc"/></entry>
+                                <entry>使用 <xref keyref="initialize"/> 中的 <parmname props="cpp">context</parmname><parmname props="android apple">config</parmname> 参数</entry>
+                                <entry>v4.0.0</entry>
+                            </row>
                             <row>
                                 <entry><xref keyref="setLogFile"/></entry>
                                 <entry><ph conkeyref="setLogFile/shortdesc"/></entry>
@@ -353,6 +443,18 @@
                                 <entry><xref keyref="setAudioProfile2"/> or <xref keyref="setAudioScenario"/></entry>
                                 <entry>v4.0.0</entry>
                             </row>
+                            <row>
+                                <entry><xref keyref="startAudioMixing"/></entry>
+                                <entry><ph conkeyref="startAudioMixing/shortdesc"/></entry>
+                                <entry><xref keyref="startAudioMixing2" /></entry>
+                                <entry>v4.0.0</entry>
+                            </row>
+                            <row props="android ios cpp">
+                                <entry><xref keyref="preload"/></entry>
+                                <entry><ph conkeyref="preload/shortdesc"/></entry>
+                                <entry><xref keyref="preload2"/></entry>
+                                <entry>v4.0.0</entry>
+                            </row>
                             <row>
                                 <entry><xref keyref="addVideoWatermark1"/></entry>
                                 <entry><ph conkeyref="addVideoWatermark1/shortdesc"/></entry>
@@ -395,18 +497,66 @@
                                     <entry>-</entry>
                                     <entry>v4.0.0</entry>
                                 </row>
+                                <row>
+                                    <entry><xref keyref="onAudioMixingFinished"/></entry>
+                                    <entry><ph conkeyref="onAudioMixingFinished/shortdesc"/></entry>
+                                    <entry><xref keyref="onAudioMixingStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                <row>
+                                    <entry><xref keyref="onAudioQuality"/></entry>
+                                    <entry><ph conkeyref="onAudioQuality/shortdesc"/></entry>
+                                    <entry><xref keyref="onRemoteAudioStats"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                 <row>
+                                    <entry><xref keyref="onConnectionBanned"/></entry>
+                                    <entry><ph conkeyref="onConnectionBanned/shortdesc"/></entry>
+                                    <entry><xref keyref="onConnectionStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                 <row>
+                                    <entry><xref keyref="onConnectionInterrupted"/></entry>
+                                    <entry><ph conkeyref="onConnectionInterrupted/shortdesc"/></entry>
+                                    <entry><xref keyref="onConnectionStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                 <row>
+                                    <entry><xref keyref="onFirstRemoteAudioFrame"/></entry>
+                                    <entry><ph conkeyref="onFirstRemoteAudioFrame/shortdesc"/></entry>
+                                    <entry><xref keyref="onRemoteAudioStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                 <row>
+                                    <entry><xref keyref="onFirstRemoteAudioDecoded"/></entry>
+                                    <entry><ph conkeyref="onFirstRemoteAudioDecoded/shortdesc"/></entry>
+                                    <entry><xref keyref="onRemoteAudioStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
+                                 <row>
+                                    <entry><xref keyref="onRemoteAudioTransportStats"/></entry>
+                                    <entry><ph conkeyref="onRemoteAudioTransportStats/shortdesc"/></entry>
+                                    <entry><xref keyref="onRemoteAudioStats"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
                                 <row>
                                     <entry><xref keyref="onRemoteVideoTransportStats"/></entry>
                                     <entry><ph conkeyref="onRemoteVideoTransportStats/shortdesc"/></entry>
                                     <entry><xref keyref="onRemoteVideoStats"/></entry>
                                     <entry>v4.0.0</entry>
                                 </row>
-                            <row>
+                                <row>
                                     <entry><xref keyref="onUserEnableLocalVideo"/></entry>
                                     <entry><ph conkeyref="onUserEnableLocalVideo/shortdesc"/></entry>
                                     <entry><xref keyref="onRemoteVideoStateChanged"/></entry>
                                     <entry>v4.0.0</entry>
                                 </row>
+                                <row>
+                                    <entry><xref keyref="onVideoStopped"/></entry>
+                                    <entry><ph conkeyref="onVideoStopped/shortdesc"/></entry>
+                                    <entry><xref keyref="onLocalVideoStateChanged"/></entry>
+                                    <entry>v4.0.0</entry>
+                                </row>
                         </tbody>
                     </tgroup>
                 </table>