4.1.0 bugfix 0209 framework

dita/RTC-NG/API/api_channelmediarelayconfiguration_setdestchannelinfo.dita

@@ -25,7 +25,7 @@
             <codeblock props="electron" outputclass="language-typescript"/>
             <codeblock props="unity" outputclass="language-csharp"/>
             <codeblock props="rn" outputclass="language-typescript"/>
-           <codeblock props="flutter" outputclass="language-dart"/> 
+           <codeblock props="flutter" outputclass="language-dart"/>
             <codeblock props="unreal" outputclass="language-cpp"></codeblock></p>
         </section>
         <section id="parameters">
@@ -39,17 +39,17 @@
                 <pt props="android">destInfo</pt>
                 <pt props="ios mac">destinationInfo</pt>
                 <pd>
-                    <p>目标频道信息 <apiname keyref="ChannelMediaInfo"/>，包含如下成员：                    
+                    <p>目标频道信息 <apiname keyref="ChannelMediaInfo"/>，包含如下成员：
                     <ul>
                     <li> <parmname>channelName</parmname> ：目标频道的频道名。</li>
-                    <li>
-                        <parmname>uid</parmname>：标识目标频道中的转发媒体流的 UID。取值范围为 0 到（2 <sup>32</sup>-1），请确保与目标频道中的所有 UID 不同。默认值为 0，表示 SDK 随机分配一个 UID。</li>
                     <li>
                         <parmname>token</parmname>：能加入目标频道的 <parmname>token</parmname>。由你在 <parmname>destInfos</parmname> 中设置的 <parmname>channelName</parmname> 和 <parmname>uid</parmname> 生成。
                         <ul>
                         <li>如未启用 App Certificate，可直接将该参数设为默认值 <codeph><ph keyref="NULL"/></codeph>，表示 SDK 填充 App ID。</li>
                         <li>如已启用 App Certificate，则务必填入使用 <parmname>channelName</parmname> 和 <parmname>uid</parmname> 生成的 <parmname>token</parmname>。</li>
-                        </ul> </li>
+                        </ul> <note type="attention"><p>由于目标频道中任意频道的 token 过期会导致所有跨频道推流停止，因此建议你将目标频道的 token 设置为相同的过期时长。</p></note></li>
+                    <li>
+                        <parmname>uid</parmname>：标识目标频道中的转发媒体流的 UID。取值范围为 0 到（2 <sup>32</sup>-1），请确保与目标频道中的所有 UID 不同。默认值为 0，表示 SDK 随机分配一个 UID。</li>
                     </ul> </p>
                 </pd>
             </plentry>
@@ -61,4 +61,4 @@
             </ul>
         </section>
     </refbody>
-</reference>
+</reference>

dita/RTC-NG/API/api_channelmediarelayconfiguration_setsrcchannelinfo.dita

@@ -22,7 +22,7 @@
             <codeblock props="electron" outputclass="language-typescript"/>
             <codeblock props="unity" outputclass="language-csharp"/>
             <codeblock props="rn" outputclass="language-typescript"/>
-           <codeblock props="flutter" outputclass="language-dart"/> 
+           <codeblock props="flutter" outputclass="language-dart"/>
             <codeblock props="unreal" outputclass="language-cpp"></codeblock></p>
         </section>
         <section id="parameters">
@@ -31,16 +31,16 @@
             <plentry>
                 <pt>srcInfo</pt>
                 <pd>
-                    <p>源频道信息 <xref keyref="ChannelMediaInfo"/>，包含如下成员：                   
-                    
+                    <p>源频道信息 <xref keyref="ChannelMediaInfo"/>，包含如下成员：
+
                     <ul>
                     <li><parmname>channelName</parmname>：源频道名。默认值为 <codeph><ph keyref="NULL"/></codeph>，表示 SDK 填充当前的频道名。</li>
