Merge pull request #3606 from AgoraIO/4.3.1-framework

4.3.1 framework
AgoraIO · Apr 24, 2024 · 9ddcd96 · 9ddcd96
2 parents 67a7b99 + 008caeb
commit 9ddcd96
Show file tree

Hide file tree

Showing 15 changed files with 554 additions and 22 deletions.
diff --git a/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita b/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita
@@ -49,7 +49,7 @@
             <li>视频直播：扬声器</li>
             </ul></p>
             <p>调用该 API 可以改变上述默认音频路由。成功改变音频路由后，SDK 会触发 <xref keyref="onAudioRoutingChanged"/> 回调。</p>
-            <note>
+            <note props="android ios unity rn flutter">
             <p>当手机插入外接设备，如蓝牙设备或耳机时，系统的音频路由会发生改变。详细的路由变化规律请参考 <xref keyref="guide-audio-route">音频路由</xref>。</p>
             </note> </section>
         <section id="parameters">

diff --git a/dita/RTC-NG/API/api_irtcengine_setenablespeakerphone.dita b/dita/RTC-NG/API/api_irtcengine_setenablespeakerphone.dita
@@ -24,7 +24,7 @@
             <codeblock props="flutter" outputclass="language-dart">Future&lt;void&gt; setEnableSpeakerphone(bool speakerOn);</codeblock></p> </section>
         <section id="detailed_desc">
             <title>详情</title>
-            <p>如果 SDK 默认的音频路由（见<xref keyref="guide-audio-route">音频路由</xref>）或 <xref keyref="setDefaultAudioRouteToSpeakerphone" /> 的设置无法满足你的需求，你可以调用 <xref keyref="setEnableSpeakerphone" /> 切换当前的音频路由。成功改变音频路由后，SDK 会触发 <xref keyref="onAudioRoutingChanged" /> 回调。</p>
+            <p>如果 SDK 默认的音频路由<ph props="android ios unity rn flutter">（见<xref keyref="guide-audio-route">音频路由</xref>）</ph>或 <xref keyref="setDefaultAudioRouteToSpeakerphone" /> 的设置无法满足你的需求，你可以调用 <xref keyref="setEnableSpeakerphone" /> 切换当前的音频路由。成功改变音频路由后，SDK 会触发 <xref keyref="onAudioRoutingChanged" /> 回调。</ph>
             <p>该方法只设置用户在当前频道内使用的音频路由，不会影响 SDK 默认的音频路由。如果用户离开当前频道并加入新的频道，则用户还是会使用 SDK 默认的音频路由。</p>
             <note type="attention">
             <ul>

diff --git a/dita/RTC-NG/RTC_NG_API_Unity.ditamap b/dita/RTC-NG/RTC_NG_API_Unity.ditamap
@@ -686,6 +686,7 @@
                 <topicref keyref="getRecordingDefaultDevice2" toc="no"/>
                 <topicref keyref="getRecordingDevice" toc="no"/>
                 <topicref keyref="getRecordingDeviceInfo" toc="no"/>
+                <topicref keyref="getRecordingDeviceInfo2" toc="no"/>
                 <topicref keyref="getRecordingDeviceMute" toc="no" props="hide"/>
                 <topicref keyref="getRecordingDeviceVolume" toc="no"/>
                 <topicref keyref="setLoopbackDevice" toc="no"/>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-rn.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-rn.ditamap
@@ -4,7 +4,7 @@
     <title>Keys RTC NG Windows Links</title>
     <topichead navtitle="Agora">
         <keydef keys="guide-cdn-streaming" href="https://docs.agora.io/cn/live-streaming-premium-4.x/cdn_streaming_apple_ng?platform=iOS" scope="external" format="html"/>
-        <keydef keys="guide-audio-route" href="https://doc.shengwang.cn/doc/rtc/rn/advanced-features/audio-route" scope="external" format="html"/>
+        <keydef keys="guide-audio-route" href="https://doc.shengwang.cn/doc/rtc/android/advanced-features/audio-route" scope="external" format="html"/>
         <keydef keys="guide-voice-changer" href="https://doc.shengwang.cn/doc/rtc/rn/advanced-features/voice-changer" scope="external" format="html"/>
         <keydef keys="volume-type" href="https://doc.shengwang.cn/faq/integration-issues/system-volume" scope="external" format="html">
             <topicmeta>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-unity.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-unity.ditamap
