MediaCapabilitiesInfo

Media Capabilities API (en-US) の MediaCapabilitiesInfo インターフェイスは、MediaCapabilities (en-US) インターフェイスの MediaCapabilities.encodingInfo() メソッドまたは MediaCapabilities.decodingInfo() (en-US) メソッドによって返される promise が満たされると使用可能になり、メディアタイプがサポートされているかどうかや、そのようなメディアのエンコードまたはデコードがスムーズで電力効率が良いかどうかに関する情報を提供します。

プロパティ

MediaCapabilitiesInfo インターフェイスには、次の 3 つの Boolean 属性が含まれています。

  • supported: MediaConfiguration で定義されたプロパティを指定すると、指定されたメディアコンテンツをエンコード（MediaEncodingConfiguration (en-US) が設定されている場合）またはデコード（MediaDecodingConfiguration (en-US) が設定されている場合）できますか？ はいの場合、supported は true になり、そうでない場合、false になります。
  • smooth: MediaConfiguration で定義されたプロパティを指定すると、指定されたメディアの再生は高品質になりますか？ スムーズになりますか？ supported が true で、再生がスムーズになる場合、smooth は true になり、そうでない場合、false になります。
  • powerEfficient: MediaConfiguration で定義されたプロパティを指定すると、指定されたメディアの再生は電力効率が良くなりますか？ supported が true で、再生の電力効率が良い場合、powerEfficient は true になり、そうでない場合、false になります。

ブラウザーは、このデバイスの統計情報が記録されるまで、サポートしているメディア構成を smooth で powerEfficient として報告します。 サポートしているすべての音声コーデックは、電力効率が良いと報告されます。

例

// テストする MediaConfiguration
const mediaConfig = {
    type : 'file',
    audio : {
        contentType : "audio/ogg",
        channels : 2,
        bitrate : 132700,
        samplerate : 5200
     },
};

// サポートとパフォーマンスを確認する
navigator.mediaCapabilities.decodingInfo(mediaConfig).then(result => { // result にはメディア能力情報が含まれます
    console.log('この構成は、サポート' +
        (result.supported ? 'され' : 'されておらず') + 、スムーズ' +   // 構成されたメディアは、ユーザーエージェントによってデコードできますか
        (result.smooth ? 'であり' : 'でなく') + '、電力効率' +         // スムーズですか？
        (result.powerEfficient ? 'に優れています' : 'が良くありません') + '。') // 電力効率は良いですか？
});

仕様

Specification
Media Capabilities
# ref-for-dom-mediacapabilities-encodinginfo

ブラウザーの互換性

BCD tables only load in the browser

関連情報