購読する診断

サブスクライバーのオーディオとビデオの統計情報を取得するには、以下のイベントハンドラを追加します。 audioNetworkStats そして videoNetworkStats イベントは、OTSubscriber によってディスパッチされる。これらは、以下を含むサブスクライバのストリームに関する情報を提供する：

• 失われたオーディオおよびビデオパケットの総数。
• 受信したオーディオパケットとビデオパケットの総数。
• 受信したオーディオとビデオの合計バイト数。
• 現在の平均ビデオフレームレート。

より詳細なストリーム統計を取得するには Subscriber.getRtcStatsReport() メソッドを呼び出します。このメソッドはプロミスを返し、成功すると、JSON表現の RtcStatsReport オブジェクトを返します：

Streamオブジェクトには、ストリームを定義する以下のプロパティがあります：

• connection - ストリームを公開している接続に対応する Connection オブジェクト。これを Session オブジェクトの connection プロパティと比較することで、ストリームがローカルの Web ページから発行されているかどうかを確認できます。
• creationTime - ストリーム作成のタイムスタンプ（数値）。この値はミリ秒単位で計算されます。この値を Date オブジェクトに変換するには new Date(stream.creationTime).
• hasAudio - 論理値） ストリームに音声があるかどうか。このプロパティは、パブリッシャーがオーディオをオンまたはオフにした場合に変更できます ( Publisher.publishAudio()).こうなると セッション オブジェクトは streamPropertyChanged イベントを開催する。
• hasVideo - 論理値） ス ト リ ームが動画を持つかど う か。 initials-(Boolean) ストリームのイニシャル。 初期化).
• name - (String) ストリームの名前。これは、デフォルトでは、ユーザーがHTML DOMのサブスクライバーの上にマウスオーバーすると表示されます。ただし、UI をカスタマイズして、名前を非表示にしたり、マウスオーバーせずに表示したりすることができます。
• videoDimensions - このオブジェクトには2つのプロパティがある： width そして height.どちらもNumbersだ。その width プロパティはエンコードされたストリームの幅です。 height プロパティは、エンコードされたストリームの高さです。(これらは、ストリームに対応するPublisherオブジェクトとSubscriberオブジェクトの実際の幅とは無関係です)。このプロパティは、iOSデバイスからパブリッシュされたストリームのサイズが変更された場合、デバイスの向きの変更に基づいて変更される可能性があります。
• videoType - 動画のタイプ: "camera"、"screen"、"custom"、または未定義のいずれか。screen "動画は、パブリッシャーの画面共有を動画ソースとして使用します。"custom "動画は、パブリッシャーの VideoTrack 要素を動画ソースとして使用します。また videoType は undefined ストリームが音声のみの場合 ( 音声ガイド).このプロパティは、モバイル機器から公開されるストリームがカメラから画面共有ビデオタイプに変更された場合に変更される可能性があります。詳細については 画面共有 - Web.

について hasAudio, hasVideo, videoDimensionsそして videoType プロパティが変更されることがあります (例えば、パブリッシャーがビデオの電源を入れたり切ったりした場合など)。このような場合、Session オブジェクトは streamPropertyChanged イベントをディスパッチします ( StreamPropertyChangedイベント).

Streamオブジェクトには、ストリームを定義する値を返す以下のメソッドがあります：

• getConnection()- (Connection) ストリームを公開している接続に対応する Connection オブジェクトを返します。この値を getConnection() メソッドを呼び出して、ストリームがクライアントによって公開されているかどうかを確認します。
• getCreationTime()- Date） ス ト リ ームの作成時刻の タ イ ムス タ ンプ。
• hasAudio()- 論理値） ス ト リ ームが音声を持つかど う か。
• hasVideo()- 論理値） ス ト リ ームが動画を持つかど う か。
• getName()- 文字列） ストリームの名前を返します。これは、ストリームのパブリッシャを初期化するときに設定されます ( パブリッシャー・オブジェクトの初期化).
• getStreamId()- 文字列）ストリームの一意のID。
• getVideoHeight()- int） ス ト リ ームの高 さ を ピ ク セル単位で指定 し ます。
• getVideoType()- StreamVideoType） ス ト リ ームがカ メ ラ ビデオ ソ ース を用いているかど う か。StreamVideoTypeCamera.StreamVideoTypeCamera)、スクリーン共有ビデオソース(StreamVideoTypeScreen.StreamVideoTypeScreen)、またはカスタム・ビデオ・ソース(StreamVideoTypeScreen.StreamVideoTypeScreen).

