com.opentok.android.PublisherKit
実装済みのすべてのインターフェース:
: Observer
直接の既知のサブクラス:
: Publisher
public class PublisherKit extends 目的 実装 オブザーバー
パブリッシャーは、指定したソースからオーディオ・ビデオストリームを取得します。その後、
以下の関数を呼び出すことで、そのオーディオ・ビデオストリームを OpenTok セッションに配信することができます。
Session.publish(PublisherKit publisher) メソッドを使用する。
独自の
動画キャプチャおよびレンダリングの実装を提供したい場合は、PublisherKitのサブクラスを作成してください。そうでない場合は、 Publisher
クラス。これには、あらかじめ組み込まれたビデオキャプチャ機能とレンダリング機能が含まれています。
ネストされたクラスの概要
ネストされたクラス
修飾子と型
クラス
説明
static interface
PublisherKit.AudioLevelListener
パブリッシャーのオーディオレベルの変化を監視します。
static interface
PublisherKit.AudioStatsListener
パブリッシャーのオーディオ統計情報を取得するためのリスナーオブジェクトを定義します。
class
PublisherKit.AudioTransformer
オーディオストリーム用のトランスフォーマー。
static class
PublisherKit.Builder
~を構築するために使用される PublisherKit オブジェクトがある。
static interface
PublisherKit.CustomAudioTransformer
オーディオストリーム用のカスタムトランスフォーマーを定義し、これを
PublisherKit.AudioTransformer
コンストラクタ。
static interface
PublisherKit.CustomVideoTransformer
ビデオストリーム用のカスタムトランスフォーマーを定義し、これを
PublisherKit.VideoTransformer
コンストラクタ。
static enum
PublisherKit.DegradationPreference
帯域幅やCPUリソースが限られている場合に、フレームレートや解像度を調整する際、 ビデオエンジンが遵守しようとする方針について説明します。
static interface
PublisherKit.MediaLinkStatsListener
パブリッシャーのメディアリンクの統計情報を取得するためのリスナーオブジェクトを定義します。
static interface
PublisherKit.MuteListener
モデレーターがこの配信者の音声を強制的にミュートにした場合を監視します。
static final class
PublisherKit.PreferredVideoCodecs
動画の公開に関するコーデックの設定を定義します。
static class
PublisherKit.PublisherAudioStats
パブリッシャーのオーディオ統計情報を定義します。
static enum
PublisherKit.PublisherKitVideoType
の値を定義します。 setPublisherVideoType(PublisherKitVideoType type) メソッドを使用する。
static interface
PublisherKit.PublisherListener
パブリッシャーがセッションへのストリーミングを開始および停止したタイミングを監視します。
static class
PublisherKit.PublisherMediaLinkStats
ローカル転送に関するメトリクスを含む、パブリッシャーのメディアリンク統計情報を提供します。
static class
PublisherKit.PublisherRtcStats
パブリッシャーによって公開されたメディアストリームに関するRTC統計情報を表します。
static interface
PublisherKit.PublisherRtcStatsReportListener
パブリッシャーのRTC統計レポートを取得するためのリスナーオブジェクトを定義します。
static class
PublisherKit.PublisherVideoStats
パブリッシャーの動画統計情報を定義します。
static enum
PublisherKit.VideoBitratePreset
の値を定義します。 setVideoBitratePreset(VideoBitratePreset preset) メソッドを使用する。
static class
PublisherKit.VideoLayerStats
公開済みの単一の動画レイヤーに関する統計情報を表します。
static interface
PublisherKit.VideoListener
パブリッシャーがビデオデータの受信を開始および停止したタイミングを監視します。
static interface
PublisherKit.VideoStatsListener
パブリッシャーの動画統計情報を取得するためのリスナーオブジェクトを定義します。
class
PublisherKit.VideoTransformer
ビデオストリーム用のトランスフォーマー。
フィールド概要
フィールド
修飾子と型
フィールド
説明
protected PublisherKit.AudioLevelListener
audioLevelListener
protected PublisherKit.AudioStatsListener
audioStatsListener
protected BaseVideoCapturer
capturer
protected android.content.Context
context
protected android.os.Handler
handler
protected PublisherKit.MediaLinkStatsListener
mediaLinkStatsListener
protected PublisherKit.MuteListener
muteListener
static final String
NETWORK_REASON_NETWORK_CONDITION_CHANGE
ローカル参加者のネットワーク状態が変化したことを示します。
protected PublisherKit.PublisherListener
publisherListener
protected BaseVideoRenderer
renderer
protected PublisherKit.PublisherRtcStatsReportListener
rtcStatsReportListener
static final String
VIDEO_REASON_CODEC_CHANGE
ストリームのビデオコーデックが変更されました。
static final String
VIDEO_REASON_NONE
static final String
VIDEO_REASON_QUALITY
この動画の再生障害は、ネットワークの混雑状況の変化によって引き起こされました。
static final String
VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH
ネットワーク帯域幅の不足による品質の低下。
static final String
VIDEO_REASON_QUALITY_DEGRADATION_CPU
クライアント端末のCPUの性能制限に起因する品質の低下。
static final String
VIDEO_REASON_QUALITY_DEGRADATION_OTHER
その他の理由による品質の低下。
static final String
VIDEO_REASON_RESOLUTION_CHANGE
動画の解像度やレイヤー数の変更。
protected PublisherKit.VideoListener
videoListener
protected PublisherKit.VideoStatsListener
videoStatsListener
コンストラクタの概要
コンストラクタ
修飾子
コンストラクタ
説明
protected
PublisherKit(PublisherKit.Builder builder)
方法の概要
すべてのメソッド インスタンスメソッド 具体的なメソッド 非推奨のメソッド
修飾子と型
方法
説明
void
destroy()
ガベージコレクタによって解放されない場合、このオブジェクトおよびそれにバインドされているすべてのハードウェアリソースとUIリソースを解放します。
protected void
finalize()
ガベージコレクタが、PublisherKit オブジェクトへの参照が もう存在しないと判断した際に呼び出されます。
BaseVideoCapturer
getCapturer()
このパブリッシャーで使用されているビデオキャプチャ機能を返します。
PublisherKit.DegradationPreference
getDegradationPreference()
帯域幅やCPUの制約に応じて、フレームレートや解像度を調整する際に、ビデオエンジンが優先して適用するポリシーを取得します。
int
getMaxVideoBitrate()
パブリッシャーの動画ストリームの最大動画ビットレート(ビット/秒)を取得します。
String
getName()
ストリーム名。
boolean
getPublishAudio()
出版社がオーディオを配信しているかどうか(true) かどうか(
false).
boolean
getPublishCaptions()
出版社がキャプションを掲載しているかどうか(true) かどうか(
false).
PublisherKit.PublisherKitVideoType
getPublisherVideoType()
このパブリッシャーの動画のタイプを返します。
boolean
getPublishVideo()
出版社が動画を公開しているかどうか(true) かどうか(
false).
BaseVideoRenderer
getRenderer()
このパブリッシャーのビデオレンダラーを返します。
void
getRtcStatsReport()
そのパブリッシャーのRTC統計レポートを取得します。
Session
getSession()
次の値を返します。 Session この Publisher インスタンスにバインドされています。
Stream
getStream()
パブリッシャーのストリームに対応するストリームオブジェクトを返します。
String
getTargetScalabilityMode()
setTargetScalabilityMode によって明示的に設定されたターゲットのスケーラビリティモードを取得します。
PublisherKit.VideoBitratePreset
getVideoBitratePreset()
パブリッシャーのストリームについて、現在アクティブな動画ビットレートプリセットを取得します。
android.view.View
getView()
Publisher ビデオを含む android.view.View オブジェクトを返します。
protected void
onAudioLevelUpdated(float audioLevel)
パブリッシャーのオーディオレベルを報告するために、定期的に呼び出されます。
protected void
onError(OpentokError error)
パブリッシャーの処理が失敗した際に呼び出されます。
protected void
onMuteForced()
モデレーターがこのパブリッシャーの音声を強制的にミュートにした際に表示されます。
void
onPause()
直接電話しないでください。電話をかける場合は Session.onPause() その代わりだ。
void
onRestart()
以前に呼び出しによって解放されていたパブリッシャーリソースを、
onStop() メソッドを使用する。
void
onResume()
直接電話しないでください。電話をかける場合は Session.onResume() その代わりだ。
protected void
onRtcStatsReport(PublisherKit.PublisherRtcStats[] stats)
パブリッシャーのRTC統計レポートが利用可能になった際に、
への呼び出しに応じて呼び出されます。 getRtcStatsReport().
void
onStop()
パブリッシャーに関連付けられたリソースを解放します。
protected void
onStreamCreated(Stream stream)
パブリッシャーのストリームが作成されたときに呼び出されます。
protected void
onStreamDestroyed(Stream stream)
パブリッシャーのストリームが破棄されたときに呼び出されます。
void
setAudioLevelListener(PublisherKit.AudioLevelListener listener)
をバインドします PublisherKit.AudioLevelListener この PublisherKit インスタンスに接続して、
オーディオレベルの更新を監視します。
void
setAudioStatsListener(PublisherKit.AudioStatsListener listener)
パブリッシャーのオーディオ統計情報のリスナーを設定します。
void
setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)
このパブリッシャーのオーディオストリームに対して、オーディオトランスフォーマーのリストを設定します。
void
setCapturer(BaseVideoCapturer newCapturer)
非推奨です。
void
setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)
帯域幅やCPUの制約に応じて、フレームレートや解像度を調整する際に、ビデオエンジンが優先して適用するポリシーを取得します。
void
setMaxVideoBitrate(int maxVideoBitrate)
パブリッシャーの動画ストリームの最大動画ビットレートを、ビット/秒単位で設定します。
void
setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener listener)
パブリッシャーのメディアリンク統計に関するリスナーを設定します。
void
setMuteListener(PublisherKit.MuteListener listener)
を PublisherKit.MuteListener モデレーターがこの配信者の音声を強制的にミュートした際に、
その配信者を監視するオブジェクト。
void
setName(String name)
非推奨です。
void
setPublishAudio(boolean publishAudio)
渡された値に基づいて、オーディオの公開をオンまたはオフに切り替えます。
void
setPublishCaptions(boolean publishCaptions)
渡された値に基づいて、キャプションの公開をオンまたはオフに切り替えます。
void
setPublisherListener(PublisherKit.PublisherListener listener)
をバインドします PublisherKit.PublisherListener この Publisher インスタンスに対して、状態の
変化を監視します。
void
setPublisherVideoType(PublisherKit.PublisherKitVideoType type)
このストリームの動画の種類を指定します。
void
setPublishVideo(boolean publishVideo)
渡された値に基づいて、動画の公開をオンまたはオフに切り替えます。
void
setRenderer(BaseVideoRenderer renderer)
非推奨です。
void
setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
RTC 統計レポートのリスナーをサブスクライバーに設定します。
void
setStyle(String key, String value)
このパブリッシャーで使用されるビデオレンダラーのスタイルを設定します。
void
setTargetScalabilityMode(String scalabilityMode)
このパブリッシャーのターゲットスケーラビリティモード(SVC - スケーラブル・ビデオ・コーディング)を設定します。
void
setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)
パブリッシャーの動画ストリームに対して、動画ビットレートのプリセット戦略を設定します。
void
setVideoListener(PublisherKit.VideoListener listener)
を PublisherKit.VideoListener パブリッシャーが動画の送信を開始
および停止したタイミングを監視するオブジェクト。
void
setVideoStatsListener(PublisherKit.VideoStatsListener listener)
パブリッシャーの動画統計情報のリスナーを設定します。
void
setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)
このパブリッシャーのビデオストリームに対して、ビデオトランスフォーマーのリストを設定します。
void
update(Observable o, Object arg)
非推奨です。
java.lang クラスから継承されたメソッド。目的
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
フィールドの詳細
VIDEO_REASON_NONE
public static final ストリング VIDEO_REASON_NONE
関連項目: : - [定数フィールド値]
VIDEO_REASON_QUALITY
public static final ストリング VIDEO_REASON_QUALITY
この動画の再生障害は、ネットワークの混雑状況の変化によって引き起こされました。
その
PublisherKit.VideoListener.onVideoDisabled(PublisherKit, String) メソッドが
呼び出されます。
状況が改善すると、ビデオストリームが再開され、
PublisherKit.VideoListener.onVideoEnabled(PublisherKit, String) メソッドが
呼び出されます。
ビデオストリームが切断された場合でも、オーディオストリームが存在すれば、加入者は引き続き そのオーディオストリームを受信し続けます。
関連項目:
: - method.
- method.
- [定数フィールド値]
VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH
public static final ストリング VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH
ネットワーク帯域幅の不足による品質の低下。
関連項目: : - [定数フィールド値]
VIDEO_REASON_QUALITY_DEGRADATION_CPU
public static final ストリング VIDEO_REASON_QUALITY_DEGRADATION_CPU
クライアント端末のCPUの性能制限に起因する品質の低下。
関連項目: : - [定数フィールド値]
VIDEO_REASON_QUALITY_DEGRADATION_OTHER
public static final ストリング VIDEO_REASON_QUALITY_DEGRADATION_OTHER
その他の理由による品質の低下。
関連項目: : - [定数フィールド値]
VIDEO_REASON_CODEC_CHANGE
public static final ストリング VIDEO_REASON_CODEC_CHANGE
ストリームのビデオコーデックが変更されました。
関連項目: : - [定数フィールド値]
VIDEO_理由_解像度_変更
public static final ストリング VIDEO_理由_解像度_変更
動画の解像度やレイヤー数の変更。 これは、ビットレートの制約、エンコーダの適応、カメラソースの変更 (例:カメラの切り替えや入力解像度の変更)、あるいは設定の変更によって発生することがあります。 必ずしも画質の低下を意味するわけではありません。
関連項目: : - [定数フィールド値]
NETWORK_REASON_NETWORK_CONDITION_CHANGE
public static final ストリング NETWORK_REASON_NETWORK_CONDITION_CHANGE
ローカル参加者のネットワーク状態が変化したことを示します。 このイベントは、ネットワーク状態に著しい変化が検出されたときに発生します。
関連項目: : - [定数フィールド値]
ハンドラー
protected android.os.Handler handler
publisherListener
protected PublisherKit.PublisherListener publisherListener
audioLevelListener
protected PublisherKit.AudioLevelListener audioLevelListener
videoStatsListener
protected PublisherKit.VideoStatsListener videoStatsListener
audioStatsListener
protected PublisherKit.AudioStatsListener audioStatsListener
mediaLinkStatsListener
protected PublisherKit.MediaLinkStatsListener mediaLinkStatsListener
muteListener
protected PublisherKit.MuteListener muteListener
rtcStatsReportListener
protected PublisherKit.PublisherRtcStatsReportListener rtcStatsReportListener
文脈
protected android.content.Context context
レンダラー
protected BaseVideoRenderer レンダラー
キャプチャ機能
protected BaseVideoCapturer キャプチャ機能
videoListener
protected PublisherKit.VideoListener videoListener
コンストラクタの詳細
PublisherKit
protected PublisherKit(PublisherKit.Builder (ビルダー)
メソッドの詳細
onPause
public void onPause()
直接電話しないでください。電話をかける場合は Session.onPause() その代わりだ。
onResume
public void onResume()
直接電話しないでください。電話をかける場合は Session.onResume() その代わりだ。
破壊する
public void destroy()
ガベージコレクタによって解放できない場合、このオブジェクトおよびそれにバインドされているすべてのハードウェアリソースとUIリソースを解放します。 通常、リソースはガベージコレクタによって安全に解放されるため、 このメソッドを呼び出す必要はありません。 ただし、これはVMの裁量によりいつでも発生する可能性があり、場合によっては望ましくない動作となることがあります。 このメソッドを使用すると、即時性が求められるシナリオにおいて、リソースを手動で解放することができます:
- あるアプリが再度公開しようとしているが、公開を取り消した直後にカメラへのアクセスが必要となっている。
- あるアプリは、公開を解除した直後にオーディオデバイスが解放されることを確実にしたいと考えています。
このメソッドを呼び出した後は、そのパブリッシャーを再利用することはできません。
setPublishVideo
public void setPublishVideo(boolean publishVideo)
渡された値に基づいて、動画の公開をオンまたはオフに切り替えます。
パラメータ:
: publishVideo - 動画を公開するかどうか(true) かどうか(
false).
setPublishAudio
public void setPublishAudio(boolean publishAudio)
渡された値に基づいて、オーディオの公開をオンまたはオフに切り替えます。
パラメータ:
: publishAudio - 音声を公開するかどうか(true) かどうか(
false).
setPublishCaptions
public void setPublishCaptions(boolean publishCaptions)
渡された値に基づいて、キャプションの公開をオンまたはオフに切り替えます。
パラメータ:
: publishCaptions - キャプションを表示するかどうか(true) かどうか(
false).
setName
@非推奨 public void setName(ストリング 名前)
非推奨です。
このストリームの名前を設定します。この名前は、
パブリッシャーの動画の下部、および公開されたストリームに関連付けられた
サブスクライバーの動画の下部に表示されます。この名前は、
パブリッシャーを初期化した後、
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
メソッドが呼び出されます。その後にプロパティを設定すると、
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
どのメソッドが呼び出されても、ストリームの表示名には影響しません。
デフォルト名は ""(空の文字列)です。
setPublisherVideoType
public void setPublisherVideoType(PublisherKit.PublisherKitVideoType (タイプ)
このストリームの動画形式を指定します。以下のいずれかの 値に設定してください:
PublisherKitVideoType.PublisherKitVideoTypeScreen— 画面共有用の動画エンコードを最適化します。この動画タイプでは、低い フレームレート(1秒あたり5フレーム以下)を使用することをお勧めします。 詳細はこちら OpenTok メディアルーターとメディアモード.PublisherKitVideoType.PublisherKitVideoTypeCamera— これはデフォルトの設定であり、カメラを 映像ソースとして使用する際にこの設定を使用してください。
getName
public ストリング getName()
ストリーム名。この名前は、サブスクライバーの動画の下部に表示されます。
戻り値: : 出版社名
getPublishVideo
public boolean getPublishVideo()
出版社が動画を公開しているかどうか(true) かどうか(
false).
getPublishAudio
public boolean getPublishAudio()
出版社がオーディオを配信しているかどうか(true) かどうか(
false).
getPublishCaptions
public boolean getPublishCaptions()
出版社がキャプションを掲載しているかどうか(true) かどうか(
false).
getSession
public セッション getSession()
次の値を返します。 Session この Publisher インスタンスにバインドされています。
戻り値:
: The Session この Publisher インスタンスにバインドされています。
関連項目:
: - Session.publish(com.opentok.android.PublisherKit)
getStream
public ストリーム getStream()
パブリッシャーのストリームに対応するストリームオブジェクトを返します。
戻り値: : ストリームオブジェクト。
getPublisherVideoType
public PublisherKit.PublisherKitVideoType getPublisherVideoType()
このパブリッシャーの動画のタイプを返します。
関連項目:
: - setPublisherVideoType(PublisherKitVideoType type)
getMaxVideoBitrate
public int getMaxVideoBitrate()
パブリッシャーの動画ストリームの最大動画ビットレート(ビット/秒)を取得します。
現在設定されている上限値を返します。手動でビットレートが設定されていない場合、 またはビットレートのプリセットが有効な場合は、値は 0 になります。
戻り値: : ビデオの最大ビットレート(ビット/秒)。設定されていない場合やプリセットを使用している場合は 0 を返します。
関連項目:
: - setMaxVideoBitrate(int maxVideoBitrate)
setMaxVideoBitrate
public void setMaxVideoBitrate(int maxVideoBitrate)
パブリッシャーの動画ストリームの最大動画ビットレートを、ビット/秒単位で設定します。
この方法では、パブリッシャーの動画ビットレートに明示的な上限を設定します。 この値を 0 に設定すると、手動で設定された上限がすべて解除され、明示的な制限のない、プリセットに基づく デフォルトの適応型ビットレート動作に戻ります。
パラメータ:
: maxVideoBitrate - 動画の最大ビットレート(ビット/秒)、
5,000~10,000,000の範囲。
関連項目:
: - getMaxVideoBitrate()
- setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
- パブリッシャー最大ビットレート
getVideoBitratePreset
public PublisherKit.VideoBitratePreset getVideoBitratePreset()
パブリッシャーのストリームについて、現在アクティブな動画ビットレートプリセットを取得します。
現在使用中のプリセット戦略を返します。カスタムビットレートが
を使用して手動で設定されている場合 setMaxVideoBitrate(int), このメソッドは以下を返します
PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
戻り値:
: アクティブな PublisherKit.VideoBitratePreset.
関連項目:
: - setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
setVideoBitratePreset
public void setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)
パブリッシャーの動画ストリームに対して、動画ビットレートのプリセット戦略を設定します。
プリセット設定では、あらかじめ定義された戦略に基づき、映像品質と帯域幅の使用量のバランスを調整します。
プリセット設定と手動のビットレート設定は、互いに排他的です。
設定は setMaxVideoBitrate(int) このメソッドは、すべてのプリセットを上書きし、
アクティブなプリセットを自動的に PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
注 PublisherKit.VideoBitratePreset.VideoBitratePresetCustom この値は直接設定することはできません。
パラメータ:
: videoBitratePreset - その PublisherKit.VideoBitratePreset 申し込むには。
関連項目:
: - getVideoBitratePreset()
- setMaxVideoBitrate(int maxVideoBitrate)
- パブリッシャー最大ビットレート
getDegradationPreference
public PublisherKit.劣化設定 getDegradationPreference()
帯域幅やCPUの制約に応じて、フレームレートや解像度を調整する際に、ビデオエンジンが優先して適用するポリシーを取得します。
詳細は PublisherKit.DegradationPreference 取り得る値の説明については、以下を参照してください。
戻り値: : 現在の劣化設定。
setDegradationPreference
public void setDegradationPreference(PublisherKit.劣化設定 degradationPreference)
帯域幅やCPUの制約に応じて、フレームレートや解像度を調整する際に、ビデオエンジンが優先して適用するポリシーを取得します。
詳細は PublisherKit.DegradationPreference 取り得る値の説明については、以下を参照してください。
パラメータ:
: degradationPreference - 分解の優先順位。
setTargetScalabilityMode
public void setTargetScalabilityMode(ストリング scalabilityMode)
このパブリッシャーのターゲットスケーラビリティモード(SVC - スケーラブル・ビデオ・コーディング)を設定します。 スケーラビリティモードは、WebRTC がエンコードする空間(解像度)および時間(フレームレート)の レイヤー数を制御します。このモードは、メディアルーターのメディアパスに適用されます。 このメソッドはいつでも呼び出すことができます。メディアパスのネゴシエーションが 完了している必要はありません。このモードは、Media Routerのメディアパスが確立されると適用されます。 Media RouterのメディアパスでSVC以外のコーデック(VP8、H.264)がネゴシエーションされた場合、最も近い適用可能な モードが使用されます。空間レイヤーは1に強制され、時間次元は維持されます (例:VP8がネゴシエーションされた場合、L2T2 → L1T2)。 これはベータ機能です。
パラメータ:
: scalabilityMode - 対象のスケーラビリティモード。
投球:
: IllegalArgumentException - 要求されたモードが有効なスケーラビリティ・モードでない場合
(つまり、L1T1、L1T2、L1T3、L2T1、L2T2、L2T3、L3T1、L3T2、L3T3のいずれでもない場合)。
getTargetScalabilityMode
public ストリング getTargetScalabilityMode()
setTargetScalabilityMode によって明示的に設定されたターゲットスケーラビリティモードを取得します。 セッターに最後に渡された値を返します。セッターが一度も呼び出されていない場合は null を返します。 これはユーザーの意図を反映したものであり、実際に適用されたモード(コーデック依存のフォールバックにより異なる場合があります) ではありません。 これはベータ機能です。
戻り値: : 呼び出し元によって設定されたターゲットスケーラビリティモード。明示的に設定されていない場合は null。
setPublisherListener
public void setPublisherListener(PublisherKit.PublisherListener リスナー)
をバインドします PublisherKit.PublisherListener この Publisher インスタンスに対して、状態の
変化を監視します。
パラメータ:
: listener - その PublisherKit.PublisherListener このインスタンスを監視するリスナー、または
リスナーの接続を切断する場合は null。
setAudioLevelListener
public void setAudioLevelListener(PublisherKit.AudioLevelListener リスナー)
をバインドします PublisherKit.AudioLevelListener この PublisherKit インスタンスに接続して、
オーディオレベルの更新を監視します。
パラメータ:
: listener - その PublisherKit.AudioLevelListener このインスタンスを監視します。
リスナーの接続を解除し、オーディオレベルの監視を停止するには、これをnullに設定してください。
setRtcStatsReportListener
public void setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener リスナー)
RTC 統計レポートのリスナーをサブスクライバーに設定します。詳細については、 getRtcStatsReport().
パラメータ:
: listener - その PublisherKit.PublisherRtcStatsReportListener オブジェクトがある。
setVideoTransformers
public void setVideoTransformers(配列リスト<PublisherKit.VideoTransformer> videoTransformers)
このパブリッシャーのビデオストリームに対して、ビデオトランスフォーマーのリストを設定します。 リストが空の場合、このメソッドを呼び出すとトランスフォーマーがリセットされます。 この配列には、ml-library が提供する Vonage ビデオトランスフォーマー、または カスタムトランスフォーマーを含めることができます( この開発者ガイド). 注: メディアトランスフォーマーは、すべてのデバイスやAndroidのバージョンでサポートされているわけではありません。 詳細はこちら 本書.
パラメータ:
: videoTransformers - ストリームに適用される順序で並べられた、ビデオトランスフォーマーのリスト。
setVideoListener
public void setVideoListener(PublisherKit.VideoListener リスナー)
を PublisherKit.VideoListener パブリッシャーが動画の送信を開始
および停止したタイミングを監視するオブジェクト。
パラメータ:
: listener - その PublisherKit.VideoListener インスタンスだ。
setAudioTransformers
public void setAudioTransformers(配列リスト<PublisherKit.AudioTransformer> audioTransformers)
このパブリッシャーのオーディオストリームに、オーディオトランスフォーマーのリストを設定します。 リストが空の場合、このメソッドを呼び出すとトランスフォーマーがリセットされます。 この配列には、ml-library が提供する Vonage オーディオトランスフォーマー、または カスタムトランスフォーマーを含めることができます( この開発者ガイド). 注: メディアトランスフォーマーは、すべてのデバイスやAndroidのバージョンでサポートされているわけではありません。 詳細はこちら 本書. .
パラメータ:
: audioTransformers - オーディオトランスフォーマーのリスト(ストリームに適用される順序で並べています)。
setStyle
public void setStyle(ストリング key, ストリング 値)
このパブリッシャーで使用されるビデオレンダラーのスタイルを設定します。
デフォルトでは、あらかじめ定義されているスタイルキーは1つだけです:
BaseVideoRenderer.STYLE_VIDEO_SCALE. この
キーに値を設定することで、動画の拡大縮小率を指定できます。以下の値が
サポートされています:
BaseVideoRenderer.STYLE_VIDEO_FILL— 動画は、 必要に応じてトリミングを行いながら、レンダラーの領域全体に拡大表示されます。BaseVideoRenderer.STYLE_VIDEO_FIT— 動画は必要に応じて縮小され、 ピラーボックス表示で動画全体が見えるようになります。このスタイルを 設定しない場合、デフォルトの設定はBaseVideoRenderer.STYLE_VIDEO_FIT.
このメソッドを呼び出すことは、以下を呼び出すことと同じです。
getRenderer().setStyle()。ただし、このクラスを継承すれば、
このメソッドをオーバーライドして、他のスタイルや動作に対応させることができます。
パラメータ:
: key - 設定するスタイル。
: value - スタイルを設定する値。
setRenderer
@非推奨 public void setRenderer(BaseVideoRenderer レンダラー)
非推奨です。
このパブリッシャーのビデオレンダラーを設定します。
このメソッドは非推奨です。代わりに、
次の PublisherKit.Builder.renderer(BaseVideoRenderer renderer) Builder を使用して PublisherKit インスタンスを作成する際の
メソッド。
getRenderer
public BaseVideoRenderer getRenderer()
このパブリッシャーのビデオレンダラーを返します。
getCapturer
public BaseVideoCapturer getCapturer()
このパブリッシャーで使用されているビデオキャプチャ機能を返します。
setCapturer
@非推奨 public void setCapturer(BaseVideoCapturer newCapturer)
非推奨です。
このパブリッシャーのビデオキャプチャ機能を設定します。
このメソッドは非推奨です。代わりに、
PublisherKit.Builder.capturer(BaseVideoCapturer capturer) ビルダーを使用して
PublisherKitインスタンスを作成する際のメソッド。
getView
public android.view.View getView()
Publisher ビデオを含む android.view.View オブジェクトを返します。
setVideoStatsListener
public void setVideoStatsListener(PublisherKit.VideoStatsListener リスナー)
パブリッシャーの動画統計情報のリスナーを設定します。このリスナーオブジェクトは、
PublisherKit.VideoStatsListener.onVideoStats(PublisherKit publisher, PublisherKit.PublisherVideoStats[] stats) メソッド、および必要に応じて
PublisherKit.VideoStatsListener.onVideoQualityChanged(PublisherKit, PublisherVideoStats, String) メソッドを使用する。
関連項目:
: - setAudioStatsListener(AudioStatsListener listener)
setAudioStatsListener
public void setAudioStatsListener(PublisherKit.AudioStatsListener リスナー)
パブリッシャーのオーディオ統計情報のリスナーを設定します。このリスナーオブジェクトは、
PublisherKit.AudioStatsListener.onAudioStats(PublisherKit publisher, PublisherKit.PublisherAudioStats[] stats) メソッド。このメソッドは定期的に呼び出され、
以下の情報を報告します:
- 失われたオーディオパケットの総数
- 送信されたオーディオパケットの総数
- 送信されたオーディオの合計バイト数
関連項目:
: - setVideoStatsListener(VideoStatsListener listener)
setMediaLinkStatsListener
public void setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener リスナー)
パブリッシャーのメディアリンク統計に関するリスナーを設定します。このリスナーオブジェクトは、
PublisherKit.MediaLinkStatsListener.onMediaLinkStats(PublisherKit, PublisherMediaLinkStats[])
そして PublisherKit.MediaLinkStatsListener.onNetworkConditionChanged(PublisherKit, PublisherMediaLinkStats, String)
メソッド。
パラメータ:
: listener - その PublisherKit.MediaLinkStatsListener インスタンス、または削除する場合はnull。
関連項目:
: - setVideoStatsListener(VideoStatsListener listener)
- setAudioStatsListener(AudioStatsListener listener)
setMuteListener
public void setMuteListener(PublisherKit.MuteListener リスナー)
を PublisherKit.MuteListener モデレーターがこの配信者の音声を強制的にミュートした際に、
その配信者を監視するオブジェクト。
パラメータ:
: listener - その PublisherKit.MuteListener インスタンスだ。
getRtcStatsReport
public void getRtcStatsReport()
パブリッシャーのRTC統計レポートを取得します。これは非同期操作です。
以下の関数を呼び出します。 setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
メソッドを定義し、次に
PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
このメソッドを呼び出す前に、method を実行してください。統計情報が利用可能になった時点で、
の PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
メソッドが呼び出されます。
こちらも参照 setAudioStatsListener(PublisherKit.AudioStatsListener listener),
setVideoStatsListener(PublisherKit.VideoStatsListener listener)そして
SubscriberKit.getRtcStatsReport().
onRtcStatsReport
protected void onRtcStatsReport(PublisherKit.PublisherRtcStats[] 統計)
パブリッシャーのRTC統計レポートが利用可能になった際に、
への呼び出しに応じて呼び出されます。 getRtcStatsReport().
PublisherKit クラスを拡張する場合は、 PublisherKit.PublisherRtcStatsReportListener インターフェースの onRtcStatsReport() メソッドを実装する代わりに、このメソッドをオーバーライドすることができます。
onStreamCreated
protected void onStreamCreated(ストリーム (ストリーム)
パブリッシャーのストリームが作成されたときに呼び出されます。
PublisherKit クラスを継承する場合は、このメソッドをオーバーライドすることで、
onStreamCreated() PublisherKit.PublisherListener
インターフェースのメソッド。
パラメータ:
: stream - 作成されたストリーム。
onStreamDestroyed
protected void onStreamDestroyed(ストリーム (ストリーム)
パブリッシャーのストリームが破棄されたときに呼び出されます。
PublisherKit クラスを継承する場合は、このメソッドをオーバーライドすることで、
onStreamDestroyed() PublisherKit.PublisherListener
インターフェースのメソッド。
パラメータ:
: stream - 破壊されるストリーム。
onError
protected void onError(OpentokError (エラー)
パブリッシャーの処理が失敗した際に呼び出されます。
PublisherKit クラスを継承する場合は、このメソッドをオーバーライドすることで、
onError() PublisherKit.PublisherListener
インターフェースのメソッド。
パラメータ:
: error - このコールバックを呼び出したエラー。
onAudioLevelUpdated
protected void onAudioLevelUpdated(float audioLevel)
パブリッシャーのオーディオレベルを報告するために、定期的に呼び出されます。
パラメータ:
: audioLevel - オーディオレベル(0~1.0)。この値を
対数スケールで調整し、ユーザーインターフェース上の視覚表示
(ボリュームメーターなど)に使用します。
onMuteForced
protected void onMuteForced()
モデレーターがこのパブリッシャーの音声を強制的にミュートにした際に表示されます。
PublisherKit クラスを継承する場合は、このメソッドをオーバーライドすることで、
onMuteForced() PublisherKit.MuteListener
インターフェースのメソッド。
更新
@非推奨 public void update(オブザーバブル o, 目的 arg)
非推奨です。
このメソッドは、監視対象のオブジェクトに変更があったたびに呼び出されます。 このクラスはObserverインターフェースを実装しているため、 セッションの一時停止や再開などのイベントを監視します。
指定者:
: update インターフェース内で Observer
パラメータ:
: o - 観測対象。
: arg - `notifyObservers` メソッドに渡される引数。
確定する
protected void finalize() throws 投げられる
ガベージコレクタが、PublisherKit オブジェクトへの参照が もう存在しないと判断した際に呼び出されます。
上書き:
: finalize 授業中 Object
投球:
: Throwable
onStop
public void onStop()
パブリッシャーに関連付けられたリソースを解放します。このメソッドを呼び出すと、パブリッシャーは
キャプチャを停止し、その後カメラを解放します。このメソッドの呼び出し後にパブリッシャーを
再利用するには、 onRestart() メソッドを使用する。
onRestart
public void onRestart()
以前に呼び出しによって解放されていたパブリッシャーリソースを、
onStop() メソッドを使用する。