web/api/media* 以下を md に一括変換

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

@@ -0,0 +1,67 @@
+---
+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
+---
+{{APIRef("Media Capabilities API")}}
+
+[Media Capabilities API](/ja/docs/Web/API/Media_Capabilities_API) の **`MediaCapabilitiesInfo`** インターフェイスは、{{domxref("MediaCapabilities")}} インターフェイスの {{domxref("MediaCapabilities.encodingInfo()")}} メソッドまたは {{domxref("MediaCapabilities.decodingInfo()")}} メソッドによって返される promise が満たされると使用可能になり、メディアタイプがサポートされているかどうかや、そのようなメディアのエンコードまたはデコードがスムーズで電力効率が良いかどうかに関する情報を提供します。
+
+## プロパティ
+
+`MediaCapabilitiesInfo` インターフェイスには、次の 3 つの Boolean 属性が含まれています。
+
+- `supported`: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアコンテンツをエンコード（{{domxref("MediaEncodingConfiguration")}} が設定されている場合）またはデコード（{{domxref("MediaDecodingConfiguration")}} が設定されている場合）できますか？ はいの場合、`supported` は _true_ になり、そうでない場合、_false_ になります。
+- `smooth`: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアの再生は高品質になりますか？ スムーズになりますか？ `supported` が `true` で、再生がスムーズになる場合、`smooth` は _true_ になり、そうでない場合、_false_ になります。
+- `powerEfficient`: {{domxref("MediaConfiguration")}} で定義されたプロパティを指定すると、指定されたメディアの再生は電力効率が良くなりますか？ `supported` が `true` で、再生の電力効率が良い場合、`powerEfficient` は _true_ になり、そうでない場合、_false_ になります。
+
+ブラウザーは、このデバイスの統計情報が記録されるまで、サポートしているメディア構成を `smooth` で `powerEfficient` として報告します。 サポートしているすべての音声コーデックは、電力効率が良いと報告されます。
+
+## 例
+
+```js
+// テストする {{domxref("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 ? 'に優れています' : 'が良くありません') + '。') // 電力効率は良いですか？
+});
+```
+
+## 仕様
+
+| 仕様                                                                                                             | 状態                                     | コメント |
+| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | -------- |
+| {{SpecName('Media Capabilities','#media-capabilities-info','MediaCapabilitiesInfo')}} | {{Spec2('Media Capabilities')}} | 初期定義 |
+
+## ブラウザーの互換性
+
+{{Compat("api.MediaCapabilitiesInfo")}}
+
+## 関連情報
+
+- {{domxref("MediaConfiguration")}}
+- {{domxref("MediaCapabilities.encodingInfo()")}}
+- {{domxref("MediaCapabilities.decodingInfo()")}}

files/ja/web/api/mediadeviceinfo/index.md

@@ -0,0 +1,84 @@
+---
+title: MediaDeviceInfo
+slug: Web/API/MediaDeviceInfo
+tags:
+  - API
+  - WebRTC
+translation_of: Web/API/MediaDeviceInfo
+---
+{{APIRef("WebRTC")}}
+
+**`MediaDevicesInfo`** インタフェースは 1 つメディアが入力か出力のデバイスであるかを示す情報を含みます。{{domxref("MediaDevices.enumerateDevices", "navigator.mediaDevices.enumerateDevices()")}}の呼び出しによって取得できるデバイスの一覧は、`MediaDeviceInfo`オブジェクトの配列であり、1 つの要素が 1 つのメディアデバイスになります。
+
+## プロパティ
+
+- {{domxref("MediaDeviceInfo.deviceId")}}{{readonlyinline}}
+  - : デバイスの識別子の{{domxref("DOMString")}}を返します。この識別子はセッションを越えて保持されます。この識別子は、他のアプリケーションから推測可能でないものであり、呼び出しているアプリケーション元に対して固有のものになります。この識別子は、ユーザがクッキー(プライベートブラウジングでは異なる識別子が使用され、セッションを越えて保持されません)をクリアした時にリセットされます。
+- {{domxref("MediaDeviceInfo.groupId")}}{{readonlyinline}}
+  - : グループ識別子の{{domxref("DOMString")}}を返します。2 つのデバイスが同一のグループ識別子を持つ場合、それらのデバイスは同一の物理デバイスに属していることになります。例として、内蔵カメラとマイクロフォンを持つモニターなど。
+- {{domxref("MediaDeviceInfo.kind")}}{{readonlyinline}}
+  - : `"videoinput"`、`"audioinput"` 、`"audiooutput"`のどれかを返します。
+- {{domxref("MediaDeviceInfo.label")}}{{readonlyinline}}
+  - : デバイスを説明するラベルである{{domxref("DOMString")}}を返します。(例、"External USB Webcam")
+
+> **Note:** セキュリティ的な関係で、アクティブなメディアストリームが存在するか、メディアデバイスへの継続的な権限をユーザが付与しない限り、`label`のフィールドは常に空欄になります。デバイスラベルの組み合わせによって、ユーザを識別するためのフィンガープリントの一部として利用することができてしまいます。
+
+## メソッド
+
+なし。
+
+## 例
+
+ここでは、デバイスの一覧を取得するために、{{domxref("MediaDevices.enumerateDevices", "enumerateDevices()")}}を使用しています。
+
+```js
+if (!navigator.mediaDevices || !navigator.mediaDevices.enumerateDevices) {
+  console.log("enumerateDevices() not supported.");
+  return;
+}
+
+// カメラとマイクを一覧にする。
+
+navigator.mediaDevices.enumerateDevices()
+.then(function(devices) {
+  devices.forEach(function(device) {
+    console.log(device.kind + ": " + device.label +
+                " id = " + device.deviceId);
+  });
+})
+.catch(function(err) {
+  console.log(err.name + ": " + error.message);
+});
+```
+
+コンソールには次のように表示されるでしょう。
+
+```
+videoinput: id = csO9c0YpAf274OuCPUA53CNE0YHlIr2yXCi+SqfBZZ8=
+audioinput: id = RKxXByjnabbADGQNNZqLVLdmXlS0YkETYCIbg+XxnvM=
+audioinput: id = r2/xw1xUPIyZunfV1lGrKOma5wTOvCkWfZ368XCndm0=
+```
+
+もしくは、1 つ以上のメディアストリームが有効の場合や、継続的な許可が与えられている場合は、次のように表示されるでしょう。
+
+```
+videoinput: FaceTime HD Camera (Built-in) id=csO9c0YpAf274OuCPUA53CNE0YHlIr2yXCi+SqfBZZ8=
+audioinput: default (Built-in Microphone) id=RKxXByjnabbADGQNNZqLVLdmXlS0YkETYCIbg+XxnvM=
+audioinput: Built-in Microphone id=r2/xw1xUPIyZunfV1lGrKOma5wTOvCkWfZ368XCndm0=
+```
+
+## 仕様
+
+| 仕様                                                                                                     | 状況                                 | コメント |
+| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------- |
+| {{SpecName('Media Capture', '#idl-def-MediaDeviceInfo', 'MediaDevicesInfo')}} | {{Spec2('Media Capture')}} | 初版     |
+
+## ブラウザーの互換性
+
+{{Compat("api.MediaDeviceInfo")}}
+
+## 関連項目
+
+- [WebRTC API](/ja/docs/Web/API/WebRTC_API)
+- {{domxref("MediaDevices.enumerateDevices", "navigator.mediaDevices.enumerateDevices()")}}
+- {{domxref("MediaDevices.getUserMedia", "navigator.mediaDevices.getUserMedia()")}}