-                    <li><parmname>uid</parmname>：标识源频道中的转发媒体流的 UID。默认值为 0，表示 SDK 随机分配一个 <parmname>uid</parmname>。请确保设为 0。</li>
-                    <li><parmname>token</parmname>：能加入源频道的 <parmname>token</parmname>。由你在 <parmname>srcInfo</parmname> 中设置的 <parmname>channelName</parmname> 和 <parmname>uid</parmname> 生成。                       
+                    <li><parmname>token</parmname>：能加入源频道的 <parmname>token</parmname>。由你在 <parmname>srcInfo</parmname> 中设置的 <parmname>channelName</parmname> 和 <parmname>uid</parmname> 生成。
                         <ul>
                         <li>如未启用 App Certificate，可直接将该参数设为默认值 <codeph><ph keyref="NULL"/></codeph>，表示 SDK 填充 App ID。</li>
                         <li>如已启用 App Certificate，则务必填入使用 <parmname>channelName</parmname> 和 <parmname>uid</parmname> 生成的 <parmname>token</parmname>，且其中的 <parmname>uid</parmname> 必须为 0。</li>
                         </ul> </li>
+                    <li><parmname>uid</parmname>：标识源频道中的转发媒体流的 UID。默认值为 0，请勿修改。</li>
                     </ul></p>
                 </pd>
             </plentry>

dita/RTC-NG/API/api_irtcengine_enableinearmonitoring.dita

@@ -52,8 +52,10 @@
         <section id="return_values" props="android ios mac electron unity rn">
             <title>返回值</title>
             <ul>
-            <li>0: 方法调用成功</li>
-            <li>&lt; 0: 方法调用失败</li>
+            <li>0: 方法调用成功。</li>
+            <li>&lt; 0: 方法调用失败。
+                <ul><li>- 8: 请确保当前的音频路由为蓝牙或耳机。</li></ul>
+            </li>
             </ul> </section>
     </refbody>
 </reference>

dita/RTC-NG/API/api_irtcengine_enableinearmonitoring2.dita

@@ -70,7 +70,15 @@
             <title>返回值</title>
             <ul id="ul_uns_l2y_hqb">
             <li>0: 方法调用成功。</li>
-            <li>&lt; 0: 方法调用失败。</li>
+            <li>&lt; 0: 方法调用失败。
+                <ul><li>- 8: 请确保当前的音频路由为蓝牙或耳机。</li></ul>
+            </li>
             </ul> </section>
+        <section props="flutter">
+            <title>异常</title>
+                <p>当该方法未成功调用时，会抛出 <xref keyref="AgoraRtcException"/> 异常，你需要捕获该异常并进行处理。常见的错误码如下：
+                    <ul><li>- 8: 请确保当前的音频路由为蓝牙或耳机。</li></ul>
+                </p>
+        </section>
     </refbody>
 </reference>

dita/RTC-NG/API/api_irtcengine_joinchannel2.dita

@@ -117,5 +117,18 @@
                 <li>-121：用户 ID 无效。你需要在 <parmname>uid</parmname> 中填入有效的用户 ID，重新加入频道。</li>
                 </ul></li>
             </ul> </section>
+        <section props="flutter">
+            <title>异常</title>
+            <p>当该方法未成功调用时，会抛出 <xref keyref="AgoraRtcException"/> 异常，你需要捕获该异常并进行处理。常见的错误码如下：
+                <ul>
+                <li>-2：传入的参数无效。例如，使用了不合法的 Token，<parmname>uid</parmname> 参数未设置为整型，<xref keyref="ChannelMediaOptions" /> 结构体成员值不合法。你需要填入有效的参数，重新加入频道。</li>
+                <li>-3：<xref keyref="IRtcEngine" /> 对象初始化失败。你需要重新初始化 <apiname keyref="IRtcEngine" /> 对象。</li>
+                <li>-7：<apiname keyref="IRtcEngine" /> 对象尚未初始化。你需要在调用该方法前成功初始化 <apiname keyref="IRtcEngine" /> 对象。</li>
+                <li>-8：<apiname keyref="IRtcEngine" /> 对象内部状态错误。可能的原因是：调用 <xref keyref="startEchoTest2" /> 开始通话回路测试后，未调用 <xref keyref="stopEchoTest" /> 停止测试就调用该方法加入频道。你需要在该方法前调用 <apiname keyref="stopEchoTest" />。</li>
+                <li>-17：加入频道被拒绝。可能的原因是用户已经在频道中。Agora 推荐通过 <xref keyref="onConnectionStateChanged" /> 回调判断用户是否在频道中。除收到 <apiname keyref="CONNECTION_STATE_DISCONNECTED" />(1) 状态外，不要再次调用该方法加入频道。</li>
+                <li>-102：频道名无效。你需要在 <parmname>channelId</parmname> 中填入有效的频道名，重新加入频道。</li>
+                <li>-121：用户 ID 无效。你需要在 <parmname>uid</parmname> 中填入有效的用户 ID，重新加入频道。</li>
+                </ul></p>
+            </section>
     </refbody>
 </reference>

