Vonage Video API セッション内でオーディオ・ビデオストリームを再生するために使用されます。 続きを読む...

IDisposable インターフェースを継承しています。

詳細な説明

Vonage Video API セッション内でオーディオ・ビデオストリームを再生するために使用されます。

を使用する。 Subscriber.Builder クラスを作成して、 購読者 インスタンス。このメソッドを呼び出すと、サブスクライバーはメディアを受信するために接続できます。 Session.Subscribe(Subscriber) メソッドを使用する。

について 購読者 このクラスは System.IDisposable インターフェースを実装しています。必ず Dispose() のメソッドを使用する。 購読者 そのオブジェクトが不要になったとき（たとえば、 購読者 （動画のストリーミングが停止したとき、またはアプリやウィンドウが閉じられるときなど）。

メンバー列挙に関するドキュメント

VideoReason

の値を定義します。 VideoEventArgs.Reason そして VideoEventArgs.Reason の特性を持つ。

メンバー関数のドキュメント

GetRtcStatsReport()

サブスクライバーの RTC 統計レポートを取得します。これは非同期操作です。統計情報が利用可能になると、 RtcStatsReport メッセージが送信される。

こちらも参照 AudioStatsが更新されました, VideoStatsが更新されましたそして Publisher.GetRtcStatsReport().

物件に関する資料

AudioVolume

加入者の音声音量。

加入者の音声音量（0～100）。値を設定する際、この範囲外の場合は、この範囲内にクリップされます。

デフォルト値は 100 です。

キャプション・翻訳・言語

この購読者にとって、キャプションの翻訳に最適な言語です。

これはベータ機能です.

この設定は、字幕が有効になっている場合にのみ有効になります。翻訳された字幕を表示するには、サポートされている BCP-47 言語コードを設定するか、 null 翻訳を無効にするには。デフォルト値は null （翻訳設定がありません）。

サポートされている言語コードは、サーバーAPI仕様書に定義されています。

推奨フレームレート

チャンネル登録者のストリームにおける推奨フレームレート。

フレームレートと動画の解像度を制限する（推奨解決策) これにより、サブスクライバー側のクライアントにおけるネットワーク使用量とCPU使用量が削減されます。アプリ内のサブスクライバーの動画のサイズに応じて、より低い解像度を設定することを検討してください。また、他のストリームに比べて重要度が低く（かつ規模が小さい）ストリームのサブスクライバーに対しては、より低いフレームレートや解像度を設定することを検討してください。

このプロパティは、 スケーラブルビデオ機能. スケーラブルビデオが利用可能です：

• Vonage Video API メディアルーターを使用するセッション（ メディアモード に設定されている)。
• スケーラブルビデオをサポートするクライアントによって配信されるストリームのみ対象です（詳細については、 スケーラブルビデオ機能).

スケーラブルビデオを使用していないストリームでは、このプロパティを設定しても効果はありません。

注： スケーラブルなビデオストリームのフレームレートは、このプロパティを設定していなくても、ネットワークの状態やCPU使用率に基づいて、各加入者ごとに自動的に調整されます。この加入者の最大フレームレートを設定したい場合は、このプロパティを設定してください。

利用可能なフレームレートは、ストリームで利用可能な最大フレームレートの値に基づいています。サブスクライバーの希望フレームレートを設定すると、Vonage Video API Windows SDK は、クライアントの帯域幅および CPU の制約に基づき、希望フレームレートに最も近い利用可能な最適なフレームレートを選択します。

実際に利用可能なフレームレートは、パブリッシャーが利用できるネットワークおよびCPUリソースに応じて動的に変化します。

推奨解決策

加入者のストリームに推奨される解像度。

加入者のストリームに推奨される解像度。

動画の解像度とフレームレートを制限する（推奨フレームレート) これにより、サブスクライバー側のクライアントにおけるネットワーク使用量とCPU使用量が削減されます。アプリ内のサブスクライバーの動画のサイズに応じて、より低い解像度を設定することを検討してください。また、他のストリームに比べて重要度が低く（かつ規模が小さい）ストリームのサブスクライバーに対しては、より低いフレームレートや解像度を設定することを検討してください。

このプロパティは、 スケーラブルビデオ機能. スケーラブルビデオが利用可能です：

• Vonage Video API メディアルーターを使用するセッション（ メディアモード に設定されている)。
• スケーラブルビデオをサポートするクライアントによって配信されるストリームのみ対象です（詳細については、 スケーラブルビデオ機能).

スケーラブルビデオを使用していないストリームでは、このプロパティを設定しても効果はありません。

注： スケーラブルビデオストリームの解像度は、このプロパティを設定していなくても、ネットワークの状態やCPU使用率に基づいて、各加入者ごとに自動的に調整されます。この加入者の最大解像度を設定したい場合は、このプロパティを設定してください。

