From c82b6f96c8c05c4a4aaff07a7e229f30b33a6e67 Mon Sep 17 00:00:00 2001
From: Nero-Hu <huheng@agora.io>
Date: Fri, 18 Apr 2025 16:30:42 +0800
Subject: [PATCH] newest api

---
 dita/RTC-NG/API/api_player_getposition.dita              | 2 +-
 dita/RTC-NG/API/api_player_switchwithurl.dita            | 4 ++--
 dita/RTC-NG/API/api_playerconfig_setplaybackspeed.dita   | 2 +-
 dita/RTC-NG/API/api_playerinfo_abrsubscriptionlayer.dita | 4 ++--
 dita/RTC-NG/API/api_playerinfo_audiochannels.dita        | 4 ++--
 dita/RTC-NG/API/api_playerinfo_isaudiomuted.dita         | 3 ++-
 dita/RTC-NG/API/api_playerinfo_isvideomuted.dita         | 5 +++--
 dita/RTC-NG/API/api_playerinfo_state.dita                | 4 ++--
 dita/RTC-NG/API/api_playerinfo_streamcount.dita          | 2 +-
 dita/RTC-NG/API/rtc_api_data_type.dita                   | 2 ++
 dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap           | 7 +++++++
 dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap         | 7 +++++++
 12 files changed, 32 insertions(+), 14 deletions(-)

diff --git a/dita/RTC-NG/API/api_player_getposition.dita b/dita/RTC-NG/API/api_player_getposition.dita
index f2a0b78c3bd..5b62a4ffd64 100644
--- a/dita/RTC-NG/API/api_player_getposition.dita
+++ b/dita/RTC-NG/API/api_player_getposition.dita
@@ -42,7 +42,7 @@
             <plentry props="apple cpp">
                 <pt props="apple">error</pt>
                 <pt props="cpp">err</pt>
-                <pd props="apple">输出参数，表示错误信息。可能返回以下值：
+                <pd props="apple">输出参数，表示错误信息。可能返回以下 AgoraRteErrorCode：
                     <ul>
                         <li><ph keyref="kRteOk"/>：调用成功。</li>
                         <li><ph keyref="kRteErrorInvalidOperation"/>：<ul>
diff --git a/dita/RTC-NG/API/api_player_switchwithurl.dita b/dita/RTC-NG/API/api_player_switchwithurl.dita
index 77d5bd95ac3..b380e14b2ac 100644
--- a/dita/RTC-NG/API/api_player_switchwithurl.dita
+++ b/dita/RTC-NG/API/api_player_switchwithurl.dita
@@ -30,8 +30,8 @@
                 <dd props="native">自 v4.5.1 版本新增。</dd>
                 </dlentry>
             </dl>
-            <p props="android">请在 SDK 返回播放器状态为 <ph keyref="kRtePlayerStateOpenCompleted"/> 时调用该方法。</p>
-            <note type="attention" props="apple cpp">该方法仅在播放器打开的是非 RTE URL 时有效。请在 SDK 返回播放器状态为 <ph keyref="kRtePlayerStateOpenCompleted"/> 时调用该方法。</note>
+            <p>请在 SDK 返回播放器状态为 <ph keyref="kRtePlayerStateOpenCompleted"/> 时调用该方法。</p>
+            <note type="attention" props="apple cpp">该方法仅在播放器打开的是非 <xref keyref="Rte_Rte"/> URL 时有效。请在 SDK 返回播放器状态为 <ph keyref="kRtePlayerStateOpenCompleted"/> 时调用该方法。</note>
             <note type="attention" props="android">该方法仅在播放器打开的是非 RTE URL 时有效。</note>
             </section>
         <section id="restriction" deliveryTarget="details">
diff --git a/dita/RTC-NG/API/api_playerconfig_setplaybackspeed.dita b/dita/RTC-NG/API/api_playerconfig_setplaybackspeed.dita
index 7d67278eaae..0019cab1d91 100644
--- a/dita/RTC-NG/API/api_playerconfig_setplaybackspeed.dita
+++ b/dita/RTC-NG/API/api_playerconfig_setplaybackspeed.dita
@@ -30,7 +30,7 @@
                 <dd props="native">自 v4.5.1 版本新增。</dd>
                 </dlentry>
             </dl>
-            <p props="android">你可以在调用 <xref keyref="OpenWithUrl"/> 方法之后调用此方法。</p>
+            <p>你可以在调用 <xref keyref="OpenWithUrl"/> 方法之后调用此方法。</p>
             <note type="attention" props="apple cpp">你可以在调用 <xref keyref="OpenWithUrl"/> 方法之后调用此方法。</note>
             </section>
         <section id="restriction" deliveryTarget="details">