dita/RTC-NG/API/api_irtcengine_sendmetadata.dita

@@ -34,7 +34,7 @@
                 <pt>metadata</pt>
                 <pd>媒体附属信息。详见 <xref keyref="Metadata" />。</pd>
             </plentry>
-            <plentry props="electron rn" conkeyref="VideoCanvas/sourcetype">
+            <plentry props="electron flutter" conkeyref="VideoCanvas/sourcetype">
                 <pt />
                 <pd />
             </plentry>

dita/RTC-NG/API/api_irtcengine_setaudiosessionoperationrestriction.dita

@@ -14,7 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java" />
-            <codeblock props="ios mac" outputclass="language-objectivec" />
+            <codeblock props="ios mac" outputclass="language-objectivec">- (void)setAudioSessionOperationRestriction:(AgoraAudioSessionOperationRestriction)restriction NS_SWIFT_NAME(setAudioSessionOperationRestriction(_:));</codeblock>
             <codeblock props="cpp" outputclass="language-cpp">virtual int setAudioSessionOperationRestriction(AUDIO_SESSION_OPERATION_RESTRICTION restriction) = 0;</codeblock>
             <codeblock props="electron" outputclass="language-typescript">abstract setAudioSessionOperationRestriction(restriction: AudioSessionOperationRestriction): number;</codeblock>
             <codeblock props="unity" outputclass="language-csharp">public abstract int SetAudioSessionOperationRestriction(AUDIO_SESSION_OPERATION_RESTRICTION restriction);</codeblock>
@@ -41,7 +41,7 @@
                 <pd>SDK 对 Audio Session 的操作权限，详见 <xref keyref="AUDIO_SESSION_OPERATION_RESTRICTION" />。该参数为 Bit Mask，每个 Bit 对应一个权限。</pd>
             </plentry>
             </parml> </section>
-        <section id="return_values" props="native electron unity rn">
+        <section id="return_values" props="apple cpp electron unity rn">
             <title>返回值</title>
             <ul>
             <li>0: 方法调用成功</li>

dita/RTC-NG/API/api_irtcengine_setlocalrendermode2.dita

@@ -64,9 +64,9 @@
                     <note type="attention" props="unity">该参数仅对 SDK 自渲染生效，如果你想要设置视图镜像，可以将 GameObject 的 scaleX 设为 <codeph>-1</codeph> 或 <codeph>+1</codeph>。</note></p>
                     <p props="android">本地视图的镜像模式。
                     <ul id="videomirrormodetype">
-                    <li><ph keyref="VIDEO_MIRROR_MODE_AUTO" /> (0)：默认的镜像模式（SDK 决定镜像模式）。如果你使用前置摄像头，默认启动本地视图镜像模式；如果你启用后置摄像头，默认关闭本地视图镜像模式。</li>
-                    <li><ph keyref="VIDEO_MIRROR_MODE_ENABLED" /> (1)：开启镜像模式。</li>
-                    <li><ph keyref="VIDEO_MIRROR_MODE_DISABLED" /> (2)：关闭镜像模式。</li>
+                    <li><ph keyref="VIDEO_MIRROR_MODE_AUTO" /> (0)：SDK 决定镜像模式。如果你使用前置摄像头，默认启动本地视图镜像模式；如果你启用后置摄像头，默认关闭本地视图镜像模式。</li>
+                    <li><ph keyref="VIDEO_MIRROR_MODE_ENABLED" /> (1)：开启本地视图的镜像模式。</li>
+                    <li><ph keyref="VIDEO_MIRROR_MODE_DISABLED" /> (2)：关闭本地视图的镜像模式。</li>
                     </ul> </p>
                     <note type="attention">如果你使用前置摄像头，默认启动本地用户视图镜像模式；如果你使用后置摄像头，默认关闭本地视图镜像模式。</note> </pd>
             </plentry>

