files/ja/web/api/mediacapabilities/encodinginfo/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

---
title: MediaCapabilitiesInfo
slug: Web/API/MediaCapabilities/encodingInfo
tags:
  - API
  - Audio
  - Experimental
  - Interface
  - Media Capabilities API
  - MediaCapabilitiesInfo
  - Reference
  - Video
translation_of: Web/API/MediaCapabilitiesInfo
original_slug: 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 =&gt; { // 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>