| 準拠規格 | NSObject |
| 宣言された場所 | OTSubscriberKit.h |
概要
OTSubscriber インスタンスへのメッセージ送信に使用します。メッセージを送信する際は、 [OTSubscriberKit initWithStream:delegate:] メッセージでは、 OTSubscriberKitDelegate オブジェクトを指定します。
購読者の利用
– subscriberDidConnectToStream: 必須メソッド
加入者がストリームへの接続に成功した際に送信されます。
- (void)subscriberDidConnectToStream:(nonnull OTSubscriberKit *)subscriber
パラメータ
subscriber |
このイベントを発生させた加入者。 |
登録地
OTSubscriberKit.h
– subscriber:didFailWithError: 必須メソッド
加入者がストリームへの接続に失敗した場合に送信されます。
- (void)subscriber:(nonnull OTSubscriberKit *)subscriber didFailWithError:(nonnull OTError *)error
パラメータ
subscriber |
このイベントを発生させた加入者。 |
error |
エラー（an OTError この接続エラーを説明する（オブジェクト）。 OTSubscriberErrorCode enum（OTError クラスで定義されている）は、 code このオブジェクトのプロパティ。 |
登録地
OTSubscriberKit.h
– subscriberVideoDisabled:reason:
このメッセージは、加入者が動画の受信を停止した際に送信されます。 動画の受信が停止した理由については、「reason」パラメータを確認してください。
- (void)subscriberVideoDisabled:(nonnull OTSubscriberKit *)subscriber reason:(OTSubscriberVideoEventReason)reason
パラメータ
subscriber |
について OTS購読者 今後、動画の配信を受けられなくなるものです。 |
reason |
ビデオトラックが無効にされた理由。詳しくは OTSubscriberVideoEventReason. |
登録地
OTSubscriberKit.h
– subscriberVideoEnabled:reason:
このメッセージは、サブスクライバーの動画ストリームが開始されたとき（それまで 動画がなかった場合）、または再開されたとき（動画が無効化されていた後）に送信されます。 動画が開始（または再開）された理由については、reason パラメータを確認してください。
- (void)subscriberVideoEnabled:(nonnull OTSubscriberKit *)subscriber reason:(OTSubscriberVideoEventReason)reason
パラメータ
subscriber |
について OTS購読者 動画を受信するものです。 |
reason |
ビデオトラックが有効にされた理由。詳細はこちら OTSubscriberVideoEventReason. |
登録地
OTSubscriberKit.h
– subscriberVideoDisableWarning:
このメッセージは、OpenTok Media Router がストリームの 画質が低下したと判断し、さらに画質が低下した場合は 動画が停止される場合に送信されます。画質がさらに低下した場合、加入者は動画を 停止し、 [OTSubscriberKitDelegate subscriberVideoDisabled:reason:]。 メッセージ が送信されます。ストリームの品質が向上した場合、 [OTSubscriberKitDelegate subscriberVideoDisableWarningLifted:]。 メッセージが 送信されました。
- (void)subscriberVideoDisableWarning:(nonnull OTSubscriberKit *)subscriber
パラメータ
subscriber |
について OTS購読者 まもなく動画の配信が停止される可能性がある。 |
考察
この機能は、 OpenTok Media Router を使用するセッション（ メディアモード （ルーティング設定）に設定されている場合を除き、メディアモードが中継に設定されているセッションでは適用されません。
このメッセージは、主に接続品質が低下した際に送信されます。
登録地
OTSubscriberKit.h
– subscriberVideoDisableWarningLifted:
このメッセージは、OpenTok Media Router が、ストリームの 品質が改善し、動画の配信停止が 差し迫ったリスクではなくなったと判断した際に送信されます。このメッセージは、以下の後に送信されます。 [OTSubscriberKitDelegate subscriberVideoDisableWarning:]。 メッセージが 送信されました。
- (void)subscriberVideoDisableWarningLifted:(nonnull OTSubscriberKit *)subscriber
パラメータ
subscriber |
について OTS購読者 インスタンスだ。 |
考察
この機能は、 OpenTok Media Router を使用するセッション（ メディアモード （ルーティング設定）に設定されている場合を除き、メディアモードが中継に設定されているセッションでは適用されません。
このメッセージは、主に接続品質が改善されたときに送信されます。
登録地
OTSubscriberKit.h
– subscriberDidDisconnectFromStream:
加入者のストリームが中断されたときに呼び出されます。
- (void)subscriberDidDisconnectFromStream:(nonnull OTSubscriberKit *)subscriber
パラメータ
subscriber |
このイベントを発生させた加入者。 |
考察
このメッセージが送信されたことを受け、ユーザーに、 オーディオ・ビデオストリームが一時的に切断されており、アプリがストリームへの再接続を試みていることを 知らせるため、ユーザーインターフェース上の通知を表示することを検討するとよいでしょう。
クライアントがストリームに再接続した場合、 [OTSubscriberKitDelegate subscriberDidReconnectToStream:] メッセージが送信される。
登録地
OTSubscriberKit.h
– subscriberDidReconnectToStream:
加入者のストリームが再開された時点で送信されます。 [OTSubscriberKitDelegate subscriberDidDisconnectFromStream:] メッセージ が送信されます。
- (void)subscriberDidReconnectToStream:(nonnull OTSubscriberKit *)subscriber
パラメータ
subscriber |
このイベントを発生させた加入者。 参照 [OTSessionDelegate sessionDidReconnect:]. |
登録地
OTSubscriberKit.h