dita/RTC-NG/API/api_irtcengine_startaudiomixing2.dita

@@ -63,7 +63,7 @@
                 <pt>loopback</pt>
                 <pd>
                     <p>是否只在本地播放音乐文件：
-                           
+
                     <ul>
                     <li><codeph><ph keyref="true" /></codeph>: 只在本地播放音乐文件，只有本地用户能听到音乐。</li>
                     <li><codeph><ph keyref="false" /></codeph>: 将本地播放的音乐文件发布至远端，本地用户和远端用户都能听到音乐。</li>
@@ -91,8 +91,19 @@
         <section id="return_values" props="native unity electron rn">
             <title>返回值</title>
             <ul>
-            <li>0: 方法调用成功</li>
-            <li>&lt; 0: 方法调用失败</li>
-            </ul> </section>
+            <li>0: 方法调用成功。</li>
+            <li>&lt; 0: 方法调用失败：
+            <ul>
+                <li>-1: 一般性的错误（未明确归类）。</li>
+                <li>-2: 设置了无效的参数。</li>
+                <li>-3：SDK 尚未准备好：<ul>
+                    <li>请检查是否已开启音频模块。</li>
+                    <li>请检查程序集完整性。</li>
+                    <li><xref keyref="IRtcEngine"/> 初始化失败。请重新初始化 <apiname keyref="IRtcEngine" />。</li>
+                </ul></li>
+                </ul>
+            </li>
+            </ul>
+        </section>
     </refbody>
-</reference>
+</reference>

dita/RTC-NG/API/api_irtcengine_startaudiorecording.dita

@@ -20,17 +20,13 @@
             <codeblock props="electron" outputclass="language-typescript"/>
             <codeblock props="unity" outputclass="language-csharp">public abstract int StartAudioRecording(string filePath, AUDIO_RECORDING_QUALITY_TYPE quality);</codeblock>
             <codeblock props="rn" outputclass="language-typescript"/>
-           <codeblock props="flutter" outputclass="language-dart"/> 
-            <codeblock props="unreal" outputclass="language-cpp"></codeblock></p>
+           <codeblock props="flutter" outputclass="language-dart"/>
+            <codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
         </section>
         <section id="detailed_desc">
-            <dl outputclass="deprecated">
-            <dlentry>
-                <dt>弃用：</dt>
-                <dd>该方法已废弃，其默认录音采样率为 32 kHz，不可修改。请改用新的 <xref keyref="startAudioRecording3"/> 方法。</dd>
-            </dlentry>
-            </dl>
-            <p>Agora SDK 支持通话过程中在客户端进行录音。该方法录制频道内所有用户的音频，并生成一个包含所有用户声音的录音文件，录音文件格式可以为:
+            <title>详情</title>
+            <note type="attention">调用该方法时，默认的录音采样率为 32 kHz，不可修改。</note>
+            <p>SDK 支持通话过程中在客户端进行录音。该方法录制频道内所有用户的音频，并生成一个包含所有用户声音的录音文件，录音文件格式可以为:
 
 
             <ul>

dita/RTC-NG/API/api_irtcengine_startaudiorecording2.dita

@@ -2,7 +2,7 @@
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
 <reference id="api_irtcengine_startaudiorecording2">
     <title><ph keyref="startAudioRecording2"/></title>
-    <shortdesc id="short"><ph id="shortdesc">开始客户端录音。</ph></shortdesc>
+    <shortdesc id="short"><ph id="shortdesc">开始客户端录音并设置录音采样率。</ph></shortdesc>
     <prolog>
         <metadata>
             <keywords>
