UIのカスタマイズ — iOS

OpenTokの動画のユーザーインターフェースをカスタマイズするために、以下の設定を行うことができます：

公開ストリームに名前を追加する

公開ストリームのnameプロパティを指定するには name プロパティを使用します：

OTPublisherSettings *_publisherSettings = [[OTPublisherSettings alloc] init];
_publisherSettings.name = @"Juan";
_publisher = [[OTPublisher alloc]
              initWithDelegate:self
              settings:_publisherSettings];

OTStream クラスは name プロパティあなたが ストリームを購読するこの名前をユーザー インターフェイス要素に表示できます。(また、この名前は、OpenTok.js ライブラリを使用する Web ページで動画を表示する場合にも表示されます)。

出版社の「名前」欄に個人情報を使用しないこと — パブリッシャー名は、セッションの他の参加者に公開される可能性があり、またインスペクターツールやVonageの内部ログにも表示される可能性があるため、パブリッシャー名には、暗号化されていない機密情報や個人情報を決して使用しないでください。 セキュリティのベストプラクティスを参照してください.

パブリッシャーにミュートボタンを追加する

パブリッシャーのマイクをミュートするデフォルトのユーザーインターフェース要素はありません。しかし、ボタンなどの要素を追加して publishAudio プロパティを設定します。プロパティを設定します。 publishAudio プロパティ NO をミュートしてください：

publisher.publishAudio = NO;

を設定する。 publishAudio プロパティ YES オーディオを公開する。

publisher.publishAudio = YES;

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 4: Overlay Graphics」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

加入者にミュートボタンを追加する

加入者の音声をミュートするデフォルトのユーザーインターフェイス要素はありません。ただし、ボタンなどの要素を追加して subscribeToAudio ユーザがクリックしたときに OTSubscriber オブジェクトのオブジェクトに subscribeToAudio プロパティ NO 加入者をミュートする

subscriber.subscribeToAudio = NO;

を設定する。 subscribeToAudio プロパティ YES オーディオストリームがある場合）オーディオを購読する：

subscriber.subscribeToAudio = YES;

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 4: Overlay Graphics」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

パブリッシャーのカメラを切り替えるボタンの追加

パブリッシャーが使用するカメラを切り替えるデフォルトのユーザーインターフェース要素はありません。しかし、ボタンなどの要素を追加して cameraPosition プロパティを設定します。このプロパティに AVCaptureDevicePosition 列挙型で定義された値を設定します。例えば、以下のコードではパブリッシャーが背面カメラを使用するように設定しています：

publisher.cameraPosition = AVCaptureDevicePositionBack;

に注意してほしい。 cameraPosition プロパティは OTPublisherKit クラスでは使用できません。OTPublisherKit クラスで カスタムビデオキャプチャーの実装カスタムビデオキャプチャコードで使用するカメラを定義することができます。

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 4: Overlay Graphics」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

ビデオの有効/無効時のユーザーインターフェースの調整

加入者のビデオが無効になっている場合 [OTSubscriberKitDelegate subscriberVideoDisabled:reason:]。 メッセージが送信されます。この場合、ユーザー・インターフェース要素（アイコンなど）を追加して、ビデオが無効であることを示すことができます：

- (void)subscriberVideoDisabled:(OTSubscriberKit*)subscriber
                         reason:(OTSubscriberVideoEventReason)reason
{
    // Display the video disabled indicator
}

加入者のビデオが再び有効になると [OTSubscriberKitDelegate subscriberVideoEnabled:reason:]。 メッセージが送信されます。この場合、ビデオが再び有効になったことを示すユーザーインターフェイス要素（アイコンなど）を削除することができます：

- (void)subscriberVideoEnabled:(OTSubscriberKit*)subscriber
                        reason:(OTSubscriberVideoEventReason)reason
{
    // Remove the video disabled indicator
}

