継承元 NSObject
宣言された場所 OTPublisherKit.h

概要

を使用してパブリッシャーを初期化する際に使用する設定を定義します。 [OTPublisherKit initWithDelegate:settings:] メソッドを使用する。

パブリッシャーの設定の定義

name

動画の配信元の名称。その [OTStream名] プロパティ このパブリッシャーによって公開されるストリームについては、この値に設定されます (すべてのクライアントにおいて)。デフォルト値は nil.

@property (nonatomic, copy, nullable) NSString *name

登録地

OTPublisherKit.h

audioTrack

音声を公開するか(YES:デフォルト)、公開しないか(NO)。

@property (nonatomic) BOOL audioTrack

考察

このプロパティが「NO」に設定されている場合、パブリッシャーのオーディオサブシステムは初期化されません。 また、 [OTPublisherKit publishAudio] プロパティ は効果を持ちません。アプリケーションで音声を使用する必要がない場合は、 この Builder プロパティを設定することをお勧めします。 [OTPublisherKit publishAudio] プロパティ。これは、 オーディオトラックを一時的に無効にするだけです。

登録地

OTPublisherKit.h

videoTrack

動画を公開するか(YES:デフォルト)、公開しないか(NO)。

@property (nonatomic) BOOL videoTrack

考察

このプロパティが「NO」に設定されている場合、パブリッシャーに対してビデオサブシステムは初期化されません。 また、 [OTPublisherKit publishVideo] プロパティ は効果を持ちません。アプリケーションで動画の使用が必要ない場合は、 この Builder プロパティを設定することをお勧めします。 [OTPublisherKit publishVideo] プロパティ。これは、 ビデオトラックを一時的に無効にするだけです。

登録地

OTPublisherKit.h

senderStatsTrack

送信者統計情報を公開するかどうか(YES)または公開しないかどうか(NO、デフォルト)。

@property (nonatomic) BOOL senderStatsTrack

考察

このプロパティが「NO」に設定されている場合、パブリッシャーに対して送信者統計サブシステムは初期化されません。

登録地

OTPublisherKit.h

audioBitrate

配信するオーディオの希望ビットレート(ビット/秒)。 サポートされる値の範囲は 6,000 ~ 510,000 です。(無効な値は 無視されます。)この値を設定することで、高音質のオーディオを有効にしたり(あるいは、 低音質のオーディオで帯域幅の使用量を削減したり)することができます。

@property (nonatomic) int audioBitrate

考察

以下は推奨設定です:

  • 8,000~12,000(ナローバンド(NB)スピーチ用
  • 16,000~20,000(ワイドバンド(WB)スピーチ用
  • フルバンド(FB)スピーチで28,000~40,000ドル
  • フルバンド(FB)モノラル音楽の場合、48,000~64,000
  • フルバンド(FB)ステレオ音楽の場合、64,000~128,000

デフォルト値は 40,000 です。

その他のオーディオ設定を行うには、 OTAudioDeviceManager インターフェイスがある。

登録地

OTPublisherKit.h

enableOpusDtx

有効にするかどうか Opus DTX (YES) または (NO、デフォルト)。Opus DTX を有効にすると、 長時間の無音部分があるストリームにおいて、帯域幅の使用量を削減できます。

@property (nonatomic) BOOL enableOpusDtx

登録地

OTPublisherKit.h

scalableScreenshare

の使用を許可するかどうか スケーラブルビデオ videoType が OTStreamVideoTypeScreen に設定されている(YES)か、設定されていない(NO、デフォルト)か、という出版社について。

@property (nonatomic) BOOL scalableScreenshare

登録地

OTPublisherKit.h

subscriberAudioFallbackEnabled

そのストリームが、サブスクライバー向けオーディオ・フォールバック機能を使用するかどうか(YES) あるいは そうでない場合 (NO)、公開ストリームのサブスクライバー向けです。サブスクライバー向け オーディオフォールバック機能は、OpenTok Media Router を使用するセッションで利用可能です。 サブスクライバー向けオーディオフォールバック機能が有効になっている場合、OpenTok Media Routerが、特定の加入者に対してストリームの品質が著しく低下したと 判断した場合、通話品質を維持するために、 その加入者のビデオを無効にします。

@property (nonatomic, assign) BOOL subscriberAudioFallbackEnabled

考察

デフォルトの設定は YES (オーディオフォールバック機能が 有効になっている)カメラを使用するパブリッシャーの場合。OpenTok Media Server を使用するセッションで スクリーンビデオタイプを使用する場合、 サブスクライバーのオーディオフォールバックプロパティは NO デフォルトでは、 チャンネル登録者の動画再生が途切れないようにするためです。

詳しくは [OTPublisherKit videoType], [OTSubscriberKitDelegate subscriberVideoDisabled:reason:]。, OTSubscriberVideoEventReason, OpenTok Media Router.

登録地

OTPublisherKit.h

publisherAudioFallbackEnabled

そのストリームがパブリッシャーのオーディオ・フォールバック機能を使用するかどうか(YES) あるいは そうでない場合 (NO). パブリッシャーのオーディオフォールバック機能が 有効になっている場合、パブリッシャーがストリームの品質が 著しく低下したと判断すると、通話品質を維持するために動画を無効にします。

@property (nonatomic, assign) BOOL publisherAudioFallbackEnabled

考察

デフォルトの設定は NO (オーディオのフォールバック機能は 無効になっています)。

詳しくは [OTPublisherKit videoType], [OTPublisherKitDelegate publisherVideoDisabled:reason:], OTPublisherVideoEventReason, OpenTok Media Router.

登録地

OTPublisherKit.h

allowAudioCaptureWhileMuted

「NO」に設定すると、すべてのパブリッシャーが 音声をミュートした時点で、マイクが自動的にオフになります。少なくとも1人の パブリッシャーがミュートを解除すると、マイクは自動的に再びオンになります。 「YES」に設定すると、すべてのパブリッシャーが音声をミュートしている場合でも、マイクは常にオンのままになります。 マイクがオフになっている場合、AudioLevel や AudioData などのコールバックは パブリッシャーに対して呼び出されなくなる点に注意してください。 デフォルト値は NO です。

@property (nonatomic) BOOL allowAudioCaptureWhileMuted

登録地

OTPublisherKit.h

videoCodecPreference

公開に使用する優先ビデオコーデックを指定します。

@property (nonatomic, nullable) OTVideoCodecPreference *videoCodecPreference

考察

このプロパティを使用して、ネゴシエーション中に優先されるビデオコーデックを制御します。 設定されていない場合、SDK はプロジェクトのデフォルトのコーデック設定を使用します。 のインスタンスを割り当てます。 OTVideoCodecPreference コーデックの選択を 自動で行うか、それとも明示的な順序付きコーデックリストを指定するかを指定します。

  • に設定する。 [OTVideoCodecPreference automatic] SDKが最適なコーデックを選択できるようにするため。
  • に設定する。 [OTVideoCodecPreference manualWithCodecs:...] コーデックネゴシエーションの優先順位を 明示的に指定するため。サポートされているコーデック: OTVideoCodecTypeVP8, OTVideoCodecTypeH264, OTVideoCodecTypeVP9.

無効なコーデックリスト(例:空の配列や未知のコーデック値)が指定された場合、パブリッシャーの初期化は失敗します。

コーデックの選択および有効な値の詳細については、以下を参照してください。 OTVideoCodecPreference.

登録地

OTPublisherKit.h