rtc-detect 用于检测当前环境在由 TRTC SDK 构建的 WebRTC 应用程序中是否工作顺利。
简体中文 | English
rtc-detect 用来检测当前环境对 TRTC SDK 的支持度。
npm install rtc-detectimport RTCDetect from 'rtc-detect';
// 初始化监测模块
const detect = new RTCDetect();
// 获得当前环境监测结果
const result = await detect.getReportAsync();
console.log('result is: ' + result);判断当前环境是否支持 TRTC。
const detect = new RTCDetect();
const data = await detect.isTRTCSupported();
if (data.result) {
console.log('current browser supports TRTC.')
} else {
console.log(`current browser does not support TRTC, reason: ${data.reason}.`)
}获取当前系统环境参数。
| Item | Type | Description |
|---|---|---|
| UA | string | 浏览器的 ua |
| OS | string | 当前设备的系统型号 |
| browser | object | 当前浏览器信息{ name, version } |
| displayResolution | object | 当前分辨率 { width, height } |
| getHardwareConcurrency | number | 当前设备 CPU 核心数 |
const detect = new RTCDetect();
const result = detect.getSystem();获取当前环境 API 支持度。
| Item | Type | Description |
|---|---|---|
| isUserMediaSupported | boolean | 是否支持获取用户媒体数据流 |
| isWebRTCSupported | boolean | 是否支持 WebRTC |
| isWebSocketSupported | boolean | 是否支持 WebSocket |
| isWebAudioSupported | boolean | 是否支持 WebAudio |
| isScreenCaptureAPISupported | boolean | 是否支持获取屏幕的流 |
| isCanvasCapturingSupported | boolean | 是否支持从 canvas 获取数据流 |
| isVideoCapturingSupported | boolean | 是否支持从 video 获取数据流 |
| isRTPSenderReplaceTracksSupported | boolean | 是否支持替换 track 时不和 peerConnection 重新协商 |
| isApplyConstraintsSupported | boolean | 是否支持变更摄像头的分辨率不通过重新调用 getUserMedia |
const detect = new RTCDetect();
const result = detect.getAPISupported();获取当前环境可用的设备。
| Item | Type | Description |
|---|---|---|
| hasWebCamPermissions | boolean | 是否支持获取用户摄像头数据 |
| hasMicrophonePermission | boolean | 是否支持获取用户麦克风数据 |
| cameras | array | 用户的摄像头设备列表，包含摄像头支持的分辨率信息，最大宽高以及最大帧率（最大帧率有部分浏览器不支持） |
| microphones | array | 用户的麦克风设备列表 |
| speakers | array | 用户的扬声器设备列表 |
CameraItem
| Item | Type | Description |
|---|---|---|
| deviceId | string | 设备 ID， 通常是唯一的，可以用于采集识别设备 |
| groupId | string | 组的标识符，如果两个设备属于同一个物理设备，他们就有相同的标识符 |
| kind | string | 摄像头设备类型：'videoinput' |
| label | string | 描述该设备的标签 |
| resolution | object | 摄像头支持的最大分辨率的宽高和帧率 {maxWidth: 1280, maxHeight: 720, maxFrameRate: 30} |
DeviceItem
| Item | Type | Description |
|---|---|---|
| deviceId | string | 设备 ID， 通常是唯一的，可以用于采集识别设备 |
| groupId | string | 组的标识符，如果两个设备属于同一个物理设备，他们就有相同的标识符 |
| kind | string | 设备类型，例如: 'audioinput', 'audiooutput' |
| label | string | 描述该设备的标签 |
const detect = new RTCDetect();
const result = await detect.getDevicesAsync();获取当前环境参数对编码的支持度。
| Item | Type | Description |
|---|---|---|
| isH264EncodeSupported | boolean | 是否支持 h264 上行 |
| isH264DecodeSupported | boolean | 是否支持 h264 下行 |
| isVp8EncodeSupported | boolean | 是否支持 vp8 上行 |
| isVp8DecodeSupported | boolean | 是否支持 vp8 下行 |
const detect = new RTCDetect();
const result = await detect.getCodecAsync();获取当前环境监测报告。
| Item | Type | Description |
|---|---|---|
| system | object | 和 getSystem() 的返回值一致 |
| APISupported | object | 和 getAPISupported() 的返回值一致 |
| codecsSupported | object | 和 getCodecAsync() 的返回值一致 |
| devices | object | 和 getDevicesAsync() 的返回值一致 |
const detect = new RTCDetect();
const result = await detect.getReportAsync();检测 Chrome 浏览器是否开启硬件加速。
注意：该接口的实现依赖于 WebRTC 原生接口，建议在 isTRTCSupported 检测支持后，再调用该接口进行检测。检测最长耗时 30s。经实测：
- 开启硬件加速的情况下，该接口在 Windows 耗时 2s 左右， Mac 需耗时 10s 左右。
- 关闭硬件加速的情况下，该接口在 Windows 和 Mac 耗时均为 30s。
const detect = new RTCDetect();
const data = await detect.isTRTCSupported();
if (data.result) {
const result = await detect.isHardWareAccelerationEnabled();
console.log(`is hardware acceleration enabled: ${result}`);
} else {
console.log(`hardware acceleration is disabled`)
}Bug Fixed
- 修复了 Safari 上资源占用问题。
Feature
- 从
getDevicesAsync()获取的camera参数新增maxFrameRate参数，代表摄像头可以支持的最大帧率。
Improvement
- 新增检测不支持 WebRTC 时的原因提示
Feature
- 新增
isHardWareAccelerationEnable()方法，检测 Chrome 浏览器是否开启硬件加速。
Improvement
- 优化部分参数的命名