New translations

AgoraIO · Nov 13, 2024 · c5ccf3b · c5ccf3b
1 parent 2366de0
commit c5ccf3b
Show file tree

Hide file tree

Showing 4 changed files with 25 additions and 18 deletions.
diff --git a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getvideoformatpreference.dita
@@ -32,7 +32,7 @@
         <section id="detailed_desc">
             <p>You need to register the callback when calling the <xref keyref="registerVideoFrameObserver"/> method. After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. You need to set your preferred video data in the return value of this callback.</p>
                     <note>The default types of pixel format (<ph keyref="VIDEO_PIXEL_DEFAULT"/>) for the raw video are as follows:<ul>
-                <li props="android cpp bp unreal">On the Android platform, the default video frame type may be I420Buffer or TextureBuffer. The cases where the video frame type is fixed as I420Buffer include but are not limited to:<ul>
+                <li props="android cpp bp unreal">On the Android platform, the default video frame type may be I420Buffer or TextureBuffer. TextureBuffer 类型的纹理格式可能为 OES 格式或者 RGB 格式。 如果 <apiname keyref="getVideoFormatPreference"/> 返回的视频帧类型为 <ph keyref="VIDEO_PIXEL_DEFAULT"/>，你需要在处理视频数据时增加对 I420Buffer 或 TextureBuffer 的适配。 The cases where the video frame type is fixed as I420Buffer include but are not limited to:<ul>
                     <li>Specific devices, such as: LG G5 SE (H848), Google Pixel 4a, Samsung Galaxy A7, or Xiaomi Mi Max.</li>
                     <li>Image enhancement extension has been integrated and video noise reduction or low-light enhancement function has been enabled.</li>
                     </ul></li>

diff --git a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_oncapturevideoframe.dita
@@ -35,6 +35,10 @@
             <p props="native unreal bp unity cs">You can get raw video data collected by the local device through this callback and preprocess it as needed. Once the preprocessing is complete, you can directly modify <parmname>videoFrame</parmname> in this callback, and set the return value to <codeph><ph keyref="true"/></codeph> to send the modified video data to the SDK.</p>
             <p props="native unreal bp">If you need to send the preprocessed data to the SDK, you need to call <xref keyref="getVideoFrameProcessMode"/> first to set the video processing mode to read and write mode (<ph keyref="PROCESS_MODE_READ_WRITE"/>).</p>
             <p props="flutter rn electron">You can get raw video data collected by the local device through this callback.</p>
+            <note type="attention" id="default">
+            <p props="android" id="java">该回调默认提供的视频数据格式为 I420Buffer 或 TextureBuffer，TextureBuffer 类型的纹理格式可能为 0ES 格式或者 RGB 格式。 如果你需要其他格式的视频数据，可在 <xref keyref="getVideoFormatPreference"/> 回调的返回值中设置预期的数据格式。</p>
+            <p props="apple">该回调默认提供的视频数据格式为 I420 或 CVPixelBufferRef，如果你需要其他格式的视频数据，可在 <xref keyref="getVideoFormatPreference"/> 回调中返回预期的数据格式。</p>
+            <p props="cpp">该回调默认提供的视频数据格式为 YUV420，如果你需要其他格式的视频数据，可在 getVideoFormatPreference 回调的返回值中设置预期的数据格式。</p></note>
         </section>
         <section id="scenario" deliveryTarget="details">
             <title>Applicable scenarios</title>
@@ -45,7 +49,7 @@
         <section id="timing" deliveryTarget="details">
             <title>Trigger timing</title>
             <p>After the successful registration of the video data observer, each time the SDK captures a video frame.</p>
-        </section>        
+        </section>
         <section id="restriction" deliveryTarget="details">
             <title>Restrictions</title>
             <ul>

diff --git a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_onrendervideoframe.dita b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_onrendervideoframe.dita
@@ -37,6 +37,9 @@
         </section>
         <section id="detailed_desc">
             <p>After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. In this callback, you can get the video data sent from the remote end before rendering, and then process it according to the particular scenarios.</p>
