- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- Live 视频直播计费说明
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- Live 视频直播计费说明
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
简介
TUIDeviceManager 是音视频设备管理器，用于管理摄像头、麦克风和扬声器等音视频相关的硬件设备。安装方式：
// 使用 npmnpm i @tencentcloud/tuiroom-engine-electron@2.4.0-alpha.3 --save// 使用 pnpmpnpm i @tencentcloud/tuiroom-engine-electron@2.4.0-alpha.3 --save// 使用 yarnyarn add @tencentcloud/tuiroom-engine-electron@2.4.0-alpha.3
使用示例：
import TUIRoomEngine, {TUIDeviceManager, TUIDeviceInfo} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const cameraList: Array<TUIDeviceInfo> = deviceManager.getCameraDevicesList();
API
方法 | 说明 |
获取摄像头设备列表 | |
获取麦克风设备列表 | |
获取扬声器设备列表 | |
设置当前设备 | |
获取当前设备 | |
设置当前设备音量 | |
获取当前设备音量 | |
静音当前设备 | |
获取当前设备静音状态 | |
启动系统设备跟随 | |
开启麦克风测试 | |
结束麦克风测试 | |
开启扬声器测试 | |
结束扬声器测试 | |
开启摄像头测试 | |
结束摄像头测试 | |
摄像头测试时，开启镜像 | |
摄像头测试时，设置摄像头设备 | |
摄像头测试时，设置摄像头采集分辨率 | |
摄像头测试时，设置视频预处理插件库文件路径 | |
摄像头测试时，设置视频预处理参数 | |
注册事件监听 | |
取消事件监听 |
类型定义
类型 | 说明 |
摄像头采集参数 | |
音视频设备信息 | |
矩形坐标区域 |
枚举定义
枚举 | 说明 |
摄像头采集模式 | |
音视频设备事件类型 | |
音视频设备状态 | |
音视频设备类型 |
API 详情
getCameraDevicesList
获取摄像头设备列表
import TUIRoomEngine, {TUIDeviceManager, TUIDeviceInfo} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const cameraList: Array<TUIDeviceInfo> = deviceManager.getCameraDevicesList();
参数
无
返回值
Array<
TUIDeviceInfo>getMicDevicesList
获取麦克风设备列表
import TUIRoomEngine, {TUIDeviceManager, TUIDeviceInfo} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const cameraList: Array<TUIDeviceInfo> = deviceManager.getMicDevicesList();
参数
无
返回值
Array<
TUIDeviceInfo>getSpeakerDevicesList
获取扬声器设备列表
import TUIRoomEngine, {TUIDeviceManager, TUIDeviceInfo} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const cameraList: Array<TUIDeviceInfo> = deviceManager.getSpeakerDevicesList();
参数
无
返回值
Array<
TUIDeviceInfo>setCurrentDevice
设置当前设备
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCurrentDevice(TUIMediaDeviceType.kMediaDeviceTypeAudioOutput, 'Your speaker ID');
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 | |
deviceId | string | - | - | 设备 ID |
返回值
Promise<void>getCurrentDevice
获取当前设备
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const currentSpeaker:TUIDeviceInfo = await deviceManager.getCurrentDevice(TUIMediaDeviceType.kMediaDeviceTypeAudioOutput);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 |
返回值
Promise<TUIDeviceInfo>setCurrentDeviceVolume
设置当前设备音量
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCurrentDeviceVolume(TUIMediaDeviceType.kMediaDeviceTypeAudioInput, value);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 | |
volume | number | [0-100] | 60 | 音量 |
返回值
Promise<void>getCurrentDeviceVolume
获取当前设备音量
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const currentMicVolume = await deviceManager.getCurrentDeviceVolume(TUIMediaDeviceType.kMediaDeviceTypeAudioInput);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 |
返回值
Promise<number>setCurrentDeviceMute
静音当前设备
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCurrentDeviceMute(TUIMediaDeviceType.kMediaDeviceTypeAudioInput, true);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 | |
mute | boolean | - | - | 是否静音 |
返回值
Promise<void>getCurrentDeviceMute
获取当前设备静音状态
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const isCurrentMicMuted = await deviceManager.getCurrentDeviceMute(TUIMediaDeviceType.kMediaDeviceTypeAudioInput, true);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 |
返回值
Promise<boolean>enableFollowingDefaultAudioDevice
启动系统设备跟随
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.enableFollowingDefaultAudioDevice(TUIMediaDeviceType.kMediaDeviceTypeAudioInput, true);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
type | - | - | 设备类型 | |
enable | boolean | - | - | 是否跟随系统默认的音频设备 |
返回值
Promise<void>startMicDeviceTest
开启麦克风测试
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.startMicDeviceTest(300, true);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
interval | number | - | - | 麦克风音量的回调间隔，单位：毫秒。 |
playback | boolean | - | - | 是否开启麦克风声音回播，开启后用户测试麦克风时会听到自己的声音，如果不传递playback参数，则默认为false。 |
返回值
Promise<void>stopMicDeviceTest
结束麦克风测试
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.stopMicDeviceTest();
参数
无
返回值
Promise<void>startSpeakerDeviceTest
开启扬声器测试
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const audioFilePath = '';deviceManager.startSpeakerDeviceTest(audioFilePath);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
filePath | string | 有效音频文件路径 | - | 测试音频文件路径 |
返回值
Promise<void>stopSpeakerDeviceTest
结束扬声器测试
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.stopSpeakerDeviceTest();
参数
无
返回值
Promise<void>startCameraDeviceTest
开启摄像头测试
import TUIRoomEngine, {TUIDeviceManager, TUIRect} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const rect: TUIRect = {left: 100,top: 50,right: 740,bottom: 410,};const windowID: Uint8Array; // 通过 Electron API BrowserWindow.getNativeWindowHandle() 拿到deviceManager.startCameraDeviceTest(windowID, rect);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
windowID | Uint8Array | - | - | 预览摄像头画面的窗口 ID，通过 Electron API BrowserWindow.getNativeWindowHandle() 拿到。 |
rect | - | - | 摄像头画面显示在窗口内的位置区域 |
返回值
Promise<void>stopCameraDeviceTest
结束摄像头测试
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.stopCameraDeviceTest();
参数
无
返回值
Promise<void>setCameraTestRenderMirror
摄像头测试时，开启镜像。
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCameraTestRenderMirror(true);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
mirror | boolean | - | - | 是否开启镜像 |
返回值
Promise<void>setCameraTestDeviceId
摄像头测试时，设置摄像头设备。
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCameraTestDeviceId('Your camera ID');
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
cameraId | string | - | - | 摄像头设备 ID |
返回值
Promise<void>setCameraTestResolution
摄像头测试时，设置摄像头采集分辨率。
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCameraTestResolution(1920, 1080);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
width | number | - | - | 采集宽度 |
height | number | - | - | 采集高度 |
返回值
Promise<void>setCameraTestVideoPluginPath
摄像头测试时，设置视频预处理插件库文件路径。
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCameraTestVideoPluginPath('Your library path');
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
path | string | - | - | 视频预处理插件库文件路径 |
返回值
Promise<void>setCameraTestVideoPluginParameter
摄像头测试时，设置视频预处理参数。
import TUIRoomEngine, {TUIDeviceManager} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();deviceManager.setCameraTestVideoPluginParameter('{}'); // JSON string
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
params | string | - | - | JSON 字符串 |
返回值
Promise<void>on
注册事件监听
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType, TUIMediaDeviceState} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const onDeviceChanged = (deviceId: string, type: TUIMediaDeviceType, state: TUIMediaDeviceState) => {// ...}deviceManager.on(TUIMediaDeviceEventType.onDeviceChanged, onDeviceChanged);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
eventName | - | - | 事件名称 | |
func | (...args: any[]) => void | - | - | 事件回调函数 |
返回值
Promise<void>off
取消事件监听
import TUIRoomEngine, {TUIDeviceManager, TUIMediaDeviceType, TUIMediaDeviceState} from '@tencentcloud/tuiroom-engine-electron';const deviceManager:TUIDeviceManager = TUIRoomEngine.getDeviceManager();const onDeviceChanged = (deviceId: string, type: TUIMediaDeviceType, state: TUIMediaDeviceState) => {// ...}deviceManager.off(TUIMediaDeviceEventType.onDeviceChanged, onDeviceChanged);
参数
参数 | 类型 | 校验 | 默认值 | 说明 |
eventName | - | - | 事件名称 | |
func | (...args: any[]) => void | - | - | 事件回调函数 |
返回值
Promise<void>类型详情
TUICameraCaptureParam
摄像头采集参数
字段 | 类型 | 说明 |
mode | 摄像头采集偏好 | |
width | number | 采集图像宽度 |
height | number | 采集图像高度 |
TUIDeviceInfo
音视频设备信息
字段 | 类型 | 说明 |
deviceId | string | 设备 ID |
deviceName | string | 设备名称 |
deviceProperties | Record<string, any> | 设备属性。仅摄像头支持，包含摄像头支持的采集分辨率。 |
TUIRect
矩形坐标区域
字段 | 类型 | 说明 |
left | number | 左边线坐标 |
top | number | 顶边线坐标 |
right | number | 右边线坐标 |
bottom | number | 底边线坐标 |
枚举详情
TUICameraCaptureMode
摄像头采集模式
枚举项 | 类型 | 值 | 说明 |
kCameraResolutionStrategyAuto | number | 0 | 自动调整采集参数。SDK 根据实际的采集设备性能及网络情况，选择合适的摄像头输出参数，在设备性能及视频预览质量之间，维持平衡。 |
kCameraResolutionStrategyPerformance | number | 1 | 优先保证设备性能。SDK 根据用户设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。 |
kCameraResolutionStrategyHighQuality | number | 2 | 优先保证视频预览质量。SDK选择较高的摄像头输出参数，从而提高预览视频的质量。在这种情况下，会消耗更多的 CPU 及内存做视频前处理。 |
kCameraCaptureManual | number | 3 | 允许用户设置本地摄像头采集的视频宽高。 |
TUIMediaDeviceEventType
音视频设备事件类型
枚举项 | 类型 | 值 | 说明 |
string | 'onDeviceChanged' | 设备状态变化事件 |
TUIMediaDeviceState
音视频设备状态
枚举项 | 类型 | 值 | 说明 |
kMediaDeviceStateAdd | number | 0 | 设备已被插入 |
kMediaDeviceStateRemove | number | 1 | 设备已被移除 |
kMediaDeviceStateActive | number | 2 | 设备已启用 |
kMediaDefaultDeviceChanged | number | 3 | 系统默认设备变更 |
TUIMediaDeviceType
音视频设备类型
枚举项 | 类型 | 值 | 说明 |
kMediaDeviceTypeUnknown | number | -1 | 未知类型 |
kMediaDeviceTypeAudioInput | number | 0 | 麦克风 |
kMediaDeviceTypeAudioOutput | number | 1 | 扬声器 |
kMediaDeviceTypeVideoCamera | number | 2 | 摄像头 |
事件详情
onDeviceChanged
设备状态变化事件
参数 | 类型 | 含义 |
deviceID | string | 设备 ID |
type | 设备类型 | |
state | 设备状态 |
是
否
本页内容是否解决了您的问题？