MediaCapabilities encodingInfo：摄像与录制管线能力评估

--- title: MediaCapabilities encodingInfo：摄像与录制管线能力评估 keywords: - MediaCapabilities - encodingInfo - 录制 - 视频编码 - 硬件加速 description: 使用 MediaCapabilities 的 encodingInfo 评估端侧编码能力，选择合适分辨率、码率与帧率以达成平滑与节能录制。 categories: - 应用软件 - 图形图像 --- ## 概述 `navigator.mediaCapabilities.encodingInfo` 返回编码配置的支持性（`supported`）、流畅度（`smooth`）与能效（`powerEfficient`），帮助在拍摄与录制场景中做参数选型与降级策略。 ## 用法/示例 ```js const enc = await navigator.mediaCapabilities.encodingInfo({ type: 'record', video: { contentType: 'video/webm;codecs=vp8', width: 1920, height: 1080, bitrate: 4000000, framerate: 30 } }) if (enc.supported && enc.smooth && enc.powerEfficient) { const stream = await navigator.mediaDevices.getUserMedia({ video: { width: 1920, height: 1080, frameRate: 30 } }) const rec = new MediaRecorder(stream, { mimeType: 'video/webm;codecs=vp8', videoBitsPerSecond: 4000000 }) } ``` ```js const audioEnc = await navigator.mediaCapabilities.encodingInfo({ type: 'record', audio: { contentType: 'audio/webm;codecs=opus', channels: 2, bitrate: 128000, samplerate: 48000 } }) ``` ## 工程建议 - 按设备能力选择分辨率与码率，优先平滑与能效。 - 对不支持的配置回退至更低规格，并记录能力探测结果用于后续会话。 - 与 `MediaRecorder`、`getUserMedia` 的约束协同，避免动态切换导致的中断。 ## 参考与验证 - MDN：MediaCapabilities — https://developer.mozilla.org/docs/Web/API/Media_Capabilities_API - MDN：`encodingInfo` — https://developer.mozilla.org/docs/Web/API/MediaCapabilities/encodingInfo - web.dev：Media Capabilities — https://web.dev/articles/media-capabilities