Merge pull request #3830 from AgoraIO/4.5.0-release

4.5.0 release
AgoraIO · Nov 14, 2024 · e651c09 · e651c09
2 parents d87aac0 + 1b06462
commit e651c09
Show file tree

Hide file tree

Showing 11 changed files with 491 additions and 41 deletions.
diff --git a/dita/RTC-NG/API/class_playerconfig.dita b/dita/RTC-NG/API/class_playerconfig.dita
@@ -58,19 +58,19 @@
                         <pt><ph keyref="GetAutoPlay"/></pt>
                         <pd>获取自动播放设置。详见 <xref keyref="GetAutoPlay"/>。</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="SetAbrSubscriptionLayer"/></pt>
                         <pd>设置订阅的媒体流的质量层级。详见 <xref keyref="SetAbrSubscriptionLayer"/>。</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="GetAbrSubscriptionLayer"/></pt>
                         <pd>获取所订阅的视频流的质量层级。详见 <xref keyref="GetAbrSubscriptionLayer"/>。</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="SetAbrFallbackLayer"/></pt>
                         <pd>设置订阅的视频流的回退选项。详见 <xref keyref="SetAbrFallbackLayer"/>。</pd>
                     </plentry>
-                     <plentry>
+                     <plentry props="cn">
                         <pt><ph keyref="GetAbrFallbackLayer"/></pt>
                         <pd>获取设置的视频流回退选项。详见 <xref keyref="GetAbrFallbackLayer"/>。</pd>
                     </plentry>

diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita
@@ -11,6 +11,11 @@
             <title>升级必看</title>
             <body>
                 <p>该版本对部分功能的实现方式进行了优化，涉及 SDK 的行为变更、API 的改名或删除，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。</p>
+                <note type="attention" props="native">
+                    <p props="android">自 4.5.0 起，RTC SDK 和 RTM SDK (2.2.0 及以上版本) 都包含 <codeph>libaosl.so</codeph> 库。如果你通过 CDN 手动集成 RTC SDK 且同时集成了 RTM SDK，为避免冲突，请手动删除版本较低的 <codeph>libaosl.so</codeph> 库。4.5.0 RTC SDK <codeph>libaosl.so</codeph> 库版本为 1.2.13。</p>
+                    <p props="apple">自 4.5.0 起，RTC SDK 和 RTM SDK (2.2.0 及以上版本) 都包含 <codeph>aosl.xcframework</codeph> 库。如果你通过 CDN 手动集成 RTC SDK 且同时集成了 RTM SDK，为避免冲突，请手动删除版本较低的 <codeph>aosl.xcframework</codeph> 库。4.5.0 RTC SDK <codeph>aosl.xcframework</codeph> 库版本为 1.2.13。你可以在 <codeph>Info.plist</codeph> 中查看库的版本信息。</p>
+                    <p props="cpp">自 4.5.0 起，RTC SDK 和 RTM SDK (2.2.0 及以上版本) 都包含 <codeph>aosl.dll</codeph> 库。如果你通过 CDN 手动集成 RTC SDK 且同时集成了 RTM SDK，为避免冲突，请手动删除版本较低的 <codeph>aosl.dll</codeph> 库。4.5.0 RTC SDK <codeph>aosl.dll</codeph> 库版本为 1.2.13。你可以通过查看 <codeph>aosl.dll</codeph> 文件的属性来得知库的版本信息。</p>
+                </note>
                 <ol>
                     <li props="cpp"><ph><b>成员参数类型变更</b></ph>
                         <p>为提升各框架对 Native SDK 的适配性，该版本对一些 API 中的成员或参数做了如下修改：<table frame="all" rowsep="1" colsep="1">
@@ -109,7 +114,7 @@
                         <p>当网络情况不稳定时，观众端可以调用 <codeph><apiname keyref="SetAbrFallbackLayer"/></codeph> 来设置订阅的视频流的回退选项。SDK 会以你指定的最低质量层级对应的视频流分辨率为下限，在此范围内根据网络状况动态调整分辨率。</p><p props="hide">有关该功能的实现步骤，详见 <xref keyref="rte-player"/>。</p>
                     </li>
                     <li><ph><b>滤镜效果</b></ph>
-                        <p>该版本新增 <codeph><apiname keyref="setFilterEffectOptions"/></codeph> 方法，你可以在 <parmname>config</parmname> 参数中传入指定格式的立方体贴图文件 (.cube)，从而实现美白、鲜艳、冷色、黑白等自定义滤镜效果。此外，SDK 提供了一个内置的 <codeph>built_in_whiten_filter.cube</codeph> 文件，用于快速实现美白滤镜效果。</p>
+                        <p>该版本新增 <codeph><apiname keyref="setFilterEffectOptions"/></codeph> 方法，你可以在 <codeph>config</codeph> 参数中传入指定格式的立方体贴图文件 (.cube)，从而实现美白、鲜艳、冷色、黑白等自定义滤镜效果。此外，SDK 提供了一个内置的 <codeph>built_in_whiten_filter.cube</codeph> 文件，用于快速实现美白滤镜效果。</p>
                     </li>
                     <li><ph><b>本地音频合流</b></ph>
                         <p>该版本新增本地音频合流功能，你可以调用 <codeph><apiname keyref="startLocalAudioMixer"/></codeph> 方法，将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流，你可以将合并后的音频流发布到频道中。不再需要音频合流时，你可以调用 <codeph><apiname keyref="stopLocalAudioMixer"/></codeph> 方法停止本地音频合流；在合流过程中，可以调用 <codeph><apiname keyref="updateLocalAudioMixerConfiguration"/></codeph> 方法更新正在合流的音频流配置。 </p>
