From c35942844a7380c69148a652567a74eb0255bd36 Mon Sep 17 00:00:00 2001
From: Suri539 <fanyuanyuan@agora.io>
Date: Mon, 15 Jul 2024 16:11:19 +0800
Subject: [PATCH 1/2] CSD-54930

---
 dita/RTC-NG/API/api_irtcengine_statechanged.dita | 3 ++-
 dita/RTC-NG/API/enum_mediadevicestatetype.dita   | 4 ++++
 dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap   | 7 +++++++
 dita/RTC-NG/release/release_notes.dita           | 2 ++
 4 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/dita/RTC-NG/API/api_irtcengine_statechanged.dita b/dita/RTC-NG/API/api_irtcengine_statechanged.dita
index 9a9f7e64be1..b069d68bdbd 100644
--- a/dita/RTC-NG/API/api_irtcengine_statechanged.dita
+++ b/dita/RTC-NG/API/api_irtcengine_statechanged.dita
@@ -49,8 +49,9 @@
                 <pd>
                     <p>设备状态：
                     <ul>
-                    <li>0：设备插入，但未使用。</li>
+                    <li>0：设备就绪。</li>
                     <li>1：设备正在使用。</li>
+                    <li>3：设备已插入。</li>
                     <li>8：设备被拔出。</li>
                     </ul></p>
                 </pd>
diff --git a/dita/RTC-NG/API/enum_mediadevicestatetype.dita b/dita/RTC-NG/API/enum_mediadevicestatetype.dita
index b3931ba54ca..a19ee4cab45 100644
--- a/dita/RTC-NG/API/enum_mediadevicestatetype.dita
+++ b/dita/RTC-NG/API/enum_mediadevicestatetype.dita
@@ -19,6 +19,10 @@
                 <pt><ph keyref="MEDIA_DEVICE_STATE_DISABLED"/></pt>
                 <pd>2: 设备被禁用。</pd>
             </plentry>
+            <plentry>
+                <pt><ph keyref="MEDIA_DEVICE_STATE_PLUGGED_IN"/></pt>
+                <pd>3: 设备已插入。</pd>
+            </plentry>
             <plentry>
                 <pt><ph keyref="MEDIA_DEVICE_STATE_NOT_PRESENT"/></pt>
                 <pd>4: 没有此设备。</pd>
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
index 9590b0026eb..de998f9c726 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
@@ -9728,6 +9728,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="MEDIA_DEVICE_STATE_PLUGGED_IN">
+            <topicmeta>
+                <keywords>
+                    <keyword>MEDIA_DEVICE_STATE_PLUGGED_IN</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
         <keydef keys="MEDIA_DEVICE_STATE_NOT_PRESENT">
             <topicmeta>
                 <keywords>
diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita
index 3fa275cd072..d77f3fd4768 100644
--- a/dita/RTC-NG/release/release_notes.dita
+++ b/dita/RTC-NG/release/release_notes.dita
@@ -47,6 +47,8 @@
                         <li><codeph>metadata_buffer</codeph> 更名为 <codeph>metadataBuffer</codeph>。</li>
                         <li><codeph>metadata_size</codeph> 更名为 <codeph>metadataSize</codeph>。</li>
                         </ul></li>
+                    <li props="windows">在 v4.4.0 之前，音视频设备已插入、已就绪均会通过 <codeph><apiname keyref="MEDIA_DEVICE_STATE_TYPE"/></codeph> 中的 <codeph><apiname keyref="MEDIA_DEVICE_STATE_IDLE"/></codeph> 状态报告。为进一步区分设备状态，自 v4.4.0 起，SDK 会通过新增的 <codeph><apiname keyref="MEDIA_DEVICE_STATE_PLUGGED_IN"/></codeph> 报告设备已插入。</li>
+                    <li props="mac">在 v4.4.0 之前，音视频设备已插入、已就绪均会通过 <codeph><apiname keyref="stateChanged"/></codeph> 回调中的 <codeph>state</codeph> 参数报告状态码 <codeph>0</codeph>。为进一步区分设备状态，自 v4.4.0 起，SDK 会通过新增的状态码 <codeph>3</codeph> 报告设备已插入。</li>
                 </ol>
             </body>
         </topic>

From aa24c410c20f06b782f0a3f2485cbf6cc64d0796 Mon Sep 17 00:00:00 2001
From: Suri539 <Suri539@users.noreply.github.com>
Date: Mon, 15 Jul 2024 08:12:08 +0000
Subject: [PATCH 2/2] Sync cn prototype to en prototype

---
 en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
index 9590b0026eb..de998f9c726 100644
--- a/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
+++ b/en-US/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
@@ -9728,6 +9728,13 @@
                 </keywords>
             </topicmeta>
         </keydef>
+        <keydef keys="MEDIA_DEVICE_STATE_PLUGGED_IN">
+            <topicmeta>
+                <keywords>
+                    <keyword>MEDIA_DEVICE_STATE_PLUGGED_IN</keyword>
+                </keywords>
+            </topicmeta>
+        </keydef>
         <keydef keys="MEDIA_DEVICE_STATE_NOT_PRESENT">
             <topicmeta>
                 <keywords>