From 12c33e32b11861dc4b38f84efc2c7017014bd400 Mon Sep 17 00:00:00 2001
From: jinyu <jinyu@agora.io>
Date: Wed, 3 Jul 2024 18:15:59 +0800
Subject: [PATCH] 1

---
 dita/RTC-NG/API/api_imediaengine_pullaudioframe.dita | 12 +++++-------
 .../api_imediaengine_setexternalaudiosource2.dita    |  2 +-
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/dita/RTC-NG/API/api_imediaengine_pullaudioframe.dita b/dita/RTC-NG/API/api_imediaengine_pullaudioframe.dita
index 12e76292986..fcd436dc495 100644
--- a/dita/RTC-NG/API/api_imediaengine_pullaudioframe.dita
+++ b/dita/RTC-NG/API/api_imediaengine_pullaudioframe.dita
@@ -26,25 +26,23 @@
         </section>
         <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
             <p>调用该方法后，App 会采取主动拉取的方式获取远端已解码和混音后的音频数据，用于音频播放。</p>
+            <note type="attention">调用该方法前，你需要调用 <xref keyref="setExternalAudioSink"/><codeph>(<parmname>enabled</parmname>: <ph keyref="true"/>)</codeph> 开启并设置外部渲染。</note>
         </section>
         <section id="timing" deliveryTarget="details">
             <title>调用时机</title>
-            <ul>
-             <li>使用该方法前，你需要调用 <xref keyref="setExternalAudioSink"/><codeph>(<parmname>enabled</parmname>: <ph keyref="true"/>)</codeph> 开启并设置外部渲染。</li>
-             <li>该方法需要在加入频道后调用。</li>
-            </ul>
+             <p>该方法需要在加入频道后调用。</p>
         </section>        
         <section id="restriction" deliveryTarget="details">
             <title>调用限制</title>
             <p>该方法和 <xref keyref="onPlaybackAudioFrame"/> 回调均可用于获取远端混音后的音频播放数据。在调用 <apiname keyref="setExternalAudioSink"/> 开启外部音频渲染后，App 将无法从 <apiname keyref="onPlaybackAudioFrame"/> 回调中获得数据。因此，请根据实际的业务需求在该方法和 <apiname keyref="onPlaybackAudioFrame"/> 回调之间进行选择。二者的处理机制不同，具体区别如下：
                 <ul>
                 <li>调用该方法后，App 会主动拉取音频数据。通过设置音频数据，SDK 可以调整缓存，帮助 App 处理延时，从而有效避免音频播放抖动。</li>
-                <li>注册 <apiname keyref="onPlaybackAudioFrame"/> 后，SDK 通过该回调将音频数据传输给 App。App 在处理音频帧时的延迟可能会导致音频播放抖动。</li>
+                <li>注册 <apiname keyref="onPlaybackAudioFrame"/> 后，SDK 通过该回调将音频数据传输给 App。App 在处理音频帧的延迟时，可能会导致音频播放抖动。</li>
                 </ul></p>
             <p>该方法仅用于拉取远端混音后的音频播放数据，如需获取采集的原始音频数据、混音前每条拉流单独的原始音频播放数据等，可以通过调用 <xref keyref="registerAudioFrameObserver"/> 注册相应的回调。</p>
         </section>
         <section id="parameters" deliveryTarget="details">
-            <title props="android apple cpp unreal bp flutter unity cs">参数</title>
+            <title><ph props="android apple cpp unreal bp flutter unity cs">参数</ph></title>
             <parml>
             <plentry props="cpp unreal bp unity flutter cs">
                 <pt>frame</pt>
@@ -75,4 +73,4 @@
             <li>方法调用失败，返回错误码。</li>
             </ul> </section>
         </refbody>
-</reference>
\ No newline at end of file
+</reference>
diff --git a/dita/RTC-NG/API/api_imediaengine_setexternalaudiosource2.dita b/dita/RTC-NG/API/api_imediaengine_setexternalaudiosource2.dita
index c51f1373389..6e803ccaa8d 100644
--- a/dita/RTC-NG/API/api_imediaengine_setexternalaudiosource2.dita
+++ b/dita/RTC-NG/API/api_imediaengine_setexternalaudiosource2.dita
@@ -99,7 +99,7 @@
                     <ul>
                     <li><codeph><ph keyref="true"/></codeph>：（默认）发布到远端。</li>
                     <li><codeph><ph keyref="false"/></codeph>：不发布到远端。</li>
-                    </ul></p>
+                    </ul>
                 </pd>
             </plentry>
             </parml> </section>