Merge pull request #3860 from AgoraIO/4.5.0-bugfix-1205

add best practice links
AgoraIO · Dec 6, 2024 · 700a0fa · 700a0fa
2 parents 57729c2 + 4adf36f
commit 700a0fa
Show file tree

Hide file tree

Showing 7 changed files with 31 additions and 4 deletions.
diff --git a/dita/RTC-NG/API/api_player_preloadwithurl.dita b/dita/RTC-NG/API/api_player_preloadwithurl.dita
@@ -50,7 +50,7 @@
             <parml>
             <plentry id="url">
                 <pt>url</pt>
-                <pd>带 <codeph>rte://</codeph> 前缀的 URL。<p props="hide">各字段的详细说明详见<xref keyref="rte-player"/>。</p></pd>
+                <pd>带 <codeph>rte://</codeph> 前缀的 URL。各字段的详细说明详见<xref keyref="rte-player"/>。</pd>
             </plentry>
             <plentry props="cpp apple" conkeyref="SetConfigs_Rte/err">
                 <pt></pt>

diff --git a/dita/RTC-NG/API/api_playerconfig_setabrfallbacklayer.dita b/dita/RTC-NG/API/api_playerconfig_setabrfallbacklayer.dita
@@ -37,8 +37,7 @@
             <title>适用场景</title>
                 <ul>
                     <li>在一般场景下，你可以调用该方法并将回退的质量层级设为 <apiname keyref="kRteAbrFallbackLow"/> 或 <apiname keyref="kRteAbrFallbackAudioOnly"/>，SDK 会在网络情况差的时候将视频流回退为低质量的视频流、或是仅接收音频流。</li>
-                <li>如果对视频流回退的分辨率要求较高，可以联系<xref keyref="ticket-link"/>开通 ABR 功能。开通后，你可以自定义每个层级的分辨率。SDK 会以你指定的最低质量层级分辨率为下限，在此范围内根据网络状况动态调整分辨率。
-                    <ph props="hide">详细功能实现详见<xref keyref="rte-player"/>。</ph>
+                <li>如果对视频流回退的分辨率要求较高，可以联系<xref keyref="ticket-link"/>开通 ABR 功能。开通后，你可以自定义每个层级的分辨率。SDK 会以你指定的最低质量层级分辨率为下限，在此范围内根据网络状况动态调整分辨率。详细功能实现详见<xref keyref="rte-player"/>。
                 </li></ul>
         </section>
         <section id="timing" deliveryTarget="details" conkeyref="SetAbrSubscriptionLayer/timing">

diff --git a/dita/RTC-NG/API/api_playerconfig_setabrsubscriptionlayer.dita b/dita/RTC-NG/API/api_playerconfig_setabrsubscriptionlayer.dita
@@ -31,7 +31,7 @@
             </dlentry>
             </dl>
             <p><ph>你可以根据实际的网络情况切换订阅不同的视频流质量层级，对应不同的分辨率。</ph>
-                <ph>默认情况下，调用该方法后观众只能在源频道切换订阅视频的大小流，即在 <apiname keyref="kRteAbrSubscriptionHigh"/> 和 <apiname keyref="kRteAbrSubscriptionLow"/> 之间切换。如对视频分辨率切换有更高要求，你可以<xref keyref="ticket-link"/>开通 ABR（自适应码率）功能。启用该功能后，你可以自定义不同质量层级的视频流所对应的分辨率，观众可以在专门的转码频道根据需求切换所有质量层级的视频流。</ph><ph props="hide">详细功能实现详见<xref keyref="rte-player"/>。</ph>
+                <ph>默认情况下，调用该方法后观众只能在源频道切换订阅视频的大小流，即在 <apiname keyref="kRteAbrSubscriptionHigh"/> 和 <apiname keyref="kRteAbrSubscriptionLow"/> 之间切换。如对视频分辨率切换有更高要求，你可以<xref keyref="ticket-link"/>开通 ABR（自适应码率）功能。启用该功能后，你可以自定义不同质量层级的视频流所对应的分辨率，观众可以在专门的转码频道根据需求切换所有质量层级的视频流。详细功能实现详见<xref keyref="rte-player"/>。</ph>
             </p>
         </section>
         <section id="scenario" deliveryTarget="details">

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap
@@ -122,6 +122,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="rte-player" href="https://doc.shengwang.cn/doc/rtc/android/best-practice/playing-url" scope="external" format="html">
+            <topicmeta>
+                <keywords>
+                    <keyword>观众端 URL 拉流</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
     </topichead>
     <topichead navtitle="External">
         <keydef keys="filePath-link" href="https://developer.android.google.cn/guide/topics/media/media-formats?hl=zh-cn" scope="external" format="html"/>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-cpp.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-cpp.ditamap
@@ -102,6 +102,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="rte-player" href="https://doc.shengwang.cn/doc/rtc/windows/best-practice/playing-url" scope="external" format="html">
+            <topicmeta>
+                <keywords>
+                    <keyword>观众端 URL 拉流</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
     </topichead>
     <topichead navtitle="External">
         <keydef keys="filePath-link" href="https://docs.microsoft.com/zh-cn/windows/win32/medfound/supported-media-formats-in-media-foundation" scope="external" format="html"/>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-ios.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-ios.ditamap
@@ -109,6 +109,13 @@
             </keywords>
         </topicmeta>
     </keydef>
+    <keydef keys="rte-player" href="https://doc.shengwang.cn/doc/rtc/ios/best-practice/playing-url" scope="external" format="html">
+            <topicmeta>
+                <keywords>
+                    <keyword>观众端 URL 拉流</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
         <keydef keys="advanced-beauty" href="https://doc.shengwang.cn/doc/rtc/ios/advanced-features/advanced-beauty" scope="external" format="html">
             <topicmeta>
                 <keywords>

diff --git a/dita/RTC-NG/config/keys-rtc-ng-links-macos.ditamap b/dita/RTC-NG/config/keys-rtc-ng-links-macos.ditamap
@@ -81,6 +81,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="rte-player" href="https://doc.shengwang.cn/doc/rtc/macos/best-practice/playing-url" scope="external" format="html">
+            <topicmeta>
+                <keywords>
+                    <keyword>观众端 URL 拉流</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
         <keydef keys="advanced-beauty" href="https://doc.shengwang.cn/doc/rtc/macos/advanced-features/advanced-beauty" scope="external" format="html">
             <topicmeta>
                 <keywords>