ストリームを指定します。ストリームとは、セッション内で公開されたストリームを表すものです。 クライアントが Session.publish() メソッド, 新しいストリームが 作成されます。Stream オブジェクトのプロパティには、そのストリームに関する情報が含まれています。

セッションにストリームが追加されると、Session オブジェクトは streamCreatedEvent. ストリームが破棄されると、Session オブジェクトは streamDestroyed イベント。これらのイベントオブジェクトを定義するStreamEventオブジェクトには、 以下の stream Stream オブジェクトの配列である property。詳細およびコード 例については、以下を参照してください。 ストリームイベント.

セッションへの接続が確立されると、Session オブジェクトは sessionConnected SessionConnectEvent オブジェクトによって定義されるイベント。この SessionConnectEvent オブジェクトには、 streams このプロパティは、その時点でのセッション内のストリームに関連する Stream オブジェクトの配列です。詳細およびコード例については、 以下を参照してください。 SessionConnectEvent.

プロパティ

名称 タイプ 説明
connection 接続 ストリームを配信している接続に対応するConnectionオブジェクトです。これは、 connection Session オブジェクトのプロパティを使用して、そのストリームがローカルの Web ページによって配信されているかどうかを確認します。
creationTime Numbers ストリームの作成日時。この値はミリ秒単位で計算されます。この値を Date オブジェクトに変換するには、 new Date(creationTime)ここで creationTimecreationTime プロパティを持つ。
frameRate Numbers パブリッシャーのキャプチャ対象フレームレート。当初は frameRate 引数として渡されたプロパティ OT.initPublisher(). このプロパティは、パブリッシャーがフレームレートを明示的に指定した場合にのみ設定されます。それ以外の場合は、未定義となります。この値は、パブリッシャーが Publisher.setPreferredFrameRate(). 注: この値は、パブリッシャーの現在の目標キャプチャフレームレートを表すものであり、実際にエンコードされたフレームレートやサブスクライバーが受信するフレームレートを表すものではありません。帯域幅やCPUの制約により、エンコードされたフレームレートはこれよりも低くなる場合があり、また、ネットワーク状況によっては、受信されるフレームレートはさらに変動する可能性があります。サブスクライバーの実際のデコードフレームレートを取得するには、 video.decodedFrameRate によって返されるプロパティ Subscriber.getStats().
hasCaptions ブーリアン ストリームに字幕があるかどうか。このプロパティは、配信者が( Publisher.publishCaptions() メソッド)。これが発生すると、 セッション オブジェクトは streamPropertyChanged イベント(参照: StreamPropertyChangedイベント).
hasAudio ブーリアン ストリームに音声があるかどうか。このプロパティは、パブリッシャーが音声のオン/オフを切り替えた場合( Publisher.publishAudio()).こうなると セッション オブジェクトは streamPropertyChanged イベント(参照: StreamPropertyChangedイベント).
hasVideo ブーリアン ストリームに動画が含まれているかどうか。このプロパティは、パブリッシャーが動画のオン/オフを切り替えた場合( Publisher.publishVideo()).こうなると セッション オブジェクトは streamPropertyChanged イベント(参照: StreamPropertyChangedイベント).
initials ストリング ストリームの頭文字。配信者は、動画が無効化された際に表示される頭文字を指定できます。(詳細は initials プロパティの properties パラメータに渡される。 OT.initPublisher() メソッド)
name ストリング ストリームの名前。パブリッシャーは、ストリームを公開する際に( publish() (パブリッシャーのSessionオブジェクトのメソッド)。
streamId ストリング ストリームの固有ID。
videoDimensions 目的 このオブジェクトには2つのプロパティがあります: width そして height (両方の数値)。これらは、セッションに対して最後に通知されたパブリッシャーのキャプチャ目標解像度を表します。この値はシグナリング層を介してすべての参加者にブロードキャストされ、パブリッシングクライアントとサブスクライビングクライアントの両方で読み取ることができます。この値は、最初に resolution 引数として渡されたプロパティ OT.initPublisher(). これは、パブリッシャーのローカルが <video> 要素は、寸法の変更を検知します(たとえば、 Publisher.setPreferredResolution()(画面共有ウィンドウのサイズ変更や、モバイル端末の向き変更など)。 注: これらの値は、パブリッシャーのキャプチャ対象解像度を表すものであり、実際にエンコードされた解像度やサブスクライバーが受信する解像度ではありません。パブリッシャーは、帯域幅やCPUの制約により、より低い解像度でエンコードする場合があり、スケーラブルビデオを使用しているサブスクライバーは、さらに低い解像度のレイヤーを受信することもあります。サブスクライバー側のクライアントで実際にデコードされた解像度を取得するには、以下を使用してください。 Subscriber.videoWidth() そして Subscriber.videoHeight(). このプロパティが変更されると、 セッション オブジェクトは streamPropertyChanged イベント(参照: StreamPropertyChangedイベント).
videoType ストリング 動画の種類――どちらかといえば "camera", "screen"あるいは "custom".A "screen" この動画は、配信側の画面共有を動画ソースとして使用しています。その他の動画については、このプロパティは "camera".A "custom" この動画では、パブリッシャー側の動画ソースとして VideoTrack 要素が使用されています。(詳細は videoSource プロパティの options パラメータに渡される。 OT.initPublisher() メソッド。)その videoTypeundefined ストリームが音声のみの場合 ( 音声ガイド). モバイルデバイスから配信されているストリームの動画タイプが、カメラから画面共有に変更された場合、このプロパティは変更される可能性があります。動画タイプが変更されると、 セッション オブジェクトは streamPropertyChanged イベント(参照: StreamPropertyChangedイベント).