参照 画面共有.

• getVideoWidth()- int） ス ト リ ームの幅を ピ ク セル単位で指定 し ます。

OTStreamオブジェクトは、ストリームを定義する以下のプロパティを持つ：

• connection-ストリームを公開している接続に対応するOTConnectionオブジェクト。これを connection プロパティを使用して、ストリームがクライアントによって公開されているかどうかを確認します。
• creationTime-ストリームの作成時刻の日付タイムスタンプ。
• hasAudio-(Bool) ストリームに音声があるかどうか。
• hasVideo-(Bool) ストリームがビデオを持っているかどうか。
• name-ストリームの名前。これは、ストリームのパブリッシャを初期化する際に設定されます ( OTPublisherオブジェクトの初期化).
• session-(OTSession) ストリームがバインドされている Vonage Video セッション。
• streamId-文字列） ストリームの一意のID。
• videoDimensions-このストリームのビデオメディアトラックの現在の寸法を定義する CGSize オブジェクト。
• videoType-OTStreamVideoType） ストリームがカメラ映像ソースを使うかどうか (OTStreamVideoTypeCamera)、スクリーン共有ビデオソース(OTStreamVideoTypeScreen)、またはカスタム・ビデオ・ソース(OTStreamVideoTypeCustom).

参照 画面共有.

OTStreamオブジェクトは、ストリームを定義する以下のプロパティを持つ：

• connection-ストリームを公開している接続に対応するOTConnectionオブジェクト。これを connection プロパティを使用して、ストリームがクライアントによって公開されているかどうかを確認します。
• creationTime-ストリームの作成時刻のNSDateタイムスタンプ。
• hasAudio-論理値） ストリームに音声があるかどうか。
• hasVideo-論理値） ストリームに動画があるかどうか。
• name-ストリームの名前。これは、ストリームのパブリッシャを初期化するときに設定されます ( OTPublisherオブジェクトの初期化).
• session-(OTSession) ストリームがバインドされている Vonage Video セッション。
• streamId-(NSString) ストリームの一意のID。
• videoDimensions-このストリームのビデオメディアトラックの現在の寸法を定義する CGSize オブジェクト。
• videoType-OTStreamVideoType） ストリームがカメラ映像ソースを使うかどうか (OTStreamVideoTypeCamera)、スクリーン共有ビデオソース(OTStreamVideoTypeScreen)、またはカスタム・ビデオ・ソース(OTStreamVideoTypeCustom).

参照 画面共有.

Streamオブジェクトには、ストリームを定義する以下のプロパティがあります：

• Connection- Connection）ストリームを公開している接続に対応するConnectionオブジェクト。これを Connection プロパティを使用して、ストリームがクライアントによって公開されているかどうかを確認します。
• CreationTime- DateTime） ス ト リ ームの作成時刻の DateTime タ イ ムス タ ンプ。
• HasAudio- (bool) ストリームに音声があるかどうか。
• HasVideo- (bool) ストリームがビデオを持っているかどうか。
• Name- 文字列）ストリームの名前。これはストリームのパブリッシャを初期化する際に設定されます ( パブリッシャー・オブジェクトの初期化).
• Id- 文字列）ストリームのユニークID。
• Height- int） ス ト リ ームの高 さ を ピ ク セル単位で指定 し ます。
• VideoSourceType- VideoSourceType） ス ト リ ームがカ メ ラ ビデオ ソ ース を用いるかど う か。VideoSourceType.StreamVideoTypeCamera)、スクリーン共有ビデオソース(VideoSourceType.StreamVideoTypeScreen)、またはカスタム・ビデオ・ソース(VideoSourceType.StreamVideoTypeCustom).

