iOS (Swift)

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

注釈について OTPublisherKit.audioFallbackEnabled プロパティは非推奨となります。その場合は OTPublisherKitSettings.publisherAudioFallbackEnabled そして OTPublisherKitSettings.subscriberAudioFallbackEnabled プロパティの代わりに。

Enabling and disabling audio-only fallback

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

// Enable publisher audio fallback
let publisherSettings = OTPublisherSettings()
publisherSettings.publisherAudioFallbackEnabled = YES

// Enable publisher audio fallback and disable subscriber audio fallback
let publisherSettings = OTPublisherSettings()
publisherSettings.publisherAudioFallbackEnabled = YES
publisherSettings.subscriberAudioFallbackEnabled = NO

// Enable subscriber audio fallback and disable publisher audio fallback
let publisherSettings = OTPublisherSettings()
publisherSettings.publisherAudioFallbackEnabled = NO
publisherSettings.subscriberAudioFallbackEnabled = YES

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

Audio fallback events

パブリッシャー・オーディオ・フォールバックが有効な場合パブリッシャーキットデリゲートオブジェクトはパブリッシャーオーディオのフォールバック関連のイベントに関して以下のメッセージを送信します：

[OTPublisherKitDelegate publisherVideoDisableWarning:] - ストリームの品質が低下したとパブリッシャーが判断したときに呼び出され、品質がさらに低下した場合は動画が無効になります。
[OTPublisherKitDelegate publisherVideoDisableWarningLifted:] - パブリッシャーが、ストリームの品質が改善され、無効になっている動画が直ちに危険にさらされることはないと判断した場合に呼び出されます。
[OTPublisherKitDelegate publisherVideoDisabled:reason:] - ストリームの品質が低下し、送信ビデオ・トランスポートが無効になったとパブリッシャが判断した場合に呼び出されます。注: 動画が無効になっても、パブリッシャはパブリッシング・クライアントの UI にパブリッシャの動画（カメラ画像など）を表示します。
[OTPublisherKitDelegate publisherVideoEnabled:reason:] - パブリッシャーがストリームの品質が向上し、送信ビデオ・トランスポートが再有効化されたと判断したときに、理由 "quality" で呼び出される。たとえば、以下のコードは関連イベントを処理します（独自のユーザーインターフェイス通知を提供できるようにします）：

func publisherVideoDisableWarning(_ publisher: OTPublisherKit) {
  // Custom action — for example, add custom UI notification
}

func publisherVideoDisableWarningLifted(_ publisher: OTPublisherKit) {
  // Custom action — for example, remove custom UI notification
}

func publisherVideoDisabled(_ publisher: OTPublisherKit, reason: OTPublisherVideoEventReason) {
  // Custom action — for example, add custom UI notification
}

func publisherVideoEnabled(_ publisher: OTPublisherKit, reason: OTPublisherVideoEventReason) {
  // Custom action — for example, remove custom UI notification
}

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

加入者音声フォールバックが発生するとサブスクライバーキットデリゲートオブジェクトは、サブスクライバーのオーディオフォールバック関連イベントに関する以下のメッセージを送信する：

[OTSubscriberKitDelegate subscriberVideoDisableWarning:] - ストリームの画質が劣化したと判断されたときに呼び出され、画質がさらに劣化した場合は動画が無効化される。 [OTSubscriberKitDelegate subscriberVideoDisableWarningLifted:] - ストリームの品質が、無効化されている動画が直ちに危険でない程度まで改善されたと判断された場合に呼び出される。 [OTSubscriberKitDelegate subscriberVideoDisabled:reason:] - ストリームの品質が低下し、送信ビデオ・トランスポートが無効になったと判断された場合に呼び出されます。注：ビデオが無効になっている間も、サブスクライバはパブリッシング・クライアントの UI にサブスクライバのビデオ（カメラ画像など）を表示します。 [OTSubscriberKitDelegate subscriberVideoEnabled:reason:] - ストリームの品質が向上し、送信ビデオトランスポートが再度有効になったと判断されたとき、理由「quality」で呼び出される。

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

func subscriberVideoDisableWarning(_ subscriber: OTSubscriberKit) {
  // Custom action — for example, add custom UI notification
}

func subscriberVideoDisableWarningLifted(_ subscriber: OTSubscriberKit) {
  // Custom action — for example, remove custom UI notification
}

func subscriberVideoDisabled(_ subscriber: OTSubscriberKit, reason: OTSubscriberVideoEventReason) {
  // Custom action — for example, add custom UI notification
}

func subscriberVideoEnabled(_ subscriber: OTSubscriberKit, reason: OTSubscriberVideoEventReason) {
  // Custom action — for example, remove custom UI notification
}