1

AgoraIO · Jul 3, 2024 · 12c33e3 · 12c33e3
1 parent 88a0d0a
commit 12c33e3
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 8 deletions.
diff --git 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>
+</reference>
diff --git 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>