参照 画面共有.

• Width- int） ス ト リ ームの幅を ピ ク セル単位で指定 し ます。

ストリームに関する情報を得るには、以下の関数を呼び出す：

• otc_stream_get_connection()- を返します。 otc_connection インスタンスを作成します。このコネクション ID を otc_connection インスタンスを返します。 otc_session_get_connection() 関数を使用して、ストリームがクライアントによって公開されているかどうかを確認します。
• otc_stream_get_creation_time()- ストリームの作成時刻のタイムスタンプを返します。
• otc_stream_has_audio()- ストリームが現在オーディオを公開しているかどうか。
• otc_stream_has_video()- ストリームが現在ビデオを公開しているかどうか。
• otc_stream_has_audio_track()- ストリームにオーディオトラックがあるかどうか。
• otc_stream_has_video_track()- ストリームにビデオトラックがあるかどうか。
• otc_stream_get_name()- ストリームの名前を返します。これは、ストリームのパブリッシャを初期化するときに設定されます ( otc_publisher 構造体の初期化とパブリッシャーコールバックの設定).
• otc_stream_get_id()- ストリームの一意な ID を返します。
• otc_stream_get_video_height()- ストリームの高さをピクセル単位で指定する。
• otc_stream_get_video_type()- ストリームがカメラのビデオソースを使用しているかどうか (OTC_STREAM_VIDEO_TYPE_CAMERA)または画面共有ビデオソース(OTC_STREAM_VIDEO_TYPE_SCREEN).
• otc_stream_get_video_width()- ストリームの幅をピクセル単位で指定する。

サブスクライバーのビデオが無効化されると、OTSubscriberオブジェクトは videoDisabled イベントを開催する：

メディアルータが加入者のビデオを無効にする場合、加入者に関連するユーザーインターフェイスを調整することができます。

について reason プロパティの videoDisabled イベントオブジェクトは、ビデオが無効になった理由を定義します。以下の値のいずれかを設定する：

• "PublisherPropertyChanged" - 出版社はビデオの公開を中止した。

• "QualityChanged" - メディアルーターが、ストリーム品質の変化に基づいて加入者へのビデオ送信を停止した。メディアルータのこの機能は、接続性が低下すると、加入者がビデオストリームを停止する。(加入者は、音声ストリームがある場合は受信を継続する）。

このイベントを送信する前に、加入者のストリームの品質が、ビデオストリームが使用不可 になる危険性があるほど低いレベルまで劣化したとき OTSubscriber オブジェから videoDisableWarning イベントを開催する。

接続性が改善され、再びビデオをサポートするようになった場合 OTSubscriber オブジェクトは videoEnabled イベントが発生し、加入者はビデオの受信を再開する。

を使用するセッションでのみ利用可能です。 メディア・ルーター (メディアモードがルーティングに設定されたセッション)であり、メディアモードがリレーに設定されたセッションではない。

ストリームを公開する際、ストリームの画質が原因でビデオが無効化されるのを防ぐことができます。設定 audioFallbackEnabled への false での properties プロパティを OTPublisher コンポーネントに渡します。

• "SubscriberPropertyChanged" - に渡されるプロパティ・プロパティで subscribeToVideo を false に設定することで、サブスクライバは動画の購読を開始または停止します。 OTSubscriber コンポーネントを使用している。

• "CodecNotSupported" - コーデックに互換性がないため、ビデオの購読が停止されました。 ビデオコーデック開発者ガイド).

について OTSubscriber オブジェクトのディスパッチ videoEnabled イベントを発生させる：

videoEnabled イベントオブジェクトの reason プロパティは、ビデオが有効になった理由を定義する。以下の値のいずれかを設定する：

• "PublisherPropertyChanged" - 出版社はビデオの公開を再開した。

