From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/mediadeviceinfo/index.html | 158 ++++++++++++++++++++++++++++ 1 file changed, 158 insertions(+) create mode 100644 files/ja/web/api/mediadeviceinfo/index.html (limited to 'files/ja/web/api/mediadeviceinfo') diff --git a/files/ja/web/api/mediadeviceinfo/index.html b/files/ja/web/api/mediadeviceinfo/index.html new file mode 100644 index 0000000000..c2faad1873 --- /dev/null +++ b/files/ja/web/api/mediadeviceinfo/index.html @@ -0,0 +1,158 @@ +--- +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")
+
+ +
+

セキュリティ的な関係で、アクティブなメディアストリームが存在するか、メディアデバイスへの継続的な権限をユーザが付与しない限り、labelのフィールドは常に空欄になります。デバイスラベルの組み合わせによって、ユーザを識別するためのフィンガープリントの一部として利用することができてしまいます。

+
+ +

メソッド

+ +

なし。

+ +

例

+ +

ここでは、デバイスの一覧を取得するために、{{domxref("MediaDevices.enumerateDevices", "enumerateDevices()")}}を使用しています。

+ +
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')}}初版
+ +

ブラウザ互換性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(55.0)}}[1]{{CompatVersionUnknown}}39{{CompatNo}}{{CompatUnknown}}[2]{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)Firefox OS (Gecko)IE PhoneOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatUnknown}}{{CompatVersionUnknown}}392.5{{CompatNo}}{{CompatUnknown}}[2]{{CompatNo}}{{CompatUnknown}}
+
+ +

[1] 早期のバージョンでは、adapter.js ポリフィルを通してこのインタフェースは使用できます。

+ +

[2] Operaでは、adapter.js ポリフィルを通してこのインタフェースを使用できます。

+ +

関連項目

+ + -- cgit v1.2.3-54-g00ecf