@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.2

package/resource/doc/roomkit/flutter/features/call-user-to-room.md

@@ -1,228 +0,0 @@
-`RoomStore` 是 `AtomicXCore` 中专职房间事务管理的模块，深度集成了会中呼叫能力。本章节旨在指导如何利用 `RoomStore` 高效完成会中呼叫相关功能的开发与接入。
-
-## 核心功能
-- **会中呼叫**：房间内任意参与者均可呼叫房间外任意成员加入房间。
-
-- **获取会中呼叫用户列表**：可以获取指定房间的会中呼叫的用户列表。
-
-## 核心概念
-
-在开始集成之前，需要通过下表了解一下`RoomStore`中与会中呼叫相关的几个核心概念：
-| **核心概念** | **核心职责与描述** |
-| --- | --- |
-| [RoomCallStatus](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcallstatus) | 代表会中呼叫的状态，包含：<br>- `none`（默认态）。<br>- `calling`（呼叫中）。<br>- `timeout`（呼叫超时）。<br>- `rejected`（呼叫被拒绝）。 |
-| [RoomCallResult](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcallresult) | 代表会中呼叫的结果，包含：<br>- `success`（呼叫成功）。<br>- `alreadyInCalling`（已在呼叫中）。<br>- `alreadyInRoom`（已在房间中）。 |
-| [CallRejectionReason](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callrejectionreason) | 代表呼叫被拒绝的原因，目前仅支持：<br>- `rejected`（主动拒绝）。<br>- `inOtherRoom`（在其他房间中）。 |
-| [RoomCall](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcall) | 代表会中呼叫业务的核心数据结构。负责存储呼叫者信息、被呼叫者信息、以及当前呼叫状态。 |
-| [RoomEvent](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent) | 代表房间动态的实时事件。其中包含会中呼叫相关的事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore) | 这是与房间全生命周期相关的核心类。功能包含：发起会中呼叫，响应会中呼叫，获取房间的会中呼叫列表，并通过订阅其 `roomEventPublisher` 来接收与会中呼叫相关的实时动态事件。 |
-
-## 实现步骤
-
-### 步骤1：组件集成
-
-请参考 接入概览 集成 **AtomicXCore SDK**，并已完成 实现登录逻辑 部分接入。
-
-### 步骤2：呼叫方功能
-
-#### **1. 发起呼叫**
-
-作为呼叫方调用`RoomStore`的`callUserToRoom`接口，可以批量呼叫用户进房。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-Future<void> callUserToRoom({
-  required List<String> userIDList,
-  int timeout = 30,
-  String? extensionInfo,
-}) async {
-  final result = await RoomStore.shared.callUserToRoom(
-    roomID: "roomID",
-    userIDList: userIDList,
-    timeout: timeout,
-    extensionInfo: extensionInfo,
-  );
-
-  if (result.isSuccess) {
-    print("呼叫用户请求发送成功");
-  } else {
-    print("呼叫用户失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
-  }
-}
-```
-
-#### **2. 取消呼叫**
-
-作为呼叫方调用`RoomStore`的`cancelCall`接口，可以批量取消正在呼叫申请。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-Future<void> cancelCall(List<String> userIDList) async {
-  final result = await RoomStore.shared.cancelCall(
-    roomID: "roomID",
-    userIDList: userIDList,
-  );
-
-  if (result.isSuccess) {
-    print("取消呼叫成功");
-  } else {
-    print("取消呼叫失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
-  }
-}
-```
-
-#### **3. 获取呼叫列表信息**
-
-进入房间后，调用`RoomStore`的`getPendingCalls`接口，可以分页查询当前房间正在呼叫的用户列表信息。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-Future<void> getPendingCalls(String roomID, String? cursor) async {
-  // cursor 为分页游标，首次调用时传入 null，获取第一页数据，后续调用时传入上次返回的 cursor 值。
-  final result = await RoomStore.shared.getPendingCalls(
-    roomID: roomID,
-    cursor: cursor,
-  );
-
-  if (result.isSuccess) {
-    print("获取呼叫列表成功，列表信息: ${result.data}, 分页游标: ${result.cursor}");
-  } else {
-    print("获取呼叫列表失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
-  }
-}
-```
-
-#### **4. 订阅会中呼叫事件**
-
-作为呼叫方订阅 `RoomStore` 的 `roomEventPublisher` 能够实时获取呼叫的生命周期事件。通过监听以下回调，可以精准捕捉呼叫的最终结果并据此更新 UI 状态或执行后续业务逻辑。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-late RoomListener _listener;
-
-/// 订阅会中呼叫相关事件
-void addRoomCallListener() {
-  _listener = RoomListener(
-    onCallTimeout: (roomInfo, call) {
-      print("呼叫超时 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}");
-    },
-    onCallAccepted: (roomInfo, call) {
-      print("呼叫已被接受 房间信息: ${roomInfo.roomID}, 被呼叫者: ${call.callee.userID}");
-    },
-    onCallRejected: (roomInfo, call, reason) {
-      print("呼叫被拒绝 房间信息: ${roomInfo.roomID}, 被呼叫者: ${call.callee.userID}, 拒绝原因: $reason");
-    },
-    onCallHandledByOtherDevice: (roomInfo, isAccepted) {
-      print("呼叫已被其他设备处理 房间信息: ${roomInfo.roomID}, 处理结果: $isAccepted");
-    },
-  );
-
-  RoomStore.shared.addRoomListener(_listener);
-}
-
-void removeRoomCallListener() {
-  RoomStore.shared.removeRoomListener(_listener);
-}
-```
-
-**呼叫事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallTimeout](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncalltimeout(roominfo:call:)) | 呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。 |
-| [onCallAccepted](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallaccepted(roominfo:call:)) | 呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示双方已达成呼叫意图，呼叫方通常应立即执行进入房间或开始推流的操作。 |
-| [onCallRejected](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrejected(roominfo:call:reason:)) | 呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（如主动拒绝或在其他房间中）。 |
-| [onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallhandledbyotherdevice(roominfo:isaccepted:)) | 呼叫已在其他设备处理。当用户在多个设备（例如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。 |
-
-### 步骤3：被呼叫方功能
-
-#### **1. 订阅会中呼叫事件**
-
-作为被呼叫方订阅 `RoomStore` 的 `roomEventPublisher` 可以实时监听并响应来自呼叫方的呼叫行为。以下是构建呼叫提醒界面以及维护呼叫链路状态的关键事件。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-late RoomListener _listener;
-
-/// 订阅会中呼叫相关事件
-void addRoomCallListener() {
-  _listener = RoomListener(
-    onCallReceived: (roomInfo, call, extensionInfo) {
-      print("收到房间呼叫 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 扩展信息: $extensionInfo");
-    },
-    onCallCancelled: (roomInfo, call) {
-      print("呼叫被取消 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}");
-    },
-    onCallRevokedByAdmin: (roomInfo, call, operatorUser) {
-      print("呼叫被管理员移除 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 移除操作者: ${operatorUser.userID}");
-    },
-  );
-
-  RoomStore.shared.addRoomListener(_listener);
-}
-
-void removeRoomCallListener() {
-  RoomStore.shared.removeRoomListener(_listener);
-}
-```
-
-**事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallReceived](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallreceived(roominfo:call:extensioninfo:)) | 收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。 |
-| [onCallCancelled](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallcancelled(roominfo:call:)) | 呼叫被发起方取消。呼叫方在您未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。 |
-| [onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrevokedbyadmin(roominfo:call:operator:)) | 呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。 |
-
-#### **2. 接受呼叫、拒绝呼叫**
-
-作为被呼叫方调用`RoomStore`的`acceptCall`或者`rejectCall`接口，处理接受或者拒绝呼叫邀请。
-``` java
-import 'package:atomic_x_core/atomicxcore.dart';
-
-late RoomListener _listener;
-
-/// 订阅会中呼叫相关事件
-void addRoomCallListener() {
-  _listener = RoomListener(
-    onCallReceived: (roomInfo, call, extensionInfo) {
-      print("收到房间呼叫 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 扩展信息: $extensionInfo");
-      // 接受、拒绝呼叫邀请操作
-    },
-  );
-
-  RoomStore.shared.addRoomListener(_listener);
-}
-
-void removeRoomCallListener() {
-  RoomStore.shared.removeRoomListener(_listener);
-}
-
-// 接受呼叫邀请
-Future<void> acceptCall(String roomID) async {
-  final result = await RoomStore.shared.acceptCall(roomID);
-
-  if (result.isSuccess) {
-    print("接受呼叫成功，房间ID: $roomID");
-  } else {
-    print("接受呼叫失败: [错误码: ${result.errorCode}] ${result.errorMessage}");
-  }
-}
-
-// 拒绝呼叫邀请
-Future<void> rejectCall(String roomID, {CallRejectionReason reason = CallRejectionReason.rejected}) async {
-  final result = await RoomStore.shared.rejectCall(
-    roomID: roomID,
-    reason: reason,
-  );
-
-  if (result.isSuccess) {
-    print("拒绝呼叫成功，房间ID: $roomID");
-  } else {
-    print("拒绝呼叫失败: [错误码: ${result.errorCode}] ${result.errorMessage}");
-  }
-}
-```
-
-## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
-| --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 预定房间 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore) |

package/resource/doc/roomkit/vue/faq.md

@@ -1 +0,0 @@
-

package/resource/doc/roomkit/vue/features/device-state.md

@@ -1,460 +0,0 @@
-本文档指导您如何使用 Atomicx 组件和 `useDeviceState` Hook 来管理会议中的音视频设备（摄像头、麦克风、扬声器）状态，以及如何获取本地网络质量信息。
-
-## 功能介绍
-- **设备枚举与切换：**支持实时获取系统可用设备列表，并实现无缝切换。
-
-- **状态精细化控制：**提供开启/关闭、采集静音、音量调节及实时音量监测能力。
-
-- **错误诊断：**实时反馈硬件冲突、系统权限缺失等异常状态。
-
-- **网络质量监控：**提供包含延迟、丢包率在内的多维度网络信息。
-
-## 前提条件
-- 用户已经通过 [useLoginState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-LoginState) 完成登录鉴权，请参考 接入概览。
-
-- 若在 `iframe` 中集成，需在标签中声明权限。
-
-   ``` typescript
-   <iframe allow="microphone; camera;"></iframe>
-   ```
-
-## 实现摄像头管理
-
-您可以通过 [useDeviceState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState) 来控制本地摄像头的开关、切换设备，并监听采集状态和错误。
-
-### 步骤1：开启/关闭摄像头
-
-通过调用 [openLocalCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#openLocalCamera) 和 [closeLocalCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#closeLocalCamera) 方法来控制摄像头的开关。
-``` typescript
-import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-vue3/room';
-const { cameraStatus, openLocalCamera, closeLocalCamera } = useDeviceState();
-const toggleCamera = async () => {
-  if (cameraStatus.value === DeviceStatus.On) {
-    await closeLocalCamera();
-  } else {
-    await openLocalCamera();
-  }
-};
-```
-
-### 步骤2：获取/切换摄像头设备
-
-#### 桌面端获取和切换摄像头示例
-
-您可以通过 [cameraList](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#cameraList) 获取所有可用的摄像头设备，使用 [setCurrentCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setCurrentCamera) 方法切换当前使用的摄像头。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const { cameraList, currentCamera, getCameraList, setCurrentCamera } = useDeviceState();
-
-// 获取摄像头列表
-await getCameraList();
-
-// 遍历并显示可用摄像头
-cameraList.value.forEach((camera) => {
-  console.log(`摄像头: ${camera.deviceName} (${camera.deviceId})`);
-});
-
-// 切换到指定摄像头
-const switchCamera = async (deviceId: string) => {
-  try {
-    // 切换设备（如果摄像头已开启，会自动使用新设备重新采集）
-    await setCurrentCamera({ deviceId });
-    console.log('摄像头切换成功');
-  } catch (error) {
-    console.error('摄像头切换失败:', error);
-    // 切换失败时会保持使用原设备
-  }
-};
-
-// 监听当前摄像头变化
-watch(currentCamera, (camera) => {
-  if (camera) {
-    console.log('当前使用摄像头:', camera.deviceName);
-  }
-});
-```
-
-> **说明：**
->
-
-> 调用 [setCurrentCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setCurrentCamera) 切换设备时，如果摄像头已开启，Atomicx 会自动停止当前设备的采集，并使用新设备重新开始采集，视频流会无缝切换。如果切换失败，会保持使用原设备。
->
-
-#### 移动端切换摄像头示例
-
-移动端使用 [switchCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#switchCamera) 切换前后置摄像头。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const { isFrontCamera, switchCamera } = useDeviceState();
-
-// 判断是否为移动端
-const isMobile = /Android|webOS|iPhone|iPad|iPod/i.test(navigator.userAgent);
-
-// 切换前后置摄像头（仅移动端支持）
-const toggleCamera = async () => {
-  if (!isMobile) {
-    console.warn('前后置摄像头切换仅在移动端支持');
-    return;
-  }
-
-  // 切换到相反的摄像头
-  await switchCamera({ isFrontCamera: !isFrontCamera.value });
-  console.log(`已切换到${isFrontCamera.value ? '前置' : '后置'}摄像头`);
-};
-```
-
-### 步骤3：处理摄像头采集错误
-
-当摄像头采集发生错误时，您可以通过 [cameraLastError](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#cameraLastError) 属性获取错误信息。
-
-> 注意：
->
-
-> 常见的摄像头错误包括 `NoSystemPermission` (无系统权限) 和 `OccupiedError`（设备被占用）。您应基于此属性向用户展示明确的错误提示。
->
-
-``` typescript
-import { useDeviceState, DeviceError } from 'tuikit-atomicx-vue3/room';
-const { cameraLastError } = useDeviceState();
-
-// 监听摄像头错误
-watch(cameraLastError, (error) => {
-  switch (error) {
-    case DeviceError.NoSystemPermission:
-      console.error('摄像头权限被拒绝，请在系统设置中开启摄像头权限');
-      break;
-    case DeviceError.NoDeviceDetected:
-      console.error('未检测到摄像头设备');
-      break;
-    case DeviceError.OccupiedError:
-      console.error('摄像头被其他应用占用');
-      break;
-    case DeviceError.NotSupportCapture:
-      console.error('当前浏览器不支持摄像头采集');
-      break;
-    default:
-      break;
-  }
-});
-```
-
-## 实现麦克风管理
-
-您可以通过 [useDeviceState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState) 来控制本地麦克风的开关、静音、音量调节和实时音量显示，并监听采集状态和错误。
-
-### 步骤1：开启/关闭麦克风
-``` typescript
-import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-vue3/room';
-const { microphoneStatus, openLocalMicrophone, closeLocalMicrophone } = useDeviceState();
-const toggleMicrophone = async () => {
-  if (microphoneStatus.value === DeviceStatus.On) {
-    await closeLocalMicrophone();
-  } else {
-    await openLocalMicrophone();
-  }
-};
-```
-
-### 步骤2：获取/切换麦克风设备
-
-#### 桌面端浏览器获取/切换麦克风示例
-
-您可以通过 [microphoneList](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#microphoneList) 获取所有可用的麦克风设备，使用 [setCurrentMicrophone](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setCurrentMicrophone) 方法切换当前使用的麦克风。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-
-const {
-  microphoneList,
-  currentMicrophone,
-  getMicrophoneList,
-  setCurrentMicrophone
-} = useDeviceState();
-
-// 获取麦克风列表
-await getMicrophoneList();
-
-// 遍历并显示可用麦克风
-microphoneList.value.forEach((mic) => {
-  console.log(`麦克风: ${mic.deviceName} (${mic.deviceId})`);
-});
-
-// 切换到指定麦克风
-const switchMicrophone = async (deviceId: string) => {
-  await setCurrentMicrophone({ deviceId });
-};
-
-// 监听当前麦克风变化
-watch(currentMicrophone, (mic) => {
-  if (mic) {
-    console.log('当前使用麦克风:', mic.deviceName);
-  }
-});
-```
-
-### 步骤3：设置采集音量
-
-您可以使用 [setCaptureVolume](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setCaptureVolume) 方法来调整本地麦克风的采集音量。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const { captureVolume, setCaptureVolume } = useDeviceState();
-
-// 设置采集音量为 50%
-await setCaptureVolume(50);
-
-// 监听采集音量变化
-watch(captureVolume, (volume) => {
-  console.log('当前采集音量:', volume);
-});
-```
-
-### 步骤4：显示实时音量
-
-[currentMicVolume](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#currentMicVolume) 属性会实时更新本地麦克风的采集音量，可用于音量条的动态显示。
-``` typescript
-<template>
-  <div class="mic-volume">
-    <label>麦克风音量</label>
-    <div class="volume-bar-container">
-      <div
-        class="volume-bar"
-        :style="{ width: `${currentMicVolume}%` }"
-      />
-    </div>
-    <span>{{ currentMicVolume }}</span>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const { currentMicVolume } = useDeviceState();
-</script>
-
-<style scoped>
-.volume-bar-container {
-  width: 200px;
-  height: 8px;
-  background-color: #e0e0e0;
-  border-radius: 4px;
-  overflow: hidden;
-}
-
-.volume-bar {
-  height: 100%;
-  background-color: #4caf50;
-  transition: width 0.1s ease;
-}
-</style>
-```
-
-### 步骤5：处理麦克风采集错误
-
-当麦克风采集发生错误时，您可以通过 [microphoneLastError](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#microphoneLastError) 数据获取错误信息。
-``` typescript
-import { useDeviceState, DeviceError } from 'tuikit-atomicx-vue3/room';
-const { microphoneLastError } = useDeviceState();
-
-// 监听麦克风错误
-watch(microphoneLastError, (error) => {
-  switch (error) {
-    case DeviceError.NoSystemPermission:
-      console.error('麦克风权限被拒绝，请在系统设置中开启麦克风权限');
-      break;
-    case DeviceError.NoDeviceDetected:
-      console.error('未检测到麦克风设备');
-      break;
-    case DeviceError.OccupiedError:
-      console.error('麦克风被其他应用占用');
-      break;
-    case DeviceError.NotSupportCapture:
-      console.error('当前浏览器不支持麦克风采集');
-      break;
-    default:
-      break;
-  }
-});
-```
-
-## 实现扬声器管理
-
-扬声器（播放设备）主要涉及切换设备和设置播放音量。
-
-### 步骤1：获取/切换扬声器设备
-
-您可以通过 [speakerList](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#speakerList) 获取所有可用的扬声器设备，使用 [setCurrentSpeaker](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setCurrentSpeaker) 方法切换当前使用的扬声器。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const {
-  speakerList,
-  currentSpeaker,
-  getSpeakerList,
-  setCurrentSpeaker
-} = useDeviceState();
-
-// 获取扬声器列表
-await getSpeakerList();
-
-// 遍历并显示可用扬声器
-speakerList.value.forEach((speaker) => {
-  console.log(`扬声器: ${speaker.deviceName} (${speaker.deviceId})`);
-});
-
-// 切换到指定扬声器
-const switchSpeaker = async (deviceId: string) => {
-  await setCurrentSpeaker({ deviceId });
-};
-
-// 监听当前扬声器变化
-watch(currentSpeaker, (speaker) => {
-  if (speaker) {
-    console.log('当前使用扬声器:', speaker.deviceName);
-  }
-});
-```
-
-### 步骤2：设置播放音量
-
-您可以使用 [setOutputVolume](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setOutputVolume) 方法来调整扬声器的播放音量。
-``` typescript
-import { useDeviceState } from 'tuikit-atomicx-vue3/room';
-const { outputVolume, setOutputVolume } = useDeviceState();
-
-// 设置播放音量为 60%
-await setOutputVolume(60);
-
-// 监听播放音量变化
-watch(outputVolume, (volume) => {
-  console.log('当前播放音量:', volume);
-});
-```
-
-## 实现网络质量监控
-
-使用 [useDeviceState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState) 中的 [networkInfo](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#networkInfo) 数据，您可以实时监控本地用户的网络质量。
-
-> **说明：**
->
-
-> 仅当本地用户通过 [joinRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#joinRoom)加入房间并打开麦克风或摄像头时，[networkInfo](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#networkInfo) 中才可以拿到有效数据。
->
-
-``` typescript
-<template>
-  <div class="network-indicator" @click="showDetails = !showDetails">
-    <TUIIcon v-if="networkIcon" :icon="networkIcon" />
-    <span class="network-text">{{ networkText }}</span>
-    <div v-if="showDetails" class="network-details">
-      <div>延迟: {{ networkInfo?.delay }}ms</div>
-      <div>上行丢包: {{ networkInfo?.upLoss }}%</div>
-      <div>下行丢包: {{ networkInfo?.downLoss }}%</div>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { computed, ref } from 'vue';
-import {
-  IconNetworkStability,
-  IconNetworkFluctuation,
-  IconNetworkLag,
-  IconNetworkDisconnected,
-  IconArrowStrokeUp,
-} from '@tencentcloud/uikit-base-component-vue3';
-import { useDeviceState, NetworkQuality } from 'tuikit-atomicx-vue3/room';
-
-const { networkInfo } = useDeviceState();
-const showDetails = ref(false);
-
-// 网络质量图标
-const networkIcon = computed(() => {
-  if (!networkInfo.value) return '';
-  switch (networkInfo.value.quality) {
-    case NetworkQuality.Excellent:
-    case NetworkQuality.Good:
-      return IconNetworkStability;
-    case NetworkQuality.Poor:
-      return IconNetworkFluctuation;
-    case NetworkQuality.Bad:
-    case NetworkQuality.VeryBad:
-      return IconNetworkLag;
-    case NetworkQuality.Down:
-      return IconNetworkDisconnected;
-    default:
-      return '';
-  }
-});
-
-// 网络质量文本
-const networkText = computed(() => {
-  if (!networkInfo.value) return '未知';
-  switch (networkInfo.value.quality) {
-    case NetworkQuality.Excellent:
-      return '优秀';
-    case NetworkQuality.Good:
-      return '良好';
-    case NetworkQuality.Poor:
-      return '一般';
-    case NetworkQuality.Bad:
-      return '差';
-    case NetworkQuality.VeryBad:
-      return '很差';
-    case NetworkQuality.Down:
-      return '断开';
-    default:
-      return '未知';
-  }
-});
-</script>
-
-<style scoped>
-
-.network-indicator {
-  position: relative;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  padding: 8px 12px;
-  border-radius: 4px;
-  cursor: pointer;
-}
-
-.network-details {
-  position: absolute;
-  top: 100%;
-  left: 0;
-  margin-top: 4px;
-  padding: 8px;
-  background: white;
-  border-radius: 4px;
-  box-shadow: 0 2px 8px rgba(0,0,0,0.15);
-  font-size: 12px;
-  white-space: nowrap;
-  z-index: 2;
-}
-</style>
-```
-
-## API 文档
-| **State/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **useDeviceState** | 包含音视频设备状态，音视频设备列表及操作接口。 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState) |
-
-## 常见问题
-
-### 如果用户的电脑无麦克风或扬声器设备，是否可以进入音视频房间？
-
-可以进入房间。 用户在缺少麦克风、扬声器或摄像头的情况下，依然可以调用 `joinRoom` 接口成功进入音视频房间。但在这种状态下，用户将面临以下交互异常。
-
-**功能限制：**
-- **无法开启媒体采集：**由于系统底层无法驱动相关硬件，调用 [openLocalMicrophone](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#openLocalMicrophone) 或 [openLocalCamera](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#openLocalCamera) 接口时将触发异步错误。此时，[microphoneLastError](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#microphoneLastError) 或 [cameraLastError](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#cameraLastError) 属性将返回 `DeviceError.NoDeviceDetected`（未检测到设备）。
-
-- **采集端受限：**无法通过本端设备采集并传输声音（需麦克风）或影像（需摄像头）。
-
-- **播放端受限：**由于缺少扬声器设备，用户将无法听到房间内其他参会者的音频。
-
-   **仍然可以使用的功能：**
-
-   仅观看模式：用户依然可以观看远端参会者分享的视频流或屏幕共享画面。
-
-### 如何实现设备热插拔检测？
-
-Atomicx 已经内置了设备热插拔检测功能，当媒体设备插拔时，设备列表和当前设备数据会自动更新。