パブリッシャーは、指定したソースからオーディオ・ビデオストリームを取得します。 続きを読む...
IDisposable インターフェースを継承しています。
| パブリック型 | |
| enum | VideoReason : int { なし = 0 , 動画を公開する = 1 , 品質 = 3 , 品質劣化帯域幅 = 5 , 品質低下CPU = 6 , 品質低下 その他 = 7 , CodecChange = 8 , 解像度の変更 = 9 } |
| の値を定義します。 VideoEventArgs.Reason そして VideoEventArgs.Reason プロパティ。 続きを読む... |
| パブリックメンバー関数 | |
| void | GetRtcStatsReport () |
| パブリッシャーのRTC統計レポートを取得します。これは非同期操作です。統計情報が利用可能になると、 RtcStatsReport メッセージが送信されます。 続きを読む... | |
| void | 廃棄する () |
| 以下の事項を処理する 出版社 オブジェクトのリソース。 続きを読む... |
| 保護されたメンバ関数 | |
| 出版社 (ビルダー (ビルダー) | |
| 仮想 void | 廃棄する (bool disposing) |
| プロパティ | |
| List< VideoTransformer > | VideoTransformers [get, set] |
| 一覧 VideoTransformer ストリームに適用される順序。詳細については、以下のドキュメントを参照してください。 Vonage Media Processorライブラリの使用 およびメディア変換の適用。getter メソッドはリストのコピーを返します。このコピーに対してトランスフォーマーを追加または削除しても、内部のレイヤーには影響しません。 | |
| List< AudioTransformer > | AudioTransformers [get, set] |
| 一覧 AudioTransformer ストリームに適用される順序。詳細については、以下のドキュメントを参照してください。 Vonage Media Processorライブラリの使用 およびメディア変換の適用。getter メソッドはリストのコピーを返します。このコピーに対してトランスフォーマーを追加または削除しても、内部のレイヤーには影響しません。 | |
| IVideoRenderer | VideoRenderer [get] |
| パブリッシャー向けのビデオレンダラー。 | |
| IVideoCapturer | VideoCapturer [get] |
| パブリッシャー向けの動画キャプチャツール。 | |
| ストリーム | ストリーム [get] |
| このパブリッシャーのストリーム。のプロパティは、 ストリーム object は、このプロパティにアクセスした時点でのストリームの状態のスナップショットであり、ストリームの状態が変化しても更新されることはありません。 | |
| bool | キャプションを公開 [get, set] |
| 出版社がキャプションを掲載しているかどうか。 | |
| bool | PublishAudio [get, set] |
| その出版社がオーディオを出版しているかどうか。 | |
| bool | 動画を公開する [get, set] |
| VideoSourceType | VideoSourceType [get, set] |
| ストリームの種類(カメラまたは画面共有)は、 OpenTok.VideoSourceType を列挙する。 | |
| イント | 最大動画ビットレート [get, set] |
| パブリッシャーの動画ストリームの最大動画ビットレート(ビット/秒)。 続きを読む... | |
| 動画ビットレートプリセット | 動画ビットレートプリセット [get, set] |
| パブリッシャーの動画ストリームに適用される、動画ビットレートのプリセット戦略。 続きを読む... | |
| 劣化優先度 | 劣化優先度 [get, set] |
| 帯域幅やCPUの制約に応じてフレームレートや解像度を調整する際、ビデオエンジンが優先して採用するポリシーです。設定可能な値の詳細については、DegradationPreference列挙型を参照してください。 | |
| ストリング | TargetScalabilityMode [get, set] |
| このパブリッシャーのターゲットスケーラビリティモード(SVC - Scalable Video Coding)。スケーラビリティモードは、WebRTC がエンコードする空間(解像度)および時間(フレームレート)レイヤーの数を制御します。このモードは、メディアルーターのメディアパスに適用されます。 続きを読む... |
| イベント | |
| EventHandler | 強制ミュート |
| の引数を定義します。 強制ミュート イベントを開催する。 | |
| EventHandler< StreamEventArgs > | ストリームの作成日 |
| パブリッシャーのストリームが作成されたときに送信されます。 | |
| EventHandler< StreamEventArgs > | ストリームが破壊されました |
| パブリッシャーのストリームが破棄されたときに送信されます。 | |
| EventHandler< ErrorEventArgs > | エラー |
| パブリッシャーの処理に失敗した際に送信されます。 | |
| EventHandler< VideoQualityChangedEventArgs > | VideoQualityChanged |
| パブリッシャーの動画ストリームの品質状態に変化が生じたときに発生します。 続きを読む... | |
| EventHandler< NetworkConditionChangedEventArgs > | ネットワーク状態の変更 |
| パブリッシャー側でネットワーク状態の変化が検出された場合に発生します。 続きを読む... | |
| EventHandler< PublisherMediaLinkStatsEventArgs > | MediaLinkStatsの更新 |
| パブリッシャーのメディアリンク統計を報告するために、定期的に実行されます。 | |
| EventHandler< AudioLevelArgs > | AudioLevel |
| パブリッシャーのオーディオレベルを報告するために定期的に送信されます。 | |
| EventHandler< AudioNetworkStatsEventArgs > | AudioStatsが更新されました |
| パブリッシャーが共有できるオーディオ統計情報がある場合に呼び出されます。 | |
| EventHandler< VideoNetworkStatsEventArgs > | VideoStatsが更新されました |
| パブリッシャーが共有できる動画の統計情報がある場合に呼び出されます。 | |
| EventHandler< RtcStatsReportArgs > | RtcStatsReport |
| 「~への呼びかけ」への回答として送信されました GetRtcStatsReport(). | |
| EventHandler< VideoEventArgs > | 動画が無効になっています |
| パブリッシャーが動画の送信を停止したときに呼び出されます。 続きを読む... | |
| EventHandler< VideoEventArgs > | 動画対応 |
| (動画が無効化された後)パブリッシャーの動画ストリームが再開されたときに呼び出されます。 続きを読む... | |
| EventHandler | VideoDisableWarning |
| パブリッシャーがネットワークの輻輳レベルが悪化したと判断した場合に呼び出され、輻輳がさらに悪化した場合には動画の再生が停止されます。 続きを読む... | |
| EventHandler | VideoDisableWarningLifted |
| パブリッシャーが、ネットワークの輻輳レベルが改善し、無効化されている動画が直ちにリスクをもたらさない状態になったと判断した際に呼び出されます。 続きを読む... |
詳細な説明
パブリッシャーは、指定したソースからオーディオ・ビデオストリームを取得します。
を使用する。 パブリッシャー.ビルダー クラスを作成して、 出版社 インスタンス。その後、 Session.Publish(Publisher) メソッドを使用する。
について 出版社 このクラスは System.IDisposable インターフェースを実装しています。必ず Dispose() のメソッドを使用する。 出版社 そのオブジェクトが不要になったとき(たとえば、 出版社 (アプリやウィンドウが閉じられるときなど)。
メンバー列挙に関するドキュメント
VideoReason
| enum OpenTok.Publisher.VideoReason : int |
の値を定義します。 VideoEventArgs.Reason そして VideoEventArgs.Reason の特性を持つ。
| 調査員 | |
|---|---|
| なし | 特筆すべき動画の異常や画質の低下は見られない。原因不明、または既知の原因によるもの。 |
| 動画を公開する | この事象は、ストリームの配信者が動画の配信を開始または停止したために発生しました。 |
| 品質 | この現象は、ネットワークの輻輳レベルの変動によって引き起こされました。ネットワークの状態により動画ストリームの画質が低下すると、 出版社 を送信する。 動画が無効になっています イベント。状況が改善すると、動画ストリームが再開され、その 出版社 を送信する。 動画対応 イベント。 ビデオストリームが切断されると、 出版社 オーディオストリームがある場合は、引き続き送信されます。さらに、このパブリッシャーに対応するキャプチャ機能は無効化されず、キャプチャされたフレームは引き続きパブリッシャー側で表示されます。 |
| 品質劣化帯域幅 | ネットワーク帯域幅の不足による品質の低下。 |
| 品質低下CPU | クライアント端末のCPUの性能制限に起因する品質の低下。 |
| 品質低下 その他 | 帯域幅やCPUの制約に分類されない、その他の理由による品質の低下。 |
| CodecChange | ストリームのビデオコーデックが変更されました。 |
| 解像度の変更 | 動画の解像度やレイヤー数の変更。これは、ビットレートの制約、エンコーダの適応、カメラソースの変更(カメラの切り替えや入力解像度の変更など)、あるいは設定の変更によって発生することがあります。必ずしも画質の低下を意味するわけではありません。 |
メンバー関数のドキュメント
Dispose()
| void OpenTok.Publisher.Dispose | ( | ) |
以下の事項を処理する 出版社 オブジェクトのリソース。
に注意してほしい。 出版社のリソースは 違う を呼び出すと、 Session.Publish(Publisher) メソッド。呼び出すと Session.Publish(Publisher)、そのリソースは 出版社 オブジェクトは保持されるため、それを再利用して(セッションに再度公開するために)使用することができます。
GetRtcStatsReport()
| void OpenTok.Publisher.GetRtcStatsReport | ( | ) |
パブリッシャーのRTC統計レポートを取得します。これは非同期操作です。統計情報が利用可能になると、 RtcStatsReport メッセージが送信される。
こちらも参照 AudioStatsが更新されました, VideoStatsが更新されましたそして Subscriber.GetRtcStatsReport().
物件に関する資料
最大動画ビットレート
| --- | int OpenTok.Publisher.MaxVideoBitrate |
パブリッシャーの動画ストリームの最大動画ビットレート(ビット/秒)。
このプロパティは、パブリッシャーの動画ビットレートに明示的な上限を設定します。このプロパティを 0 に設定すると、手動で設定された上限がすべて解除され、明示的な制限のない、プリセットに基づくデフォルトの適応型ビットレート動作に戻ります。
このプロパティを読み取ると、現在設定されている最大ビットレートが bps 単位で返されます。手動でビットレートが設定されていない場合、またはビットレートのプリセットが有効になっている場合は、値は 0 になります。
値が 0 の場合は、明示的なビットレート制限が適用されず、ストリームは品質を最適化するために適応型プリセットのルールに基づいて動作することを示します。
動画を公開する
| --- | bool OpenTok.Publisher.PublishVideo |
TargetScalabilityMode
| --- | 文字列 OpenTok.Publisher.TargetScalabilityMode |
このパブリッシャーのターゲットスケーラビリティモード(SVC - スケーラブル・ビデオ・コーディング)。スケーラビリティモードは、WebRTC がエンコードする空間(解像度)および時間(フレームレート)レイヤーの数を制御します。このモードは、Media Router のメディアパスに適用されます。
セッターはいつでも呼び出すことができます。メディアパスのネゴシエーションが完了している必要はありません。このモードは、メディアルーターのメディアパスが確立されると適用されます。
メディアルーターのメディアパス上でSVC以外のコーデック(VP8、H.264)がネゴシエーションされた場合、最も近い適用可能なモードが使用されます。具体的には、空間レイヤーが強制的に1に設定され、時間次元は維持されます(例:VP8がネゴシエーションされた場合、L2T2 → L1T2)。
セッターがトスをする OpenTokException 要求されたモードが有効なスケーラビリティモードではない場合(つまり、L1T1、L1T2、L1T3、L2T1、L2T2、L2T3、L3T1、L3T2、L3T3のいずれでもない場合)。
ゲッターは、セッターに渡された最新の値を返します。明示的に設定されていない場合はnullを返します。これはユーザーの意図を反映したものであり、実際に適用されたモード(コーデックに依存するフォールバックによって異なる場合があります)を示すものではありません。
これはベータ版の機能です。
動画ビットレートプリセット
| --- | 動画ビットレートプリセット OpenTok.Publisher.VideoBitratePreset |
パブリッシャーの動画ストリームに適用される、動画ビットレートのプリセット戦略。
このプロパティは、動画の画質と帯域幅の使用量のバランスをとるために、あらかじめ定義されたビットレート戦略を設定します。プリセット設定と手動でのビットレート設定は、互いに排他的です。MaxVideoBitrate プロパティを設定すると、プリセット設定が上書きされ、このプロパティは自動的に VideoBitratePreset.Custom.
このプロパティを読み取ると、現在有効なプリセットが返されます。カスタムビットレートが手動で設定されている場合、その値は VideoBitratePreset.Custom.
デフォルト値は VideoBitratePreset.Default.
注 VideoBitratePreset.Custom この値は直接設定することはできません。
詳しくは パブリッシャー最大ビットレート.
イベントの記録
ネットワーク状態の変更
| EventHandler<NetworkConditionChangedEventArgs> OpenTok.Publisher.NetworkConditionChanged |
パブリッシャー側でネットワーク状況の変化が検出された場合に発生します。
このイベントは、ネットワークの状態に著しい変化が生じた際にトリガーされ、メディアリンクの統計情報と変化の理由を提供します。
動画が無効になっています
| EventHandler<VideoEventArgs> OpenTok.Publisher.VideoDisabled |
パブリッシャーが動画の送信を停止したときに呼び出されます。
チェック reason 動画が停止した理由に関するイベント引数のプロパティ。
VideoDisableWarning
| EventHandler OpenTok.Publisher.VideoDisableWarning |
パブリッシャーがネットワークの輻輳レベルが悪化したと判断した場合に呼び出され、輻輳がさらに悪化した場合には動画の再生が停止されます。
ネットワークの状態がさらに悪化した場合、 出版社 動画を無効にし、AudioFallbackメッセージを送信します。ストリームの品質が改善された場合、 出版社 VideoDisableWarningLifted イベントを送信します。
このメソッドは、主に接続品質が低下した際に呼び出されます。
VideoDisableWarningLifted
| EventHandler OpenTok.Publisher.VideoDisableWarningLifted |
パブリッシャーが、ネットワークの輻輳レベルが改善し、無効化される動画が直ちにリスクをもたらさない状態になったと判断した際に呼び出されます。
このメソッドは、主に接続品質が改善されたときに呼び出されます。
動画対応
| EventHandler<VideoEventArgs> OpenTok.Publisher.VideoEnabled |
(動画が無効化された後)パブリッシャーの動画ストリームが再開されたときに呼び出されます。
チェック reason 動画が有効化された理由に関するイベント引数のプロパティ。
VideoQualityChanged
| EventHandler<VideoQualityChangedEventArgs> OpenTok.Publisher.VideoQualityChanged |
パブリッシャーの動画ストリームの品質状態に変化が生じたときに発生します。
このイベントでは、最新の動画統計情報と、画質の変化が生じた理由を示す理由コードが提供されます。
について VideoReason この値はイベントの原因を指定するもので、優先順位は「帯域幅の低下」、「CPU負荷の増加」、「その他の品質低下の原因」、「コーデックの変更」、「解像度またはレイヤーの変更」の順となります。
このイベントは、 動画が無効になっています そして 動画対応 このイベントは、単純なオン/オフの状態変化ではなく、品質に関連する変化を報告するという点で、他のイベントとは異なります。この 動画が無効になっています そして 動画対応 イベントは、パブリッシャーのビデオトラックがオフまたはオンになったタイミング(たとえば、オーディオのフォールバックやストリームプロパティの更新など)を示します。これに対し、 VideoQualityChanged CPUや帯域幅の制限など、品質低下の原因に関する診断情報を提供し、動画が有効なままであっても発生する可能性があります。
Applications can use this event to monitor video quality and respond accordingly, such as updating UI indicators or notifying users of performance issues.