@@ -4,6 +4,7 @@
     <title>Keys RTC NG Unity Links</title>
     <topichead navtitle="Agora">
         <keydef keys="guide-lastmile-quality" href="https://docs.agora.io/cn/video-call-4.x/lastmile_quality_unity_ng?platform=Unity" scope="external" format="html"/>
+        <keydef keys="guide-audio-route" href="https://doc.shengwang.cn/doc/rtc/android/advanced-features/audio-route" scope="external" format="html"/>
         <keydef keys="guide-token" href="https://doc.shengwang.cn/doc/rtc/unity/basic-features/token-authentication" scope="external" format="html">
         <topicmeta>
                 <keywords>

diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita
@@ -99,8 +99,10 @@
                     <li props="android"><ph><b>摄像头采集改进</b></ph>
                         <p>优化了摄像头采集的视频处理机制，减少噪点、提高亮度、改善色彩，使采集到的图形更加清晰、明亮和真实。</p>
                     </li>
-                    <li props="mac"><ph><b>获取音频设备类型</b></ph>
-                        <p>该版本在 <codeph><xref keyref="AgoraRtcDeviceInfo"/></codeph> 中新增 <codeph>deviceTypeName</codeph> 成员，用于获取音频设备的类型，如 built-in、USB、HDMI 等。</p>
+                    <li props="mac unity flutter electron"><ph><b>获取音频设备类型</b></ph><ph props="unity rn flutter electron">（macOS）</ph>
+                        <p props="mac">该版本在 <xref keyref="AgoraRtcDeviceInfo"/> 中新增 <codeph>deviceTypeName</codeph> 成员，用于获取音频设备的类型，如 built-in、USB、HDMI 等。</p>
+                        <p props="flutter electron">该版本在 <xref keyref="AudioDeviceInfo"/> 中新增 <codeph>deviceTypeName</codeph> 成员，用于获取音频设备的类型，如 built-in、USB、HDMI 等。</p>
+                        <p props="unity">该版本新增 <xref keyref="getPlaybackDefaultDevice2"/>、<xref keyref="getRecordingDefaultDevice2"/>、<xref keyref="getPlaybackDeviceInfo2"/>、<xref keyref="getRecordingDeviceInfo2"/> 方法，分别用于获取音频播放、采集设备的设备信息及类型。</p>
                     </li>
                     <li><ph><b>虚拟背景算法优化</b></ph>
                         <p>为了提高纯色背景下开启虚拟背景时人像分割的精确度和稳定性，该版本优化了绿幕分割算法：
@@ -181,10 +183,11 @@
                         </ul></li>
                     <li props="android"><codeph><apiname keyref="ENCRYPTION_ERROR_DATASTREAM_DECRYPTION_FAILURE"/></codeph></li>
                     <li props="android"><codeph><apiname keyref="ENCRYPTION_ERROR_DATASTREAM_ENCRYPTION_FAILURE"/></codeph></li>
-                    <li props="unity electron flutter"><xref keyref="getDevice2_IAudioDeviceCollection"/><ph> (macOS)</ph></li>
-                    <li props="unity electron flutter"><xref keyref="getDefaultDevice2_IAudioDeviceCollection"/><ph> (macOS)</ph></li>
-                    <li props="unity electron flutter"><xref keyref="getPlaybackDeviceInfo2"/><ph> (macOS)</ph></li>
-                    <li props="unity electron flutter"><xref keyref="getRecordingDeviceInfo2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getPlaybackDefaultDevice2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getRecordingDefaultDevice2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getPlaybackDeviceInfo2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getRecordingDeviceInfo2"/><ph> (macOS)</ph></li>
+                    <li props="electron flutter"><xref keyref="AudioDeviceInfo"/> 中新增 <codeph>deviceTypeName</codeph> (macOS)</li>
                     <li props="mac"><xref keyref="AgoraRtcDeviceInfo"/> 新增 <codeph>deviceTypeName</codeph></li>
                     <li><xref keyref="RemoteAudioStats"/> 新增 <codeph>e2eDelay</codeph></li>
                     <li props="apple cpp framework"><xref keyref="ERROR_CODE_TYPE"/> 新增 <codeph><apiname keyref="ERR_DATASTREAM_DECRYPTION_FAILED"/></codeph></li>

