Media Capabilities API - 允许开发人员确定设备的解码和编码能力

Media Capabilities API（媒体功能 API）允许开发人员确定设备的解码和编码能力，提供诸如是否支持媒体以及播放是否应该流畅和节能等信息。通过对播放的实时反馈，更好地实现自适应流媒体，并访问显示属性信息。

实例

检测音频文件支持和预期性能

这个例子定义了一个音频配置，然后检查用户代理是否支持解码该媒体配置，以及它在平滑度和功率效率方面是否表现良好。

if ('mediaCapabilities' in navigator) {
  const audioFileConfiguration = {
    type : 'file',
    audio : {
        contentType: "audio/mp3",
        channels: 2,
        bitrate: 132700,
        samplerate: 5200
    }
  };

  navigator.mediaCapabilities.decodingInfo(audioFileConfiguration).then(result => {
    console.log('该配置是' +                     
        (result.supported ? '' : '不') + '支持的，' +
        (result.smooth ? '' : '不') + '平滑的，且' +
        (result.powerEfficient ? '' : '不') + '节能的。');
    })
    .catch(() => {
      console.log("解码信息错误：" + contentType)
    });
}

Media Capabilities API 概念和用法

有无数的视频和音频编解码器。不同的浏览器支持不同的媒体类型，新的媒体类型一直在开发中。借助 Media Capabilities API，开发人员可以确保每个用户都能获得适合其浏览器、设备和操作系统能力的最佳比特率和占用最小空间。

设备使用硬件解码还是软件解码会影响视频解码的流畅度和功率效率以及播放的效率。Media Capabilities API可以确定支持哪些编解码器，以及媒体文件在平滑度和电源效率方面的性能。

Media Capabilities API 提供了比 MediaRecorder.isTypeSupported() 或 HTMLMediaElement.canPlayType() 更强大的功能，后者仅解决一般浏览器支持，而不是性能。API 还提供访问显示属性信息的功能，例如支持的色域、动态范围功能和有关播放的实时反馈。

要测试视频或音频文件的支持、流畅度和是否节能，您可以定义要测试的媒体配置，然后将音频或视频配置作为 MediaCapabilities 接口的 encodingInfo() 和 decodingInfo() 方法的参数。

媒体功能信息使网站能够启用自适应流媒体，以根据用户实际感知的质量来改变内容质量，并对 CPU/GPU 的使用情况做出实时反应。

媒体功能接口