• "QualityChanged" - メディアルーターは、ストリーム品質の変化に基づいて、加入者へのビデオ送信を再開した。メディアルーターのこの機能により、加入者は接続性が低下するとビデオストリームを停止し、ストリーム品質が向上するとビデオストリームを再開する。

この機能は、メディアルーターを使用するセッション（メディアモードがルーティングに設定されたセッション）のみで使用可能であり、メディアモードがリレーに設定されたセッションでは使用できない。

• "SubscriberPropertyChanged" - 加入者がビデオの購読を開始または停止した。 subscribeToVideo をfalseに設定します。

• "CodecNotSupported" - 加入者ビデオは、互換性のないコーデックからコーデックを変更した後に有効になりました ( ビデオコーデック開発者ガイド).

自分のストリーム以外のストリームがセッションから抜けるとき、Sessionオブジェクトは streamDestroyed イベントを開催する：

パブリッシュしたストリームがセッションから離れると、パブリッシャー・オブジェクトは streamDestroyed イベントを開催する：

について streamDestroyed イベントはStreamEventクラスで定義されています。このイベントには reason プロパティは、ストリームが終了した理由を詳細に記述する。これらの理由には以下が含まれる。 "clientDisconnected", "forceDisconnected", "forceUnpublished"あるいは "networkDisconnected".詳しくは ストリームイベント.

デフォルトでは streamDestroyed イベントがサブスクライブしているストリームに対してディスパッチされると、対応するサブスクライバー・オブジェクト (複数存在する可能性もあります) は破棄され、HTML DOM から削除されます。このデフォルトの動作を防ぐには preventDefault() メソッドを呼び出します：

に注意してほしい。 getSubscribersForStream() メソッドは、ストリームのすべてのサブスクライバオブジェクトを返します。

サブスクライバを自分で削除する前に、関連する DOM 要素を調整したい場合は、デフォルトの動作を防止して、サブスクライバを保持することができます。メソッドを呼び出して、サブスクライバ・オブジェクト（およびその DOM 要素）を削除できます。 destroy() メソッドを呼び出します。

サブスクライバオブジェクトは destroyed イベントは、オブジェクトが HTML DOM から削除されたときに発生します。このイベントに応答して、削除されたサブスクライバに関連する DOM 要素を調整 (または削除) することができます。

他のクライアントから発行されたストリームがセッションから離れると onStreamDropped(Session session, Stream stream) メソッドが呼び出されます。ストリームが削除されると、そのストリームのサブスクライバ・オブジェクトのビューは、そのスーパー ビューから削除されます。

加入者のビデオが無効になっていることを検知する

Vonage ビデオ・メディア・ルーターは、接続性が低下したことを検出すると、加入者へのビデオ送信を停止します。加入者は、音声ストリームがある場合は、引き続き受信します。この場合 onVideoDisabled(加入者, 加入者) メソッドは、Vonage Video Media Router がビデオの送信を停止したときに呼び出されます：

について reason パラメータは、加入者がビデオストリーミングを停止した理由を特定する。

Vonage Video Media Router が加入者のビデオを無効にする場合、加入者に関連するユーザーインターフェイスを調整したい場合があります。

について onVideoEnabled(subscriber, reason) メソッドが呼び出されます：

について reason パラメータは、加入者のビデオが再開された理由を特定する。

ストリームを公開する際、ストリームの画質が原因で動画が無効化されるのを防ぐことができます。ストリームを公開する前に Session.publish(publisher) メソッドを呼び出す。 setAudioFallbackEnabled(boolean enabled) Publisherオブジェクト（またはPublisherKitオブジェクト）のメソッドに false.

ストリームがセッションを離れると OTSession session(_:streamDestroyed:) メッセージが送信される。ストリームが削除されると、そのストリームの OTSubscriber オブジェクトのビューはそのスーパービューから削除されます。ストリームが自分のクライアントによって発行されていないかどうかを確認し、そのビューをスーパービューから削除します。

加入者のビデオが無効になっていることを検知する

