From 9be5811da46a97797a1622eb8c38105d5981e7f2 Mon Sep 17 00:00:00 2001
From: Suri539 <fanyuanyuan@agora.io>
Date: Thu, 29 Aug 2024 15:25:42 +0800
Subject: [PATCH 1/2] Create
 api_irtcengine_setlocalvideodatasourceposition.dita

---
 ...ngine_setlocalvideodatasourceposition.dita | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita

diff --git a/dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita b/dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita
new file mode 100644
index 00000000000..64923617b9e
--- /dev/null
+++ b/dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
+<reference id="api_irtcengine_setlocalvideodatasourceposition">
+    <title><ph keyref="SetLocalVideoDataSourcePosition"/></title>
+    <shortdesc id="short"><ph id="shortdesc"><?oxy-placeholder content="Provide a short description for this API."?></ph></shortdesc>
+    <prolog>
+        <metadata>
+            <keywords>
+                <indexterm keyref="SetLocalVideoDataSourcePosition"/>
+            </keywords>
+        </metadata>
+    </prolog>
+    <refbody>
+        <section id="prototype">
+            <p outputclass="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"/>
+            <codeblock props="bp" outputclass="language-cpp"/>
+            <codeblock props="electron" outputclass="language-typescript"/>
+            <codeblock props="unity cs" outputclass="language-csharp"/>
+            <codeblock props="rn" outputclass="language-typescript"/>
+            <codeblock props="flutter" outputclass="language-dart"/> </p>
+        </section>
+        <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
+            <dl outputclass="since">
+            <dlentry props="native">
+                <dt>自从</dt>
+                <dd>v</dd>
+            </dlentry>
+            </dl>
+            <p/>
+        </section>
+        <section id="scenario" deliveryTarget="details">
+            <title>适用场景</title>
+            <p/>
+        </section>
+        <section id="timing" deliveryTarget="details">
+            <title>调用时机</title>
+            <p/>
+        </section>        
+        <section id="restriction" deliveryTarget="details">
+            <title>调用限制</title>
+            <p/>
+        </section>
+        <section id="related" deliveryTarget="details">
+            <title>相关回调</title>
+            <p/>
+        </section>
+        <section id="parameters" deliveryTarget="details">
+            <title>参数</title>
+            <parml>
+            <plentry>
+                <pt/>
+                <pd/>
+            </plentry>
+            </parml> </section>
+        <section id="return_values">
+            <title><ph keyref="return-section-title"/></title>
+            <p props="flutter">方法成功调用时，无返回值；方法调用失败时，会抛出 <xref keyref="AgoraRtcException"/> 异常，你需要捕获异常并进行处理。<ph props="cn">详见<xref keyref="error-code-link"/>了解详情和解决建议。</ph></p>
+            <ul props="native unreal bp electron unity rn cs">
+                <li>0: 方法调用成功。</li>
+                <li>&lt; 0: 方法调用失败。<ph props="cn">详见<xref keyref="error-code-link"/>了解详情和解决建议。</ph></li>
+                </ul> </section>
+        </refbody>
+</reference>

From 202611608da652efce6a2ca2724e99c37d46a2af Mon Sep 17 00:00:00 2001
From: Suri539 <fanyuanyuan@agora.io>
Date: Thu, 29 Aug 2024 17:56:28 +0800
Subject: [PATCH 2/2] add

---
 ...ngine_setlocalvideodatasourceposition.dita | 36 ++++++-------------
 dita/RTC-NG/API/rtc_api_overview.dita         |  4 +++
 dita/RTC-NG/RTC_NG_API_Unity.ditamap          |  1 +
 .../config/keys-rtc-ng-api-unity.ditamap      |  7 ++++
 .../config/relations-rtc-ng-api.ditamap       |  1 +
 5 files changed, 24 insertions(+), 25 deletions(-)
 rename dita/RTC-NG/{ => API}/api_irtcengine_setlocalvideodatasourceposition.dita (63%)

diff --git a/dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita b/dita/RTC-NG/API/api_irtcengine_setlocalvideodatasourceposition.dita
similarity index 63%
rename from dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita
rename to dita/RTC-NG/API/api_irtcengine_setlocalvideodatasourceposition.dita
index 64923617b9e..7696f2c501b 100644
--- a/dita/RTC-NG/api_irtcengine_setlocalvideodatasourceposition.dita
+++ b/dita/RTC-NG/API/api_irtcengine_setlocalvideodatasourceposition.dita
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
 <reference id="api_irtcengine_setlocalvideodatasourceposition">
-    <title><ph keyref="SetLocalVideoDataSourcePosition"/></title>
-    <shortdesc id="short"><ph id="shortdesc"><?oxy-placeholder content="Provide a short description for this API."?></ph></shortdesc>
+    <title><ph keyref="setLocalVideoDataSourcePosition"/></title>
+    <shortdesc id="short"><ph id="shortdesc">设置视频帧的观测位置。</ph></shortdesc>
     <prolog>
         <metadata>
             <keywords>
-                <indexterm keyref="SetLocalVideoDataSourcePosition"/>
+                <indexterm keyref="setLocalVideoDataSourcePosition"/>
             </keywords>
         </metadata>
     </prolog>
@@ -19,41 +19,27 @@
             <codeblock props="cpp unreal" outputclass="language-cpp"/>
             <codeblock props="bp" outputclass="language-cpp"/>
             <codeblock props="electron" outputclass="language-typescript"/>
