パブリッシャーまたは加入者の動画要素への直接アクセス

パブリッシャまたはサブスクライバのデフォルトのユーザー・インターフェース要素を無効にし、HTMLにアクセスすることができます。 video 要素を直接指定します。ストリームを公開または購読するときは insertDefaultUI プロパティ false を呼び出すときに OT.initPublisher() または Session.subscribe() メソッドを使用します。このオプションをfalseに設定すると JS SDK はHTML DOMにデフォルトのUI要素を挿入しません。 element プロパティは未定義です。

代わりに、Publisher要素は videoElementCreated イベント video 要素(インターネットエクスプローラでは object 要素)が作成される。その element イベントのプロパティ object は、video(または object)要素への参照です。これを HTML DOM に追加すると、動画が表示されます。

次のコードはパブリッシャーを初期化し、その video 要素をHTML DOMに追加する:

var publisher = OT.initPublisher({insertDefaultUI: false});
publisher.on('videoElementCreated', function(event) {
  document.getElementById('publisher-video-parent-id').appendChild(event.element);
});

以下のコードは、ストリームを購読し、そのストリームに video 要素をHTML DOMに追加する:

var subscriber = session.subscribe(stream, {insertDefaultUI: false});
subscriber.on('videoElementCreated', function(event) {
  document.getElementById('subscriber-video-parent-id').appendChild(event.element);
});

を設定した場合 insertDefaultUI プロパティ falseを設定しないでください。 targetElement パラメータを呼び出す際に OT.initPublisher() または Session.subscribe().(これはエラーになる)。

デフォルトのユーザーインターフェイス要素には、ビデオのほかに、ユーザーインターフェイスコントロール、ビデオのロードインジケータ、ビデオの自動トリミングまたはレターボックスが含まれます。もし insertDefaultUI に設定する。 true (デフォルト)を使用して、個々のユーザーインターフェイス設定を制御することができます。 fitMode, showControlsそして style オプションを使用します。このページの他のトピックを参照してください。