WebRTC(Devices）

前回に引き続き今回は”Query media devices”です。サンプルは２つ。

(1) Choose camera, microphone and speaker

このHTMLを実行するとPCの、”Audio input”、”Audio output”、”Video source”を見つけてプルダウンリストに登録し映像の再生を行います。別になっているjava script fileをサンプルのHTMLに取り込んで見ました。

sample01.html 
<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>Select audio and video sources</title>

        <style>
            div.select {
                display: inline-block;
                margin: 0 0 1em 0;
            }

            p.small {
                font-size: 0.7em;
            }

            label {
                width: 12em;
                display: inline-block;
            }

            video {
              background: #222;
              margin: 0 0 20px 0;
              max-width: 60em;
              --width: 100%;
              width: var(--width);
              height: calc(var(--width) * 0.75);
            }
        </style>

    </head>

    <body>
        <div id="container">
            <h1>WebRTC samples Select sources &amp; outputs</h1>
            <div class="select">
                <label for="audioSource">Audio input source: </label><select id="audioSource"></select>
            </div>

            <div class="select">
                <label for="audioOutput">Audio output destination: </label><select id="audioOutput"></select>
            </div>

            <div class="select">
                <label for="videoSource">Video source: </label><select id="videoSource"></select>
            </div>
            <video id="video" playsinline autoplay></video>
        </div>

        <script>
            'use strict';

            const videoElement = document.querySelector('video');
            const audioInputSelect = document.querySelector('select#audioSource');
            const audioOutputSelect = document.querySelector('select#audioOutput');
            const videoSelect = document.querySelector('select#videoSource');
            const selectors = [audioInputSelect, audioOutputSelect, videoSelect];

            audioOutputSelect.disabled = !('sinkId' in HTMLMediaElement.prototype);

            function gotDevices(deviceInfos)
            {
                // Handles being called several times to update labels. Preserve values.
                const values = selectors.map(select => select.value);
                selectors.forEach(select =>
                {
                    while (select.firstChild) select.removeChild(select.firstChild);
                });

                for (let i = 0; i !== deviceInfos.length; ++i)
                {
                    const deviceInfo = deviceInfos[i];
                    const option = document.createElement('option');
                    option.value = deviceInfo.deviceId;
                    if (deviceInfo.kind === 'audioinput')
                    {
                        option.text = deviceInfo.label || `microphone ${audioInputSelect.length + 1}`;
                        audioInputSelect.appendChild(option);
                    }
                    else if (deviceInfo.kind === 'audiooutput')
                    {
                        option.text = deviceInfo.label || `speaker ${audioOutputSelect.length + 1}`;
                        audioOutputSelect.appendChild(option);
                    }
                    else if (deviceInfo.kind === 'videoinput')
                    {
                        option.text = deviceInfo.label || `camera ${videoSelect.length + 1}`;
                        videoSelect.appendChild(option);
                    }
                    else console.log('Some other kind of source/device: ', deviceInfo);
                }

                selectors.forEach((select, selectorIndex) =>
                {
                    if (Array.prototype.slice.call(select.childNodes).some(n => n.value === values[selectorIndex]))
                        select.value = values[selectorIndex];
                });
            }

            navigator.mediaDevices.enumerateDevices().then(gotDevices).catch(handleError);

            // Attach audio output device to video element using device/sink ID.
            function attachSinkId(element, sinkId)
            {
                if (typeof element.sinkId !== 'undefined')
                {
                    element.setSinkId(sinkId)
                        .then(() =>
                        {
                            console.log(`Success, audio output device attached: ${sinkId}`);
                        })
                        .catch(error =>
                        {
                            let errorMessage = error;
                            if (error.name === 'SecurityError')
                                errorMessage = `You need to use HTTPS for selecting audio output device: ${error}`;
                            console.error(errorMessage);
                            // Jump back to first output device in the list as it's the default.
                            audioOutputSelect.selectedIndex = 0;
                        });
                }
                else console.warn('Browser does not support output device selection.');
            }

            function changeAudioDestination()
            {
                const audioDestination = audioOutputSelect.value;
                attachSinkId(videoElement, audioDestination);
            }

            function gotStream(stream)
            {
                window.stream = stream; // make stream available to console
                videoElement.srcObject = stream;
                // Refresh button list in case labels have become available
                return navigator.mediaDevices.enumerateDevices();
            }

            function handleError(error)
            {
                console.log('navigator.MediaDevices.getUserMedia error: ', error.message, error.name);
            }

            function start()
            {
                if (window.stream)
                {
                    window.stream.getTracks().forEach(track =>
                    {
                        track.stop();
                    });
                }

                const audioSource = audioInputSelect.value;
                const videoSource = videoSelect.value;
                const constraints =
                {
                    audio: {deviceId: audioSource ? {exact: audioSource} : undefined},
                    video: {deviceId: videoSource ? {exact: videoSource} : undefined}
                };

                navigator.mediaDevices.getUserMedia(constraints).then(gotStream).then(gotDevices).catch(handleError);
            }

            audioInputSelect.onchange = start;
            audioOutputSelect.onchange = changeAudioDestination;

            videoSelect.onchange = start;

            start();

        </script>
    </body>
</html>
HTML

このコードでキーになるのは、１０１行の　navigator.mediaDevices.enumerateDevices()関数です。この関数は使用可能なオーディオ入力デバイス（マイク）、 ビデオ入力デバイス（カメラ）、 オーディオ出力デバイス（スピーカー）を検出する関数です。

  • １０１行：　navigator.mediaDevices.enumerateDevices()
    • まずはこの関数が実行されます
    • デバイスが検出出来れば　”gotDevices”。出来なければ　”handleError”　を実行
  • ６２行：　gotDevices(deviceInfos)
    • 検出されたデバイスをここでHTMLに登録します。”deviceInfos”がデバイスの情報アレイです。
      • ７１−９２行：　”deviceInfos”の情報を”audioSource”、”audioOutput”、”videoSource”　
      • 　　　　　　　　各プルダウンリストに登録。
      • ９４−９８行：　リストの一番最初の項目を選択。
  • １７１行：　start();
    • デバイス検出後、ここが実行されます。
    • １６３行：　プルダウンリストを元に引数を決定して、navigator.mediaDevices.getUserMedia()を実行
      • 正常終了すれば、”gotStream”。”gotStream”が正常終了すれば、”gotDevices”を実行。
      • エラーがでると、”handleError”を実行
  • 後はこれの繰り返し。

(2) Choose media source and audio output

注記に、”This demo must be run from localhost or over HTTPS Chrome 49 or later, Firefox is not supported yet.”と有りました。今回はブラウザがFirefoxなのでスキップします。

<<Before

<Top>

<Home>

Next>>