PublisherKit.Builder

java.lang.Object

com.opentok.android.PublisherKit.Builder

直接の既知のサブクラス： : Publisher.Builder

包含クラス： : PublisherKit

public static class PublisherKit.Builder extends 目的

～を構築するために使用される PublisherKit オブジェクト。以下の方法を使用して、Builder オブジェクトをインスタンス化します。 PublisherKit.Builder(Context context) コンストラクタ。次に、の Builder パブリッシャーの設定を追加するインスタンス。その後、 build() このメソッドは、 PublisherKit オブジェクトがある。

を使用する。 Session.publish(PublisherKit publisher) パブリッシャーからセッションへストリーミングを開始する方法。

パブリッシャーは再利用できません。新しいインスタンスを作成してください。 PublisherKit 新しいストリームを公開するたびに、オブジェクトを指定します。

コンストラクタの概要

コンストラクタ

説明

Builder(android.content.Context context)

のインスタンスを作成します PublisherKit.Builder オブジェクトがある。

方法の概要

すべてのメソッド　インスタンスメソッド　具体的なメソッド

修飾子と型

方法

説明

PublisherKit.Builder

allowAudioCaptureWhileMuted(boolean allow)

false に設定すると、すべてのパブリッシャーが音声をミュートした時点で、マイクが自動的にオフになります。

PublisherKit.Builder

audioBitrate(int bitsPerSecond)

公開されるオーディオの希望ビットレートを、ビット/秒単位で設定します。

PublisherKit.Builder

audioTrack(boolean enabled)

公開されるストリームにオーディオトラックを含めるかどうかを設定します（true, デフォルト）か、そうでないか（false).

PublisherKit

build()

PublisherKit.Builder

capturer(BaseVideoCapturer capturer)

パブリッシャーで使用するビデオキャプチャ機能を設定します。

PublisherKit.Builder

enableOpusDtx(boolean enable)

有効にするかどうか Opus DTX (true)または(falseデフォルト）。

PublisherKit.Builder

name(String name)

公開される動画のタイトルを設定します。

PublisherKit.Builder

preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)

PublisherKit.Builder

publisherAudioFallbackEnabled(boolean enabled)

そのストリームがパブリッシャーのオーディオ・フォールバック機能を使用するかどうか（true) かどうか (false).

PublisherKit.Builder

renderer(BaseVideoRenderer renderer)

パブリッシャーで使用するビデオレンダラーを設定します。

PublisherKit.Builder

scalableScreenshare(boolean enabled)

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

PublisherKit.Builder

senderStatsTrack(boolean enabled)

これを呼び出さず、 true, パブリッシャーに対しては、送信者統計サブシステムが初期化されません。

PublisherKit.Builder

subscriberAudioFallbackEnabled(boolean enabled)

そのストリームが、サブスクライバー向けオーディオ・フォールバック機能を使用するかどうか（true) かどうか (false)、公開ストリームの購読者向け。

PublisherKit.Builder

videoTrack(boolean enabled)

公開されるストリームにビデオトラックを含めるかどうかを設定します（true, デフォルト）か、そうでないか（false).

java.lang クラスから継承されたメソッド。目的

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ビルダー

public Builder(android.content.Context context)

のインスタンスを作成します PublisherKit.Builder オブジェクトがある。

パラメータ： : context - その android.content.Context 出版社向け。

メソッドの詳細

名称

public PublisherKit.Builder name(ストリング名前)

公開される動画の名前を設定します。この name このパブリッシャーによって公開されたストリームのプロパティは、この値に設定されます（すべてのクライアントにおいて）。

audioTrack

public PublisherKit.Builder audioTrack(boolean enabled)

公開されるストリームにオーディオトラックを含めるかどうかを設定します（true, デフォルト）か、そうでないか（false). オーディオトラックを含まないパブリッシャーを作成することで、 CPUリソースを節約し、ストリームが使用する帯域幅を削減できます。

これを呼び出して、 false, パブリッシャーに対してオーディオサブシステムは初期化されず、 PublisherKit.setPublishAudio(boolean publishAudio) このメソッドは効果を発揮しません。アプリケーションで音声機能を使用する必要がない場合は、このBuilder設定を使用することをお勧めします。 PublisherKit.setPublishAudio(boolean publishAudio) このメソッドは、オーディオトラックを一時的に無効にするだけです。

videoTrack

public PublisherKit.Builder videoTrack(boolean enabled)

公開されるストリームにビデオトラックを含めるかどうかを設定します（true, デフォルト）か、そうでないか（false). ビデオトラックを含まないパブリッシャーを作成することで、 CPUリソースを節約し、ストリームが使用する帯域幅を削減できます。

これを呼び出して、 false, ビデオサブシステムはパブリッシャーに対して初期化されず、 PublisherKit.setPublishVideo(boolean publishVideo) このメソッドは効果を発揮しません。アプリケーションで動画の使用が必要ない場合は、このBuilder設定を使用することをお勧めします。 PublisherKit.setPublishVideo(boolean publishVideo) このメソッドは、ビデオトラックを一時的に無効にするだけです。

キャプチャ機能

public PublisherKit.Builder capturer(BaseVideoCapturer キャプチャ機能)

パブリッシャーで使用するビデオキャプチャ機能を設定します。

レンダラー

public PublisherKit.Builder レンダラー(BaseVideoRenderer レンダラー)

パブリッシャーで使用するビデオレンダラーを設定します。

オーディオビットレート

public PublisherKit.Builder audioBitrate(int bitsPerSecond)

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

以下は推奨設定です：

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 です。

その他のオーディオ設定を行うには、 AudioDeviceManager クラスである。

パラメータ： : bitsPerSecond - オーディオの希望ビットレート（ビット/秒）。

戻り値： : この Builder オブジェクト。

enableOpusDtx

public PublisherKit.Builder enableOpusDtx(boolean enable)

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

デフォルトでは、Opus DTXは無効になっています。このプロパティが true, パブリッシャーに対してOpus DTXが有効化されます。

スケーラブルな画面共有

public PublisherKit.Builder scalableScreenshare(boolean enabled)

subscriberAudioFallbackEnabled

public PublisherKit.Builder subscriberAudioFallbackEnabled(boolean enabled)

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

デフォルトの設定は true （オーディオ・フォールバック機能が有効になっています）。 OpenTok Media Server を使用するセッションで「画面共有」ビデオタイプを使用する場合、サブスクライバーのオーディオ・フォールバック設定は false デフォルトでは、チャンネル登録者の動画再生が途切れないようにするためです。

publisherAudioFallbackEnabled

public PublisherKit.Builder publisherAudioFallbackEnabled(boolean enabled)

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

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

allowAudioCaptureWhileMuted

public PublisherKit.Builder allowAudioCaptureWhileMuted(boolean allow)

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

推奨ビデオコーデック

public PublisherKit.Builder preferredVideoCodecs(PublisherKit.推奨ビデオコーデック preferredVideoCodecs)

senderStatsTrack

public PublisherKit.Builder senderStatsTrack(boolean enabled)

これを呼び出さず、 true, パブリッシャーに対しては、送信者統計サブシステムが初期化されません。

ビルド

public PublisherKit build()

戻り値： : 新しい PublisherKit …に基づくインスタンス PublisherKit.Builder 設定。