サブスクライバーのデリゲートは OTSubscriberDelegate subscriberVideoDisabled(_:reason:) 加入者のビデオが無効化されたときのメッセージ：

について reason パラメータには、OTSubscriberVideoEventReason 列挙型で定義されている以下の定数のいずれかを設定する：

• OTSubscriberVideoEventPublisherPropertyChanged - このビデオイベントは、ストリームのパブリッシャーがビデオストリームを停止したために発生した。
• OTSubscriberVideoEventQualityChanged - ビデオ・イベントは、ビデオ・ストリームの画質の変化によって発生しました。ストリームの品質は、サブスクライバまたはパブリッシャのネットワーク状 況やCPU使用率によって変化する可能性がある。この理由は、メディアモードが "routed "に設定されているセッションでのみ使用される。(以下を参照のこと。 Vonage ビデオ・メディア・ルーターとメディア・モード.)Vonage Video Media Routerのこの機能は、ビデオストリームの品質が低下したときに加入者がビデオストリームをドロップし、メッセージが送信されます。状況が改善されると、ビデオストリームが再開され、メッセージが送信されます。 OTSubscriberDelegate subscriberVideoEnabled(_:reason:) メッセージが送信される。ビデオストリームがドロップされたとき、加入者は、オーディオストリームがあれば、それを受信し続ける。
• OTSubscriberVideoEventSubscriberPropertyChanged - ビデオイベントは、この加入者の OTSubscriber subscribeToVideo 財産である。

ビデオストリームが再開すると OTSubscriberDelegate subscriberVideoEnabled(_:reason:) メッセージが送信される。

ストリームを公開する際、ストリームの画質が原因で動画が無効化されるのを防ぐことができます。ストリームを公開する前に OTSession publish(_:error:) メソッドで audioFallbackEnabled プロパティをfalseに設定する。

について [OTSessionDelegate session:streamCreated:] メッセージは、セッションに新しいストリームが作成されたときに送信される。(ストリームは、クライアント 出版 ストリームをセッションに送る)。その OTStreamオブジェクト にはストリームを定義するプロパティがある。ストリームを定義するプロパティを connection OTStreamオブジェクトの connection OTSessionオブジェクトのプロパティを使用して、そのストリームがクライアントが公開したものであるかどうかを判断します：

他のクライアントから発行されたストリームがセッションから抜けるとき、Sessionオブジェクトは StreamDropped イベントを開催する：

これに渡されるイベント引数オブジェクトは、OpenTok.Session.StreamEventArgs クラスで定義されます。このクラスには Stream プロパティを使用します。比較する Stream オブジェクトを Stream プロパティを使用して、ストリームのサブスクライバを識別します。

加入者のビデオが無効になっていることを検知する

Vonage Video Media Router は、接続性が低下したことを検出すると、加入者へのビデオ送信を停止します。音声ストリームがある場合、加入者は引き続き受信します。Vonage Video Media Router がビデオの送信を停止すると、加入者オブジェクトは VideoDisabled イベントを開催する：

Vonage Video Media Router が加入者のビデオを無効にする場合、加入者に関連するユーザーインターフェイスを調整したい場合があります。

サブスクライバーオブジェクトは VideoDisabled イベントを発生させる：

について on_stream_dropped のコールバック関数である。 otc_session_callbacks struct は、他のクライアントのストリームが Vonage Video セッションからドロップされたときに呼び出されます。この構造体は stream この関数に渡されるパラメータは otc_stream 構造体をストリームのを呼び出す。 otc_stream_get_id() メソッドに otc_stream 構造体を使用してストリームIDを取得する。

ストリームのビデオが無効になっていることを検出する

について on_stream_has_video_changed のコールバック関数である。 otc_session_callbacks struct は、他のクライアントのストリームが Vonage Video セッションからドロップされたときに呼び出されます。この構造体は stream この関数に渡されるパラメータは otc_stream 構造体をストリームのを呼び出す。 otc_stream_get_id() メソッドに otc_stream 構造体を使用してストリームIDを取得する。