diff --git a/dita/RTC-NG/API/api_playerinfo_abrsubscriptionlayer.dita b/dita/RTC-NG/API/api_playerinfo_abrsubscriptionlayer.dita
index 55dfe3269b4..94ebda13bbf 100644
--- a/dita/RTC-NG/API/api_playerinfo_abrsubscriptionlayer.dita
+++ b/dita/RTC-NG/API/api_playerinfo_abrsubscriptionlayer.dita
@@ -30,7 +30,7 @@
                 <dd props="android cpp">自 v4.5.1 版本新增。</dd>
                 </dlentry>
             </dl>
-            <p props="android">该字段仅在打开 RTE URL 时有效。</p>
+            <p>该字段仅在打开 RTE URL 时有效。</p>
             <note type="attention" props="cpp">该字段仅在你打开 RTE URL 时有效。</note>
             </section>
         <section id="restriction" deliveryTarget="details">
@@ -49,7 +49,7 @@
                         </ul>
                     </p>
         <p props="android"><ul>
-                        <li>方法调用成功，返回 <xref keyref="RteAbrSubscriptionLayer"/> 对象，详见 <xref keyref="RteAbrSubscriptionLayer"/>。</li>
+                        <li>方法调用成功，返回 <xref keyref="AbrSubscriptionLayer"/> 对象，详见 <xref keyref="AbrSubscriptionLayer"/>。</li>
                         </ul>
                     </p>
     </section>
diff --git a/dita/RTC-NG/API/api_playerinfo_audiochannels.dita b/dita/RTC-NG/API/api_playerinfo_audiochannels.dita
index 5a9b3fced66..1e9cf951905 100644
--- a/dita/RTC-NG/API/api_playerinfo_audiochannels.dita
+++ b/dita/RTC-NG/API/api_playerinfo_audiochannels.dita
@@ -13,7 +13,7 @@
     <refbody>
         <section id="prototype">
             <p outputclass="codeblock">
-            <codeblock props="android" outputclass="language-java">public int audioChannels()</codeblock>
+            <codeblock props="android" outputclass="language-java"/>
             <codeblock props="hmos" outputclass="language-arkts"/>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">int AudioChannels() const</codeblock>
@@ -43,7 +43,7 @@
                 <li>0: 方法调用成功。</li>
                 <li>&lt; 0: 方法调用失败。<ph props="cn">详见<xref keyref="error-code-link"/>了解详情和解决建议。</ph></li>
                 </ul>
-        <p props="cpp android">方法调用成功，返回音频的声道数量。</p>
+        <p props="cpp">方法调用成功，返回音频的声道数量。</p>
     </section>
         </refbody>
 </reference>
diff --git a/dita/RTC-NG/API/api_playerinfo_isaudiomuted.dita b/dita/RTC-NG/API/api_playerinfo_isaudiomuted.dita
index 47eee5d29a6..26356019d24 100644
--- a/dita/RTC-NG/API/api_playerinfo_isaudiomuted.dita
+++ b/dita/RTC-NG/API/api_playerinfo_isaudiomuted.dita
@@ -27,7 +27,8 @@
             <dl outputclass="since">
             <dlentry props="native">
                 <dt>自从：</dt>
-                <dd props="cpp android">自 v4.5.1 版本新增。</dd>
+                <dd props="cpp">自 v4.5.1 版本新增。</dd>
+                <dd props="android">自 v4.4.0 版本新增。</dd>
                 </dlentry>
             </dl>
             <p>该方法用于判断播放器是否停止接收音频流。</p>
diff --git a/dita/RTC-NG/API/api_playerinfo_isvideomuted.dita b/dita/RTC-NG/API/api_playerinfo_isvideomuted.dita
index 0effe65b721..7caede6edfb 100644
--- a/dita/RTC-NG/API/api_playerinfo_isvideomuted.dita
+++ b/dita/RTC-NG/API/api_playerinfo_isvideomuted.dita
@@ -27,11 +27,12 @@
             <dl outputclass="since">
             <dlentry props="native">
                 <dt>自从：</dt>
-                <dd props="cpp android">自 v4.5.1 版本新增。</dd>
+                <dd props="cpp">自 v4.5.1 版本新增。</dd>
+                <dd props="android">自 v4.4.0 版本新增。</dd>
                 </dlentry>
             </dl>
             <p></p>
-            <note type="attention" props="cpp android"><codeph>IsVideoMuted</codeph> 接口仅在打开 RTE URL 时有效。</note>
+            <note type="attention" props="cpp"><xref keyref="IsVideoMuted"/> 接口仅在打开 RTE URL 时有效。</note>
             </section>
         <section id="restriction" deliveryTarget="details">
             <title>调用限制</title>
