音声フォールバックAPIを使用して、ネットワーク品質に応じて音声を動的に優先させる。

Enabling and disabling audio-only fallback

パブリッシャーオーディオのフォールバックを有効にするには パブリッシャー.ビルダー.パブリッシャーオーディオフォールバック プロパティを使用します。

ストリームの全サブスクライバに対して)サブスクライバ音声フォールバックを有効/無効にするには パブリッシャー.ビルダー.サブスクライバーオーディオフォールバック プロパティを使用します。サブスクライバ・オーディオのフォールバックは、ルーティングされたセッションでのみサポートされます (セッションで メディア・ルーター).加入者音声フォールバックは、カメラのビデオソースを持つストリームでデフォルトで有効です(ルーティングされたセッションで)。

Audio fallback events

パブリッシャー・オーディオ・フォールバックが有効な場合 出版社 オブジェクトはオーディオのフォールバック関連のイベントをディスパッチします:

  • Publisher.VideoDisableWarning - パブリッシャが、ストリームの品質が低下し、品質がさらに低下すると動画が無効になると判断した場合に送信されます。 Publisher.VideoDisableWarningLifted - ストリームの品質が改善し、動画が無効化されることが直ちに危険でないとパブリッシャが判断した場合に送信されます。

  • Publisher.VideoDisabled - ストリームの品質が低下し、送信ビデオ・トランスポートが無効になったとパブリッシャーが判断した場合に送信されます。注:動画が無効になっても、パブリッシャはパブリッシング・クライアントのUIにパブリッシャの動画(カメラ画像など)を表示します。

  • Publisher.VideoEnabled - パブリッシャーがストリームの品質が向上し、送信ビデオ・トランスポートが再有効化されたと判断した場合に、理由が「quality」に設定されて送信される。

例えば、以下のコードは関連イベントを処理します(独自のユーザーインターフェース通知を提供できるようにします):

加入者の観点からは、以下のイベントはオーディオのフォールバックが発生したことを示す。これらのイベントは サブスクライバーの観点からは、以下のイベントは、オーディオのフォールバッ クが発生したことを示す。言い換えれば パブリッシャーとサブスクライバーのオーディオのフォールバックの違いは、パブリッシャー の場合、パブリッシングクライアントが、それ自身のストリームに基づいてオーディオ のフォールバックをトリガーする可能性がある、ということである。 そのため、追加のパブリッシャー側イベントがディスパッチされる。サブスクライバー・オーディオ フォールバックの場合、Vonage Video Media Router は加入者に影響するネットワークの劣化を評価します。どちらの場合も、パブリッシャーまたは サブスクライバーオーディオのフォールバックが発生すると、サブスクライバーイベントが常にディスパッチされ、レシーバーでオーディオのフォールバックが発生したことを示します。

加入者音声フォールバックが有効になっている場合 購読者 オブジェクトはオーディオのフォールバック関連のイベントをディスパッチします:

  • Subscriber.VideoDisableWarning - ストリームの品質が劣化したと判断されたときに送信され、品質がさらに劣化した場合は動画が無効化される。 サブスクライバ.VideoDisableWarningLifted - ストリームの品質が、無効化されているビデオが直ちに危険でない時点まで改善されたと判断された場合に送信される。
  • Subscriber.VideoDisabled - ストリームの品質が低下し、送信ビデオトランスポートが無効になったと判断された場合に送信されます。注:ビデオが無効になっても、サブスクライバはパブリッシングクライアントのUIにサブスクライバのビデオ(カメラ画像など)を表示します。
  • Subscriber.VideoEnabled - ストリームの品質が向上し、送信ビデオトランスポートが再有効化されたと判断された場合に、理由を "quality "に設定して送信される。

例えば、以下のコードは関連イベントを処理します(独自のユーザーインターフェース通知を提供できるようにします):