を使用するセッションでは OpenTok メディアルーター (メディアモードがルーティングに設定されているセッション）では、以下のメッセージも送信できる：

また、これらのメッセージが送信されたときに、ユーザーインターフェイスの通知（アイコンなど）を表示したり、削除したりすることもできます。

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 4: Overlay Graphics」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

ストリームを公開する際には、パブリッシャーおよびサブスクライバーのオーディオフォールバックを有効または無効にする点に注意してください。オーディオフォールバック機能は、ネットワークやCPUの状態が動画の再生に対応できない場合、パブリッシャーおよびサブスクライバーの動画を無効にします。詳しくは、 オーディオのフォールバック（iOS）.

パブリッシャーのオーディオフォールバックを有効にすると、 PublisherKitDelegate オブジェクトはパブリッシャーオーディオのフォールバック関連のイベントに関して以下のメッセージを送信します：

  • [OTPublisherKitDelegate publisherVideoDisabled:reason:]
  • [OTPublisherKitDelegate publisherVideoEnabled:reason:]
  • [OTPublisherKitDelegate publisherVideoDisableWarning:]
  • [OTPublisherKitDelegate publisherVideoDisableWarningLifted:]

これらのイベントに応じて、UIインジケーターを表示することができます。

セッションがアーカイブされているときにインジケータ要素を表示する

セッションのアーカイブが録画を開始するとき（あるいは録画中のセッションに接続するとき）には [OTSessionDelegate session:archiveStartedWithId:name:] メッセージが送信される。録音が停止すると [OTSessionDelegate session:archiveStoppedWithId:] メッセージが送信されます。OTPublisherビューに表示されるアイコンなど、録画中であることを示すユーザーインターフェイス要素を追加できます：

- (void)     session:(OTSession*)session
archiveStartedWithId:(NSString*)archiveId
                name:(NSString*)name
{
    // Display the archive indicator
}

- (void)     session:(OTSession*)session
archiveStoppedWithId:(NSString*)archiveId
{
    // Hide the archive indicator
}

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 5: Multi-Party-Call」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

ビデオのスナップショット画像を取得する

以下のコードでは、Publisherビデオの静止画像をキャプチャして表示し、それをメイン・ビューに追加して、その画像にUIImageオブジェクトを設定しています：

UIView* screenCapture = [publisher.view
    snapshotViewAfterScreenUpdates:YES];
[self.view addSubview:screenCapture];

UIGraphicsBeginImageContextWithOptions(publisher.view.bounds.size,
    NO, [UIScreen mainScreen].scale);
[view drawViewHierarchyInRect:publisher.view.bounds
    afterScreenUpdates:YES];
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();

次のコードは、加入者ビデオの静止画像をキャプチャして表示し、それをメインビューに追加して、その画像に UIImage オブジェクトを設定します：

UIView* screenCapture = [subscriber.view
    snapshotViewAfterScreenUpdates:YES];
[self.view addSubview:screenCapture];

UIGraphicsBeginImageContextWithOptions(subscriber.view.bounds.size,
    NO, [UIScreen mainScreen].scale);
[view drawViewHierarchyInRect:subscriber.view.bounds
    afterScreenUpdates:YES];
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();

出版社に関する高解像度の画像を取得する例については、 OpenTok iOS サンプルリポジトリ. このサンプルは、OpenTok iOS SDKのsamplesディレクトリにも含まれています。

オーディオレベルに応じてユーザーインターフェースを調整

について [OTPublisherKitAudioLevelDelegate publisher:audioLevelUpdated:] そして [OTSubscriberKitAudioLevelDelegate subscriber:audioLevelUpdated:] メッセージは定期的に送信され、サブスクライバーとパブリッシャーの音声レベルが表示されます。メッセージは audioLevel オーディオレベルメーターの表示を更新するための値。

例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 6: Audio Levels」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

注： パブリッシャーのオーディオレベルは、そのストリームがセッションに公開されるまでは利用できません。パブリッシャーがセッションへのストリーミングを開始する前にオーディオをプレビューするには、 カスタムオーディオドライバ.

デフォルトでは、プライバシー保護のため、全てのパブリッシャーがミュートされると、オーディオキャプチャは停止され、マイクは解放されます。これはパブリッシャーインスタンスが再び音声を有効にするまで音声レベルの更新が行われないことを意味します。バージョン 2.31.0 以降では、パブリッシャーはミュート中でもオーディオキャプチャを継続できるようにプロパティが設定されています。

新しいパブリッシャーインスタンスをインスタンス化する際に、開発者はこの動作を有効にすることができます：


	OTPublisherKitSettings* settings = [[OTPublisherKitSettings alloc] init];
    settings.allowAudioCaptureWhileMuted = true;
	_publisher = [[OTPublisherKit alloc] initWithDelegate:self settings:settings];

注意：この動作を有効にすると、パブリッシャーがミュート状態でもマイクが使用されます。

カスタムビデオレンダラの使用

OTPublisher クラスおよび OTSubscriber クラスは、パブリッシャーまたはサブスクライバーの動画をレンダリングするデフォルトの UIView インスタンスを提供します。 OTPublisherKit、OTSubscriberKit、およびOTVideoRenderクラスを使用して、カスタムビデオストリームAPIを通じてカスタムビデオレンダラーを定義することができます。例については、OpenTok iOS SDKのsamplesディレクトリにある「Project 2: Let's Build OTPublisher」サンプル（または opentok-ios-sdk-samples (GitHub上のリポジトリ)。

を使うようにパブリッシャーを設定することもできます。 カスタムビデオキャプチャ.