From 4adf36f33097a1081167dbb2655ae7358a1e630d Mon Sep 17 00:00:00 2001
From: Suri539 <fanyuanyuan@agora.io>
Date: Fri, 6 Dec 2024 11:21:21 +0800
Subject: [PATCH] add best practice links

---
 dita/RTC-NG/API/api_player_preloadwithurl.dita             | 2 +-
 dita/RTC-NG/API/api_playerconfig_setabrfallbacklayer.dita  | 3 +--
 .../API/api_playerconfig_setabrsubscriptionlayer.dita      | 2 +-
 dita/RTC-NG/config/keys-rtc-ng-links-android.ditamap       | 7 +++++++
 dita/RTC-NG/config/keys-rtc-ng-links-cpp.ditamap           | 7 +++++++
 dita/RTC-NG/config/keys-rtc-ng-links-ios.ditamap           | 7 +++++++
 dita/RTC-NG/config/keys-rtc-ng-links-macos.ditamap         | 7 +++++++
 7 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/dita/RTC-NG/API/api_player_preloadwithurl.dita b/dita/RTC-NG/API/api_player_preloadwithurl.dita
index 1e8c594282a..98267186b81 100644
--- 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
index 015be2e5d4c..c3838be527f 100644
--- 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
index 89147333fd4..0b6bd4b6296 100644
--- 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
index 17d77edfbd2..5d5d9571905 100644
--- 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
index 93a916bbcf1..6c1e815e154 100644
--- 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
index ae2ccf007a5..39c54b14cb6 100644
--- 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
index 7a38f21beb7..c5d89d8ffaf 100644
--- 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>