-            <codeblock props="unity cs" outputclass="language-csharp"/>
+            <codeblock props="unity cs" outputclass="language-csharp">public abstract int SetLocalVideoDataSourcePosition(VIDEO_MODULE_POSITION position);</codeblock>
             <codeblock props="rn" outputclass="language-typescript"/>
             <codeblock props="flutter" outputclass="language-dart"/> </p>
         </section>
-        <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
-            <dl outputclass="since">
-            <dlentry props="native">
-                <dt>自从</dt>
-                <dd>v</dd>
-            </dlentry>
-            </dl>
-            <p/>
-        </section>
-        <section id="scenario" deliveryTarget="details">
-            <title>适用场景</title>
-            <p/>
-        </section>
         <section id="timing" deliveryTarget="details">
             <title>调用时机</title>
-            <p/>
+            <p>该方法需要在创建第一个 <xref keyref="VideoSurface"/> 视图之前调用。</p>
         </section>        
         <section id="restriction" deliveryTarget="details">
             <title>调用限制</title>
-            <p/>
-        </section>
-        <section id="related" deliveryTarget="details">
-            <title>相关回调</title>
-            <p/>
+            <p>该方法仅支持观测通过 <xref keyref="VideoSurface"/> 及其子类渲染的本地视频数据。</p>
         </section>
         <section id="parameters" deliveryTarget="details">
             <title>参数</title>
             <parml>
             <plentry>
-                <pt/>
-                <pd/>
+                <pt>position</pt>
+                <pd>视频帧的观测位置，详见 <xref keyref="VIDEO_MODULE_POSITION"/>。
+                <note type="attention">
+                    <ul><li>该方法目前仅支持将观测位置设为 <codeph><ph keyref="POSITION_POST_CAPTURER"/></codeph> 或 <codeph><ph keyref="POSITION_PRE_ENCODER"/></codeph>。</li>
+                    <li>在 <codeph><ph keyref="POSITION_POST_CAPTURER"/></codeph> 处获取的视频帧未经裁剪且帧率较高，<codeph><ph keyref="POSITION_PRE_ENCODER"/></codeph> 位置获取的视频帧经过发送前的裁剪，帧率小于或等于摄像头采集的帧率。</li></ul></note></pd>
             </plentry>
             </parml> </section>
         <section id="return_values">
diff --git a/dita/RTC-NG/API/rtc_api_overview.dita b/dita/RTC-NG/API/rtc_api_overview.dita
index 57999b2a9dd..4774af050a7 100644
--- a/dita/RTC-NG/API/rtc_api_overview.dita
+++ b/dita/RTC-NG/API/rtc_api_overview.dita
@@ -968,6 +968,10 @@
                     <stentry props="android cpp apple framework"><xref keyref="enableContentInspect"/></stentry>
                     <stentry props="android cpp apple framework"><ph conkeyref="enableContentInspect/shortdesc"/></stentry>
                 </strow>
+                <strow props="unity">
+                    <stentry><xref keyref="setLocalVideoDataSourcePosition"/></stentry>
+                    <stentry><ph conkeyref="setLocalVideoDataSourcePosition/shortdesc"/></stentry>
+                </strow>
                 <strow>
                     <stentry><xref keyref="takeSnapshot"/></stentry>
                     <stentry><ph conkeyref="takeSnapshot/shortdesc"/></stentry>
diff --git a/dita/RTC-NG/RTC_NG_API_Unity.ditamap b/dita/RTC-NG/RTC_NG_API_Unity.ditamap
index d49f50f0632..319cac84589 100644
--- a/dita/RTC-NG/RTC_NG_API_Unity.ditamap
+++ b/dita/RTC-NG/RTC_NG_API_Unity.ditamap
@@ -287,6 +287,7 @@
                 <topicref href="API/toc_snapshot.dita" chunk="to-content">
                     <topicref keyref="enableContentInspect" toc="no"/>
                     <topicref keyref="enableContentInspectEx" toc="no"/>
+                    <topicref keyref="setLocalVideoDataSourcePosition" toc="no"/>
                     <topicref keyref="takeSnapshot" toc="no"/>
                     <topicref keyref="takeSnapshotEx" toc="no"/>
                     <topicref keyref="onContentInspectResult" toc="no" props="hide"/>
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-unity.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-unity.ditamap
index 4a5fde373e0..b6083d7ce2f 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-unity.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-unity.ditamap
@@ -1184,6 +1184,13 @@
                     </keywords>
                 </topicmeta>
             </keydef>
+            <keydef keys="setLocalVideoDataSourcePosition" href="../API/api_irtcengine_setlocalvideodatasourceposition.dita">
+                <topicmeta>
+                    <keywords>
+                        <keyword>SetLocalVideoDataSourcePosition</keyword>
+                    </keywords>
+                </topicmeta>
+            </keydef>
             <keydef keys="enableVirtualBackground" href="../API/api_irtcengine_enablevirtualbackground.dita">
                 <topicmeta>
                     <keywords>
diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
index 2f2a04751c0..d189da546bc 100644
--- a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
+++ b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
@@ -2435,6 +2435,7 @@
                 </topicref>
                 <topicref keyref="setLocalRenderMode1" props="native unreal unity"/>
                 <topicref keyref="setLocalRenderMode2"/>
+                <topicref keyref="setLocalVideoDataSourcePosition" props="unity"/>
                 <topicref keyref="setLocalVideoMirrorMode"/>
                 <topicref keyref="setLocalVoiceEqualization"/>
                 <topicref keyref="setLocalVoiceFormant"/>