CSD-54930

AgoraIO · Jul 15, 2024 · c359428 · c359428
1 parent b699d58
commit c359428
Show file tree

Hide file tree

Showing 4 changed files with 15 additions and 1 deletion.
diff --git 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
@@ -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
@@ -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
@@ -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>