--- title: MediaCapabilitiesInfo slug: Web/API/MediaCapabilitiesInfo tags: - API - Audio - Experimental - Interface - Media Capabilities API - MediaCapabilitiesInfo - Reference - Video translation_of: Web/API/MediaCapabilitiesInfo --- <p>{{APIRef("Media Capabilities API")}}</p> <p><span class="seoSummary"><a href="/ja/docs/Web/API/Media_Capabilities_API">Media Capabilities API</a> の <strong><code>MediaCapabilitiesInfo</code></strong> インターフェイスは、{{domxref("MediaCapabilities")}} インターフェイスの {{domxref("MediaCapabilities.encodingInfo()")}} メソッドまたは {{domxref("MediaCapabilities.decodingInfo()")}} メソッドによって返される promise が満たされると使用可能になり、メディアタイプがサポートされているかどうかや、そのようなメディアのエンコードまたはデコードがスムーズで電力効率が良いかどうかに関する情報を提供します。</span></p> <h2 id="Properties" name="Properties">プロパティ</h2> <p><code>MediaCapabilitiesInfo</code> インターフェイスには、次の3つの Boolean 属性が含まれています。</p> <ul> <li><code>supported</code>: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアコンテンツをエンコード({{domxref("MediaEncodingConfiguration")}} が設定されている場合)またはデコード({{domxref("MediaDecodingConfiguration")}} が設定されている場合)できますか? はいの場合、<code>supported</code> は <em>true</em> になり、そうでない場合、<em>false</em> になります。</li> <li><code>smooth</code>: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアの再生は高品質になりますか? スムーズになりますか? <code>supported</code> が <code>true</code> で、再生がスムーズになる場合、<code>smooth</code> は <em>true</em> になり、そうでない場合、<em>false</em> になります。</li> <li><code>powerEfficient</code>: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアの再生は電力効率が良くなりますか? <code>supported</code> が <code>true</code> で、再生の電力効率が良い場合、<code>powerEfficient</code> は <em>true</em> になり、そうでない場合、<em>false</em> になります。</li> </ul> <p>ブラウザーは、このデバイスの統計情報が記録されるまで、サポートしているメディア構成を <code>smooth</code> で <code>powerEfficient</code> として報告します。 サポートしているすべての音声コーデックは、電力効率が良いと報告されます。</p> <h2 id="Example" name="Example">例</h2> <pre class="brush: js">// テストする {{domxref("MediaConfiguration")}} const mediaConfig = { type : 'file', audio : {<code class="language-js"> contentType <span class="punctuation token">:</span> <span class="string token">"audio/ogg"</span><span class="punctuation token">,</span> channels <span class="punctuation token">:</span> <span class="number token">2</span><span class="punctuation token">,</span> bitrate <span class="punctuation token">:</span> <span class="number token">132700</span><span class="punctuation token">,</span> samplerate <span class="punctuation token">:</span> <span class="number token">5200</span> </code>}, }; // サポートとパフォーマンスを確認する navigator.mediaCapabilities.decodingInfo(mediaConfig).then(result => { // result にはメディア能力情報が含まれます console.log('この構成は、サポート' + (result.supported ? 'され' : 'されておらず') + 、スムーズ' + // 構成されたメディアは、ユーザーエージェントによってデコードできますか (result.smooth ? 'であり' : 'でなく') + '、電力効率' + // スムーズですか? (result.powerEfficient ? 'に優れています' : 'が良くありません') + '。') // 電力効率は良いですか? });</pre> <h2 id="Specifications" name="Specifications">仕様</h2> <table class="standard-table"> <thead> <tr> <th scope="col">仕様</th> <th scope="col">状態</th> <th scope="col">コメント</th> </tr> </thead> <tbody> <tr> <td>{{SpecName('Media Capabilities','#media-capabilities-info','MediaCapabilitiesInfo')}}</td> <td>{{Spec2('Media Capabilities')}}</td> <td>初期定義</td> </tr> </tbody> </table> <h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> <p>{{Compat("api.MediaCapabilitiesInfo")}}</p> <h2 id="See_also" name="See_also">関連情報</h2> <ul> <li>{{domxref("MediaConfiguration")}}</li> <li>{{domxref("MediaCapabilities.encodingInfo()")}}</li> <li>{{domxref("MediaCapabilities.decodingInfo()")}}</li> </ul>