すべての解像度が加入者に利用可能というわけではありません。希望する解像度を設定すると、Vonage Video API Windows SDK は、設定された制約条件に合致する利用可能な最適な解像度を選択します。利用可能な解像度は、最大幅および最大高さに依存します。 出版社 ストリーム用のセットで、これらは Stream.Width そして Stream.Height の特性である。 ストリーム オブジェクト。ストリームで利用可能な各解像度は、すべて同じアスペクト比を使用します。

VideoRenderer

このチャンネル登録者が使用している動画レンダラー。

ビデオレンダラーを設定するには、 VideoRenderer Subscriber(Context, Stream, IVideoRenderer) コンストラクタを呼び出す際。

イベントの記録

ネットワーク状態の変更

加入者側でネットワーク状況の変化が検出された場合に発生します。

このイベントは、ネットワークの状態に著しい変化が生じた際にトリガーされ、メディアリンクの統計情報と変化の理由を提供します。

ストリームが切断されました

加入者のストリームが中断されたときに呼び出されます。

このメソッドが呼び出された際、オーディオ・ビデオストリームが一時的に切断され、アプリがストリームへの再接続を試みていることをユーザーに知らせるため、ユーザーインターフェース上で通知を表示するとよいでしょう。

クライアントがストリームに再接続した場合、サブスクライバーは ストリームが再接続されました イベント。そうでない場合は、 セッション オブジェクトは Session.StreamDropped イベントを開催する。

ストリームが再接続されました

加入者のストリームが再開されたとき（一時的に切断された後）に送信されます。

について 購読者 は、 ストリームが切断されました イベントを開催する。

動画が無効になっています

加入者が動画の受信を停止したときに呼び出されます。

チェック reason 動画が停止した理由に関するイベント引数のプロパティ。

VideoDisableWarning

Vonage Video API メディアルーターが、ストリームの品質が低下したと判断し、さらに品質が低下した場合に動画が停止されることになる場合に呼び出されます。

画質がさらに低下した場合、加入者は動画を停止し、 購読者 VideoDisabled メッセージを送信します。ストリームの画質が向上した場合、 購読者 VideoDisableWarningLifted イベントを送信します。

この機能は、Vonage Video API メディアルーターを使用するセッション（メディアモードが「ルーティング」に設定されているセッション）でのみ利用可能であり、メディアモードが「中継」に設定されているセッションでは利用できません。（参照： OpenTok メディアルーターとメディアモード).

このメソッドは、主に接続品質が低下した際に呼び出されます。

VideoDisableWarningLifted

Vonage Video API メディアルーターが、ストリームの品質が改善し、無効化される動画が直ちにリスクをもたらさない状態になったと判断した際に呼び出されます。

この機能は、Vonage Video API メディアルーターを使用するセッション（メディアモードが「ルーティング」に設定されているセッション）でのみ利用可能であり、メディアモードが「中継」に設定されているセッションでは利用できません。（参照： OpenTok メディアルーターとメディアモード).

このメソッドは、主に接続品質が改善されたときに呼び出されます。

動画対応

加入者のビデオストリームが開始されたとき（それまでビデオがなかった場合）、または再開されたとき（ビデオが無効化されていた後）に呼び出されます。

チェック reason 動画が有効化された理由に関するイベント引数のプロパティ。

VideoQualityChanged

加入者側で品質に関連する事象が検出された場合に発生します。

このイベントは、サブスクライバーのビデオストリームで、ビデオの中断（一時停止）の検出やコーデックの変更など、品質に著しい変化が生じた際にトリガーされます。

現在の実装では、このイベントは動画の中断やコーデックの変更が発生した場合にのみトリガーされます。 フリーズは内部で追跡され、統計情報にも反映されますが、その持続時間が短く頻度が高いため、個別にこのイベントをトリガーすることはありません。コールバックが発生するのは、一時停止（5秒以上レンダリングフレームがない状態）が検出された場合のみです。これは、より重大な再生の途絶を表すためです。

について VideoReason この値はイベントの原因を指定するもので、以下の優先順位に従います： VideoInterruption, CodecChange.

このイベントは、 動画が無効になっています そして 動画対応 単純なトラックのオン／オフの切り替えではなく、品質に関連する変更を報告するという点で。その 動画が無効になっています そして 動画対応 イベントは、サブスクライバーのビデオトラックがオフまたはオンになったタイミング（たとえば、オーディオのフォールバックやストリームプロパティの更新など）を示します。これに対し、このイベントは、フリーズ、一時停止回数、更新されたビデオ統計情報など、画質低下の原因に関する診断情報を提供します。

このイベントでは、5秒以上続く動画の中断をすべて対象とします。オーディオへのフォールバックや動画が無効化された場合などにおいても、その中断は統計上「一時停止」として記録され、対応する品質変化イベントが発生する場合があります。

Applications can use this event to respond to quality issues, such as updating UI indicators, logging telemetry, or notifying users.