diff --git a/en-US/dita/RTC-NG/release/release_notes.dita b/en-US/dita/RTC-NG/release/release_notes.dita
@@ -108,8 +108,10 @@
                     <li props="android"><ph><b>Camera capture improvements</b></ph>
                         <p>Improvements have been made to the video processing mechanism of camera capture, reducing noise, enhancing brightness, and improving color, making the captured images clearer, brighter, and more realistic.</p>
                     </li>
-                    <li props="mac"><ph><b>Audio device type detection</b></ph>
-                        <p>This version adds the <codeph>deviceTypeName</codeph> member to <codeph><xref keyref="AgoraRtcDeviceInfo"/></codeph>, used to identify the type of audio devices, such as built-in, USB, HDMI, etc.</p>
+                    <li props="mac unity flutter electron"><ph><b>Audio device type detection</b></ph><ph props="unity rn flutter electron"> (macOS)</ph>
+                        <p props="mac">This version adds the <codeph>deviceTypeName</codeph> member to <codeph><xref keyref="AgoraRtcDeviceInfo"/></codeph>, used to identify the type of audio devices, such as built-in, USB, HDMI, etc.</p>
+                        <p props="flutter electron">This version adds the <codeph>deviceTypeName</codeph> in <xref keyref="AudioDeviceInfo"/>, used to identify the type of audio devices, such as built-in, USB, HDMI, etc.</p>
+                        <p props="unity">This version adds the <xref keyref="getPlaybackDefaultDevice2"/>, <xref keyref="getRecordingDefaultDevice2"/>, <xref keyref="getPlaybackDeviceInfo2"/>, and <xref keyref="getRecordingDeviceInfo2"/> method to obtain the information and type of audio playback and recording deivces.</p>
                     </li>
                     <li><ph><b>Virtual Background Algorithm Optimization</b></ph>
                         <p>To enhance the accuracy and stability of human segmentation when activating virtual backgrounds against solid colors, this version optimizes the green screen segmentation algorithm:
@@ -195,10 +197,11 @@
                         </ul></li>
                     <li props="android"><codeph><apiname keyref="ENCRYPTION_ERROR_DATASTREAM_DECRYPTION_FAILURE"/></codeph></li>
                     <li props="android"><codeph><apiname keyref="ENCRYPTION_ERROR_DATASTREAM_ENCRYPTION_FAILURE"/></codeph></li>
-                    <li props="unity electron flutter"><xref keyref="getDevice2_IAudioDeviceCollection"/> (macOS)</li>
-                    <li props="unity electron flutter"><xref keyref="getDefaultDevice2_IAudioDeviceCollection"/> (macOS)</li>
-                    <li props="unity electron flutter"><xref keyref="getPlaybackDeviceInfo2"/> (macOS)</li>
-                    <li props="unity electron flutter"><xref keyref="getRecordingDeviceInfo2"/> (macOS)</li>
+                    <li props="unity"><xref keyref="getPlaybackDefaultDevice2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getRecordingDefaultDevice2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getPlaybackDeviceInfo2"/><ph> (macOS)</ph></li>
+                    <li props="unity"><xref keyref="getRecordingDeviceInfo2"/><ph> (macOS)</ph></li>
+                    <li props="electron flutter"><xref keyref="AudioDeviceInfo"/> adds <codeph>deviceTypeName</codeph> (macOS)</li>
                     <li props="mac"><xref keyref="AgoraRtcDeviceInfo"/> adds <codeph>deviceTypeName</codeph></li>
                     <li><xref keyref="RemoteAudioStats"/> adds <codeph>e2eDelay</codeph></li>
                     <li props="apple cpp framework"><xref keyref="ERROR_CODE_TYPE"/> adds <codeph><apiname keyref="ERR_DATASTREAM_DECRYPTION_FAILED"/></codeph></li>