@@ -21,17 +21,12 @@
             <codeblock props="electron" outputclass="language-typescript"/>
             <codeblock props="unity" outputclass="language-csharp">public abstract int StartAudioRecording(string filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality);</codeblock>
             <codeblock props="rn" outputclass="language-typescript"/>
-           <codeblock props="flutter" outputclass="language-dart"/> 
-            <codeblock props="unreal" outputclass="language-cpp"></codeblock></p>
+           <codeblock props="flutter" outputclass="language-dart"/>
+            <codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
         </section>
         <section id="detailed_desc">
-            <dl outputclass="deprecated">
-            <dlentry>
-                <dt>弃用：</dt>
-                <dd>请改用 <xref keyref="startAudioRecording3"/>。</dd>
-            </dlentry>
-            </dl>
-            <p>Agora SDK 支持通话过程中在客户端进行录音。调用该方法后，你可以录制频道内所有用户的音频，并得到一个包含所有用户声音的录音文件。录音文件格式可以为:
+            <title>详情</title>
+            <p>SDK 支持通话过程中在客户端进行录音。调用该方法后，你可以录制频道内所有用户的音频，并得到一个包含所有用户声音的录音文件。录音文件格式可以为:
 
 
             <ul>

dita/RTC-NG/API/api_irtcengine_startaudiorecording3.dita

@@ -2,7 +2,7 @@
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
 <reference id="api_irtcengine_startaudiorecording3">
     <title><ph keyref="startAudioRecording3" /></title>
-    <shortdesc id="short"><ph id="shortdesc">开始客户端录音。</ph></shortdesc>
+    <shortdesc id="short"><ph id="shortdesc">开始客户端录音并进行录音配置。</ph></shortdesc>
     <prolog>
         <metadata>
             <keywords>

dita/RTC-NG/API/api_irtcengine_startechotest.dita

@@ -26,7 +26,7 @@
             <dl outputclass="deprecated">
             <dlentry>
                 <dt>弃用：</dt>
-                <dd>该方法已废弃，请改用 <xref keyref="startEchoTest2" />。</dd>
+                <dd>该方法已废弃，请改用 <xref keyref="startEchoTest3" />。</dd>
             </dlentry>
             </dl>
             <p>该方法启动语音通话测试，目的是测试系统的音频设备（耳麦、扬声器等）和网络连接是否正常。在测试过程中，用户先说一段话，声音会在 10 秒后回放出来。如果 10 秒后用户能正常听到自己刚才说的话，就表示系统音频设备和网络连接都是正常的。</p>

dita/RTC-NG/API/api_irtcengine_startechotest3.dita

@@ -25,7 +25,7 @@
         <section id="detailed_desc">
             <p>加入频道前，为测试用户本地发流、收流是否正常，你可以调用该方法进行音视频通话回路测试，即测试系统的音视频设备和用户的上下行网络是否正常。</p>
             <p>开始测试后，用户需发出声音或面对摄像头，音频或视频会在约 2 秒后播放出来。如果音频播放正常，则表示系统音频设备和用户上下行网络均正常； 如果视频播放正常，则表示系统视频设备和用户上下行网络均正常。
-            <note id="note_ygl_znn_5sb">
+            <note id="note_ygl_znn_5sb" type="attention">
             <ul id="ul_gyv_znn_5sb">
             <li>请在加入频道前调用该方法。</li>
             <li>调用该方法后，必须调用 <xref keyref="stopEchoTest"/> 结束测试，否则该用户无法进行下一次音视频通话回路测试， 也无法加入频道。</li>

dita/RTC-NG/API/api_irtcengineex_enableloopbackrecordingex.dita

@@ -41,6 +41,7 @@
             <ul>
             <li props="cpp unity electron flutter">该方法仅适用于 macOS 和 Windows 平台。</li>
             <li>macOS 系统默认声卡不支持采集功能，如果你需要使用该功能，请启用一个虚拟声卡，并将 <parmname>deviceName</parmname> 设为该虚拟声卡的设备名。声网推荐你使用声网自研的虚拟声卡 AgoraALD 进行采集。</li>
+            <li>该方法目前仅支持一路声卡采集。</li>
         </ul></note></section>
         <section id="parameters">
             <title>参数</title>