diff --git a/dita/RTC-NG/API/api_playerinfo_state.dita b/dita/RTC-NG/API/api_playerinfo_state.dita
index c92a82a7431..20900383693 100644
--- a/dita/RTC-NG/API/api_playerinfo_state.dita
+++ b/dita/RTC-NG/API/api_playerinfo_state.dita
@@ -13,7 +13,7 @@
     <refbody>
         <section id="prototype">
             <p outputclass="codeblock">
-            <codeblock props="android" outputclass="language-java">public int state() </codeblock>
+            <codeblock props="android" outputclass="language-java"/>
             <codeblock props="hmos" outputclass="language-arkts"/>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">RtePlayerState State() const</codeblock>
@@ -43,7 +43,7 @@
                 <li>0: 方法调用成功。</li>
                 <li>&lt; 0: 方法调用失败。<ph props="cn">详见<xref keyref="error-code-link"/>了解详情和解决建议。</ph></li>
                 </ul>
-        <p props="cpp android"><ul>
+        <p props="cpp"><ul>
                         <li>方法调用成功，返回当前播放器状态，详见 <xref keyref="RtePlayerState"/>。</li>
                         </ul>
                     </p>
diff --git a/dita/RTC-NG/API/api_playerinfo_streamcount.dita b/dita/RTC-NG/API/api_playerinfo_streamcount.dita
index f232f058b90..828508470bd 100644
--- a/dita/RTC-NG/API/api_playerinfo_streamcount.dita
+++ b/dita/RTC-NG/API/api_playerinfo_streamcount.dita
@@ -30,7 +30,7 @@
                 <dd props="android cpp">自 v4.5.1 版本新增。</dd>
                 </dlentry>
             </dl>
-            <p props="android">该方法仅在打开非 RTE URL 时有效。</p>
+            <p>该方法仅在打开非 RTE URL 时有效。</p>
             <note type="attention" props="cpp">该方法在打开非 RTE URL 时有效。</note>
             </section>
         <section id="restriction" deliveryTarget="details">
diff --git a/dita/RTC-NG/API/rtc_api_data_type.dita b/dita/RTC-NG/API/rtc_api_data_type.dita
index a897b554079..cdddeb22efd 100644
--- a/dita/RTC-NG/API/rtc_api_data_type.dita
+++ b/dita/RTC-NG/API/rtc_api_data_type.dita
@@ -424,6 +424,7 @@
             <li><xref keyref="AgoraFacePositionInfo"/></li>
             <li><xref keyref="AgoraMediaPlayerRenderMode"/></li>
             <li><xref keyref="AgoraRhythmPlayerConfig"/></li>
+            <li><xref keyref="AgoraRtePlayerInfo"/></li>
             <li><xref keyref="AudioEncodedFrameObserverConfig"/></li>
             <li><xref keyref="AudioFrame"/></li>
             <li><xref keyref="AudioParams"/></li>
@@ -545,6 +546,7 @@
             <li props="cn"><xref keyref="AdvancedConfigInfo"/></li>
             <li><xref keyref="AgoraRhythmPlayerConfig"/></li>
             <li><xref keyref="AgoraRtcDeviceInfo"/></li>
+            <li><xref keyref="AgoraRtePlayerInfo"/></li>
             <li><xref keyref="AudioEncodedFrameObserverConfig"/></li>
             <li><xref keyref="AudioFrame"/></li>
             <li><xref keyref="AudioParams"/></li>
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap
index d3ab473aa68..662a1f1f5d9 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-ios.ditamap
@@ -6075,6 +6075,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="AgoraRtePlayerInfo" href="../API/class_agorarteplayerinfo.dita">
+            <topicmeta>
+                <keywords>
+                    <keyword>AgoraRtePlayerInfo</keyword>
+                </keywords>
+                </topicmeta>
+            </keydef>
         </topichead>
     <topichead navtitle="Enums">
         <keydef keys="ALPHA_STITCH_MODE" href="../API/enum_alphastitchmode.dita">
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
index b3152c1dc23..cc3c7112a73 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-macos.ditamap
@@ -5686,6 +5686,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="AgoraRtePlayerInfo" href="../API/class_agorarteplayerinfo.dita">
+            <topicmeta>
+                <keywords>
+                    <keyword>AgoraRtePlayerInfo</keyword>
+                </keywords>
+                </topicmeta>
+            </keydef>
         </topichead>
     <topichead navtitle="Enums">
         <keydef keys="ALPHA_STITCH_MODE" href="../API/enum_alphastitchmode.dita">