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

概要

パブリッシャーのオーディオおよびビデオの統計情報を監視するために使用されます。詳細については、以下を参照してください。 [OTPublisherKit networkStatsDelegate].

– publisher:videoNetworkStatsUpdated:

パブリッシャーの動画統計情報を報告するために、定期的に送信されます。

- (void)publisher:(nonnull OTPublisherKit *)publisher videoNetworkStatsUpdated:(nonnull NSArray<OTPublisherKitVideoNetworkStats*> *)stats

パラメータ
publisher この統計が対象とする出版社。
stats の配列。 OTPublisherKitVideoNetworkStats オブジェクト。ルーティングされたセッション（ OpenTok メディアルーター)、この配列には1つのオブジェクトが含まれており、OpenTok Media Routerに送信される単一のビデオメディアストリームの統計情報が定義されています。中継セッションでは、この配列には、公開されたストリームの各加入者に対応するオブジェクトが含まれます。 この OTPublisherKitVideoNetworkStats このオブジェクトにはプロパティが含まれています。これらは、受信したビデオバイト数、パブリッシャー側の損失したビデオパケット数、および送信したビデオパケット数に関するプロパティです。

登録地

OTPublisherKit.h

– publisher:audioNetworkStatsUpdated:

パブリッシャーのオーディオ統計情報を報告するために、定期的に送信されます。

- (void)publisher:(nonnull OTPublisherKit *)publisher audioNetworkStatsUpdated:(nonnull NSArray<OTPublisherKitAudioNetworkStats*> *)stats

パラメータ
publisher この統計が対象とする出版社。
stats の配列。 OTPublisherKitAudioNetworkStats オブジェクト。ルーティングされたセッション（ OpenTok メディアルーター)、この配列には1つのオブジェクトが含まれており、OpenTok Media Routerに送信される単一のオーディオメディアストリームの統計情報を定義しています。中継セッションでは、この配列には、公開されたストリームの各加入者に対応するオブジェクトが含まれます。 この OTPublisherKitAudioNetworkStats このオブジェクトにはプロパティが含まれています。これらは、受信したオーディオバイト、失われたオーディオパケット、およびパブリッシャーが送信したオーディオパケットに関するプロパティです。

登録地

OTPublisherKit.h

– publisher:videoQualityChanged:reason:

パブリッシャーの動画ストリームの品質状態に変化があった際に呼び出されます。

- (void)publisher:(nonnull OTPublisherKit *)publisher videoQualityChanged:(nonnull OTPublisherKitVideoNetworkStats *)stats reason:(OTPublisherVideoEventReason)reason

パラメータ
publisher 動画ストリームの画質が変更された配信者。
stats 解像度やビデオレイヤーの変更に関する詳細など、ビデオの統計情報を更新しました。
reason 品質変更の理由コードは、以下の OTVideoReason を列挙する。

考察

このメソッドは、動画品質の変化に関する診断情報を提供します。これには、 更新された統計情報や、イベントが発生した原因などが含まれます。

について reason このパラメータはイベントの原因を示しており、以下の 優先順位で考慮されます：帯域幅の低下、CPU負荷の増加、その他の品質低下の原因、 コーデックの変更、および解像度やビデオレイヤーの変更。

とは異なり、 publisher:videoEnabled: そして publisher:videoDisabled: デリゲートメソッド、 これらはビデオトラックがオンまたはオフになったことを示すもので（例えば、 ストリームのプロパティ更新やオーディオのフォールバックなどによる場合）、このコールバックは 品質に関連する 動画が有効なままでも、品質は変化することがあります。Applicationsはこのデリゲートを使用して、 品質の変化を監視し、それに応じて対応することができます。例えば、UI 要素を調整したり、 アラートを表示したりすることが可能です。

登録地

OTPublisherKit.h

– publisher:networkConditionChanged:reason:

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

- (void)publisher:(nonnull OTPublisherKit *)publisher networkConditionChanged:(nonnull OTPublisherKitMediaLinkStats *)mediaLinkStats reason:(OTNetworkReason)reason

パラメータ
publisher ネットワークの状態が変化したパブリッシャー。
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.

登録地

OTPublisherKit.h

– publisher:mediaLinkStatsUpdated:

パブリッシャーのメディアリンク統計情報を報告するために、定期的に呼び出されます。 トランスポートレベルのメトリクスを提供します。

- (void)publisher:(nonnull OTPublisherKit *)publisher mediaLinkStatsUpdated:(nonnull NSArray<OTPublisherKitMediaLinkStats*> *)mediaLinkStats

パラメータ
publisher パブリッシャー・インスタンス。
mediaLinkStats メディアリンクの統計。

登録地

OTPublisherKit.h