@@ -150,7 +155,7 @@
                         <p>该版本在 <codeph><apiname keyref="RecorderStreamInfo"/></codeph> 中新增 <parmname>type</parmname> 成员。当调用 <codeph><apiname keyref="createMediaRecorder"/></codeph> 时，可通过该成员指定录制的视频流类型为本地预览视频流，并在 <codeph><apiname keyref="MediaRecorderConfiguration"/></codeph> 中设置录制预览视频的高、宽、帧率、采样率等参数，之后调用 <codeph><apiname keyref="startRecording"/></codeph> 即可开始录制本地预览的视频。</p>
                     </li>
                     <li><ph><b>指定视频观测位置截图</b></ph>
-                        <p>该版本新增 <codeph><apiname keyref="takeSnapshot2"/></codeph> 和 <codeph><apiname keyref="takeSnapshotEx2"/></codeph> 方法，你可以在调用该方法时通过 <parmname>config</parmname> 参数，在指定的视频观测点进行截图，比如：编码前、编码后或渲染前的数据，以实现更加灵活的截图效果。</p>
+                        <p>该版本新增 <codeph><apiname keyref="takeSnapshot2"/></codeph> 和 <codeph><apiname keyref="takeSnapshotEx2"/></codeph> 方法，你可以在调用该方法时通过 <codeph>config</codeph> 参数，在指定的视频观测点进行截图，比如：编码前、编码后或渲染前的数据，以实现更加灵活的截图效果。</p>
                     </li>
                     <li><ph><b>自定义音频采集改进</b></ph>
                         <p>该版本在 <codeph><apiname keyref="AudioTrackConfig"/></codeph> 中新增了 <codeph>enableAudioProcessing</codeph> 成员参数，用于控制是否对 <codeph>AUDIO_TRACK_DIRECT</codeph> 类型的自定义音频采集轨道启用 3A 音频处理。该参数默认值为 <codeph><codeph><ph keyref="false"/></codeph></codeph>，即不启用音频处理，用户可以按需开启，此项改动提升了自定义音频处理的灵活性。</p>

diff --git a/en-US/dita/RTC-NG/API/class_playerconfig.dita b/en-US/dita/RTC-NG/API/class_playerconfig.dita
@@ -58,19 +58,19 @@
                         <pt><ph keyref="GetAutoPlay"/></pt>
                         <pd>Gets the autoplay settings. See <xref keyref="GetAutoPlay"/>.</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="SetAbrSubscriptionLayer"/></pt>
                         <pd>Sets the quality level of the subscribed media stream. See <xref keyref="SetAbrSubscriptionLayer"/>.</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="GetAbrSubscriptionLayer"/></pt>
                         <pd>Gets the quality level of the subscribed video stream. See <xref keyref="GetAbrSubscriptionLayer"/>.</pd>
                     </plentry>
-                        <plentry>
+                        <plentry props="cn">
                         <pt><ph keyref="SetAbrFallbackLayer"/></pt>
                         <pd>Sets the fallback option of the subscribed video stream. See <xref keyref="SetAbrFallbackLayer"/>.</pd>
                     </plentry>
-                     <plentry>
+                     <plentry props="cn">
                         <pt><ph keyref="GetAbrFallbackLayer"/></pt>
                         <pd>Gets the fallback option of video stream. See <xref keyref="GetAbrFallbackLayer"/>.</pd>
                     </plentry>

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
@@ -6275,6 +6275,20 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="getColorSpace">
+            <topicmeta>
+                <keywords>
+                    <keyword>getColorSpace</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
+        <keydef keys="setColorSpace">
+            <topicmeta>
+                <keywords>
+                    <keyword>setColorSpace</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
         <keydef keys="VideoLayout" href="../API/class_videolayout.dita">
             <topicmeta>
                 <keywords>

diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap
@@ -101,5 +101,12 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="page-size" href="https://developer.android.com/guide/practices/page-sizes" scope="external" format="html">
+                <topicmeta>
+                    <keywords>
+                        <keyword>Support 16 KB page sizes</keyword>
+                    </keywords>
+                </topicmeta>
+            </keydef>
         </topichead>
 </map>
diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-links.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-links.ditamap
@@ -27,6 +27,20 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="showroom">
+            <topicmeta>
+                <keywords>
+                    <keyword>show room</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
+        <keydef keys="one-to-one-live">
+            <topicmeta>
+                <keywords>
+                    <keyword>one to one live</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
     </topichead>
     <topichead navtitle="External">
         <keydef keys="mailto-link"  href="mailto:[email protected]" scope="external" format="html">