+            <p props="android" id="java">该回调默认提供的视频数据格式为 I420Buffer 或 TextureBuffer，TextureBuffer 类型的纹理格式可能为 0ES 格式或者 RGB 格式。 如果你需要其他格式的视频数据，可在 <xref keyref="getVideoFormatPreference"/> 回调的返回值中设置预期的数据格式。</p>
+            <p props="apple">该回调默认提供的视频数据格式为 I420 或 CVPixelBufferRef，如果你需要其他格式的视频数据，可在 <xref keyref="getVideoFormatPreference"/> 回调中返回预期的数据格式。</p>
+            <p props="cpp">该回调默认提供的视频数据格式为 YUV420，如果你需要其他格式的视频数据，可在 getVideoFormatPreference 回调的返回值中设置预期的数据格式。</p>
             <note type="attention" props="native unreal bp electron rn flutter">
             <ul>
             <li props="native unreal bp">If you need to send the preprocessed data to the SDK, you need to call <xref keyref="getVideoFrameProcessMode"/> first to set the video processing mode to read and write mode (<ph keyref="PROCESS_MODE_READ_WRITE"/>).</li>

diff --git a/en-US/dita/RTC-NG/API/rtc_api_overview.dita b/en-US/dita/RTC-NG/API/rtc_api_overview.dita
@@ -1108,37 +1108,37 @@
                     <stentry><xref keyref="setFilterEffectOptions2"/></stentry>
                     <stentry><ph conkeyref="setFilterEffectOptions2/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="cn">
                     <stentry><xref keyref="setFaceShapeBeautyOptions"/></stentry>
                     <stentry><ph conkeyref="setFaceShapeBeautyOptions/shortdesc"/></stentry>
                 </strow>
-                <strow props="android apple">
-                    <stentry><xref keyref="setFaceShapeBeautyOptions2"/></stentry>
-                    <stentry><ph conkeyref="setFaceShapeBeautyOptions2/shortdesc"/></stentry>
+                <strow props="cn">
+                    <stentry props="android apple"><xref keyref="setFaceShapeBeautyOptions2"/></stentry>
+                    <stentry props="android apple"><ph conkeyref="setFaceShapeBeautyOptions2/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="cn">
                     <stentry><xref keyref="setFaceShapeAreaOptions"/></stentry>
                     <stentry><ph conkeyref="setFaceShapeAreaOptions/shortdesc"/></stentry>
                 </strow>
-                <strow props="android apple">
-                    <stentry><xref keyref="setFaceShapeAreaOptions2"/></stentry>
-                    <stentry><ph conkeyref="setFaceShapeAreaOptions2/shortdesc"/></stentry>
+                <strow props="cn">
+                    <stentry props="android apple"><xref keyref="setFaceShapeAreaOptions2"/></stentry>
+                    <stentry props="android apple"><ph conkeyref="setFaceShapeAreaOptions2/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="cn">
                     <stentry><xref keyref="getFaceShapeBeautyOptions"/></stentry>
                     <stentry><ph conkeyref="getFaceShapeBeautyOptions/shortdesc"/></stentry>
                 </strow>
-                <strow props="android apple">
-                    <stentry><xref keyref="getFaceShapeBeautyOptions2"/></stentry>
-                    <stentry><ph conkeyref="getFaceShapeBeautyOptions2/shortdesc"/></stentry>
+                <strow props="cn">
+                    <stentry props="android apple"><xref keyref="getFaceShapeBeautyOptions2"/></stentry>
+                    <stentry props="android apple"><ph conkeyref="getFaceShapeBeautyOptions2/shortdesc"/></stentry>
                 </strow>
-                <strow>
+                <strow props="cn">
                     <stentry><xref keyref="getFaceShapeAreaOptions"/></stentry>
                     <stentry><ph conkeyref="getFaceShapeAreaOptions/shortdesc"/></stentry>
                 </strow>
-                <strow props="android apple">
-                    <stentry><xref keyref="getFaceShapeAreaOptions2"/></stentry>
-                    <stentry><ph conkeyref="getFaceShapeAreaOptions2/shortdesc"/></stentry>
+                <strow props="cn">
+                    <stentry props="android apple"><xref keyref="getFaceShapeAreaOptions2"/></stentry>
+                    <stentry props="android apple"><ph conkeyref="getFaceShapeAreaOptions2/shortdesc"/></stentry>
                 </strow>
                 <strow props="android hmos ios cpp unity rn flutter unreal bp cs">
                     <stentry><xref keyref="enableFaceDetection"/></stentry>