準拠規格 NSObject
宣言された場所 OTSubscriberKit.h

概要

加入者の音声および映像に関する統計情報を監視するために使用されます。詳しくは、 [OTSubscriberKit networkStatsDelegate].

– subscriber:videoNetworkStatsUpdated:

加入者のオーディオ統計情報を報告するために、定期的に送信されます。

- (void)subscriber:(nonnull OTSubscriberKit *)subscriber videoNetworkStatsUpdated:(nonnull OTSubscriberKitVideoNetworkStats *)stats

パラメータ
subscriber この統計の対象となる加入者。
stats アン OTSubscriberKitVideoNetworkStats このオブジェクトには、加入者に対して受信されたビデオバイト数、損失したビデオパケット数、および受信されたビデオパケット数に関するプロパティが含まれています。

登録地

OTSubscriberKit.h

– subscriber:audioNetworkStatsUpdated:

登録者の動画統計情報を報告するために、定期的に送信されます。

- (void)subscriber:(nonnull OTSubscriberKit *)subscriber audioNetworkStatsUpdated:(nonnull OTSubscriberKitAudioNetworkStats *)stats

パラメータ
subscriber この統計の対象となる加入者。
stats アン OTSubscriberKitAudioNetworkStats このオブジェクトには、加入者に対して受信されたオーディオバイト数、失われたオーディオパケット数、および受信されたオーディオパケット数に関するプロパティが含まれています。

登録地

OTSubscriberKit.h

– subscriber:videoQualityChanged:reason:

サブスクライバーに対して品質に関連する動画イベントが発生した際に呼び出されます。

- (void)subscriber:(nonnull OTSubscriberKit *)subscriber videoQualityChanged:(nonnull OTSubscriberKitVideoNetworkStats *)stats reason:(OTSubscriberVideoEventReason)reason

パラメータ
subscriber このイベントをトリガーした動画ストリームを持つ加入者インスタンス。
stats イベント開催時点での最新のチャンネル登録者数に関する統計データ。
reason この質の高いイベントが開催された理由は、以下に基づいており、 OTSubscriberVideoEventReason.

考察

このデリゲートメソッドは、サブスクライバーのビデオストリームに重大な障害が検出された際に 呼び出されます。現在、このメソッドが呼び出されるのは、5秒以上続くビデオの中断 （一時停止）、コーデックの変更、または解像度の変更の場合に限られます。 短時間のフリーズは内部で追跡され、サブスクライバーの統計情報に反映されますが、 その持続時間が短く頻度が高いため、フリーズごとにコールバックがトリガーされることはありません。

について reason このパラメータはイベントの原因を示し、 以下の優先順位に従って考慮されます： OTSubscriberVideoEventVideoInterrupt, OTSubscriberVideoEventCodecChange.

とは異なり、 [OTSubscriberKitDelegate subscriberVideoDisabled:reason:]。 そして [OTSubscriberKitDelegate subscriberVideoEnabled:reason:]。 メッセージ。 これらは、加入者のビデオトラックがオフまたはオンになったことを示すもので（例えば、 オーディオのフォールバックやストリームプロパティの更新など）、このコールバックは画質に関連する 変更を報告します。Applicationsはこのコールバックを利用して、UIを更新したり、テレメトリを記録したり、 ユーザーに映像の中断を通知したりすることができます。

登録地

OTSubscriberKit.h

– subscriber:networkConditionChanged:reason:

加入者またはリモートパブリッシャーのネットワーク状態の変化が検出されるたびに呼び出されます。

- (void)subscriber:(nonnull OTSubscriberKit *)subscriber networkConditionChanged:(nonnull OTSubscriberKitMediaLinkStats *)mediaLinkStats reason:(OTNetworkReason)reason

パラメータ
subscriber ネットワークの状況に変化が生じた加入者。
mediaLinkStats メディアリンクの統計。
reason ネットワークの状態変化の原因コード。

考察

このコールバックは、加入者のビデオトラックの状態の変化ではなく、 ネットワーク全体の健全性の変化を報告します。これは、ネットワークの状態に関する 診断情報を提供する点で、ビデオの有効化／無効化に関するコールバックとは異なります。

メディアおよびネットワークの品質を包括的に把握できるよう、 映像と音声の両方の統計情報が提供されます。音声と映像は基盤となるトランスポートを共有しているため、 ローカル側のトランスポートおよび遠隔参加者の統計情報も共通しています。

について reason このパラメータは、ネットワーク状態の変化の原因を示しており、 現在は次のように報告されています。 OTNetworkReasonNetworkConditionChange.

Applications can use this callback to react to network issues, such as updating UI indicators, logging telemetry, or triggering adaptive behavior.

登録地

OTSubscriberKit.h

– subscriber:mediaLinkStatsUpdated:

加入者のメディアリンク統計情報を報告するために定期的に呼び出されます。 これにより、ローカルの加入者と リモートのパブリッシャーの両方について、トランスポートレベルのメトリクスが提供されます。

- (void)subscriber:(nonnull OTSubscriberKit *)subscriber mediaLinkStatsUpdated:(nonnull OTSubscriberKitMediaLinkStats *)mediaLinkStats

パラメータ
subscriber 加入者インスタンス。
mediaLinkStats メディアリンクの統計。

登録地

OTSubscriberKit.h