Media Capabilities API
MediaCapabilities 接口的 encodingInfo() 方法返回一个会兑现经过测试的媒体配置在编码媒体时的能力信息的 promise。其包含三个布尔属性:supported(是否支持)、smooth(能否流畅播放)和 powerefficient(播放是否省电),以描述设备与此媒体类型的兼容性。
语法
encodingInfo(configuration)
参数
configuration- : 具有
type属性以及video或audio属性(包含适当类型的配置)的对象:-
type- : 测试的媒体类型。可取以下两个值之一:
record- : 表示用于录制媒体的配置,例如使用 MediaRecorder。
webrtc- : 表示用于通过电子方式传输(例如,使用 RTCPeerConnection)的配置。注意:Firefox 使用
transmission来表示这个类型,而webrtc不起作用。
- : 表示用于通过电子方式传输(例如,使用 RTCPeerConnection)的配置。注意:Firefox 使用
transmission- : Firefox 中使用的
webrtc的同义词。
- : Firefox 中使用的
- : 测试的媒体类型。可取以下两个值之一:
-
video- : 用于配置视频媒体源的对象。其具有以下属性:
contentType- : 包含有效视频 MIME 类型以及(可选的)
codecs参数的字符串。
- : 包含有效视频 MIME 类型以及(可选的)
width- : 视频的宽度。
height- : 视频的高度。
bitrate- : 编码视频文件的 1 秒内容所需的比特数。
framerate- : 构成视频播放的 1 秒内容的帧数。
- : 用于配置视频媒体源的对象。其具有以下属性:
-
audio- : 用于配置音频媒体源的对象。其具有以下属性:
contentType- : 包含有效音频 MIME 类型以及(可选的)
codecs参数的字符串。
- : 包含有效音频 MIME 类型以及(可选的)
channels- : 音轨使用的声道数。
bitrate- : 编码音频文件 1 秒内容所需的比特数。
samplerate- : 构成音频文件 1 秒内容的音频采样数。
- : 用于配置音频媒体源的对象。其具有以下属性:
-
- : 具有
返回值
Promise,其会兑现一个包含三个布尔属性的对象:
supported- : 如果媒体内容可以被编码,则为
true。否则为false。
- : 如果媒体内容可以被编码,则为
smooth- : 如果媒体可以被流程(或高质量)播放,则为
true。否则为false。
- : 如果媒体可以被流程(或高质量)播放,则为
powerEfficient- : 如果媒体的播放是省电的,则为
true。否则为false。
- : 如果媒体的播放是省电的,则为
浏览器将在设备的统计信息被记录后,再将受支持的媒体配置报告为能流畅播放(smooth)且播放是省电的(powerEfficient)。所有受支持的音频编解码器都将报告为播放是省电的。
异常
- TypeError
- : 如果向
encodingInfo()方法传递的configuration是无效的,则会抛出此异常,可能的原因如下:- 类型不是视频或音频
contentType不是有效的编解码器 MIME 类型- 传递给此方法的媒体配置中有一些其他错误,包括省略任何
configuration元素。
- : 如果向
示例
// 创建用于测试的媒体配置
const mediaConfig = {
type: "record", // 或“transmission”
video: {
contentType: "video/webm;codecs=vp8.0", // 有效内容类型
width: 1920, // 视频宽度
height: 1080, // 视频高度
bitrate: 120000, // 用于对 1 秒的视频内容进行编码的比特数
framerate: 48, // 组成 1 秒内容的帧数
},
};
// 检查支持和性能
navigator.mediaCapabilities.encodingInfo(mediaConfig).then((result) => {
console.log(`此配置${result.supported ? "" : "不"}受支持,`);
console.log(`${result.smooth ? "" : "不"}能流畅编码,且`);
console.log(`${result.powerEfficient ? "" : "不"}省电。`);
});
规范
浏览器兼容性
参见
- MediaCapabilities.decodingInfo()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
