java.lang.Object

com.opentok.android.PublisherKit

Alle implementierten Schnittstellen: : Observer

Direkte bekannte Unterklassen: : Publisher


public class PublisherKit extends Objekt Implementierungen Beobachter

Ein Publisher erfasst einen Audio-Video-Stream aus den von Ihnen angegebenen Quellen. Sie können den Audio-Video-Stream anschließend in eine OpenTok-Sitzung veröffentlichen, indem Sie die Session.publish(PublisherKit publisher) Methode.

Erstellen Sie eine Unterklasse von PublisherKit, wenn Sie eine eigene Implementierung für die Videoaufnahme und -wiedergabe bereitstellen möchten. Andernfalls verwenden Sie die Publisher Klasse, die einen vorgefertigten Video-Capturer und Renderer enthält.

Zusammenfassung zu verschachtelten Klassen

Verschachtelte Klassen

Modifikator und Typ

Klasse

Beschreibung

static interface

PublisherKit.AudioLevelListener

Überwacht Änderungen des Audiopegels des Publishers.

static interface

PublisherKit.AudioStatsListener

Definiert das Listener-Objekt zum Abrufen von Audio-Statistiken des Publishers.

class

PublisherKit.AudioTransformer

Ein Wandler für einen Audiostream.

static class

PublisherKit.Builder

Wird verwendet, um ein PublisherKit Objekt.

static interface

PublisherKit.CustomAudioTransformer

Definiert einen benutzerdefinierten Transformator für einen Audiostream, der an die PublisherKit.AudioTransformer Konstruktor.

static interface

PublisherKit.CustomVideoTransformer

Definiert einen benutzerdefinierten Transformator für einen Videostream, der an die PublisherKit.VideoTransformer Konstruktor.

static enum

PublisherKit.DegradationPreference

Beschreibt die Richtlinie, nach der die Video-Engine versucht, die Bildrate und die Auflösung an begrenzte Bandbreite und CPU-Leistung anzupassen.

static interface

PublisherKit.MediaLinkStatsListener

Definiert das Listener-Objekt zum Abrufen von Statistiken zu den Medienlinks des Publishers.

static interface

PublisherKit.MuteListener

Überwacht, ob ein Moderator diesen Sender dazu gezwungen hat, den Ton stummzuschalten.

static final class

PublisherKit.PreferredVideoCodecs

Legt die Codec-Einstellungen für die Veröffentlichung von Videos fest.

static class

PublisherKit.PublisherAudioStats

Definiert Audio-Statistiken für einen Publisher.

static enum

PublisherKit.PublisherKitVideoType

Legt Werte für die setPublisherVideoType(PublisherKitVideoType type) Methode.

static interface

PublisherKit.PublisherListener

Überwacht, wann ein Publisher das Streaming zur Sitzung startet und beendet.

static class

PublisherKit.PublisherMediaLinkStats

Stellt Statistiken zu den Medien-Links der Publisher bereit, einschließlich Kennzahlen zum lokalen Datenverkehr.

static class

PublisherKit.PublisherRtcStats

Stellt die RTC-Statistiken für einen vom Herausgeber veröffentlichten Medienstrom dar.

static interface

PublisherKit.PublisherRtcStatsReportListener

Definiert das Listener-Objekt zum Abrufen von RTC-Statistikberichten des Publishers.

static class

PublisherKit.PublisherVideoStats

Legt die Videostatistiken für einen Publisher fest.

static enum

PublisherKit.VideoBitratePreset

Legt Werte für die setVideoBitratePreset(VideoBitratePreset preset) Methode.

static class

PublisherKit.VideoLayerStats

Stellt die Statistiken für eine einzelne veröffentlichte Videoebene dar.

static interface

PublisherKit.VideoListener

Überwacht, wann der Publisher mit dem Empfang von Videodaten beginnt und wann er diesen beendet.

static interface

PublisherKit.VideoStatsListener

Definiert das Listener-Objekt zum Abrufen von Videostatistiken des Publishers.

class

PublisherKit.VideoTransformer

Ein Wandler für einen Videostream.

Zusammenfassung der Felddaten

Felder

Modifikator und Typ

Feld

Beschreibung

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

Zeigt an, dass sich der Netzwerkstatus des lokalen Teilnehmers geändert hat.

protected PublisherKit.PublisherListener

publisherListener

protected BaseVideoRenderer

renderer

protected PublisherKit.PublisherRtcStatsReportListener

rtcStatsReportListener

static final String

VIDEO_REASON_CODEC_CHANGE

Der Videocodec für den Stream hat sich geändert.

static final String

VIDEO_REASON_NONE

static final String

VIDEO_REASON_QUALITY

Das Videoereignis wurde durch eine Änderung des Auslastungsgrades im Netzwerk ausgelöst.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH

Qualitätsverlust aufgrund unzureichender Netzwerkbandbreite.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_CPU

Qualitätsverlust aufgrund von CPU-Einschränkungen auf dem Client-Gerät.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_OTHER

Qualitätsminderung aus anderen Gründen.

static final String

VIDEO_REASON_RESOLUTION_CHANGE

Änderung der Videoauflösung oder der Anzahl der Ebenen.

protected PublisherKit.VideoListener

videoListener

protected PublisherKit.VideoStatsListener

videoStatsListener

Zusammenfassung zum Konstruktor

Konstruktoren

Modifikator

Konstruktor

Beschreibung

protected

PublisherKit(PublisherKit.Builder builder)

Zusammenfassung der Methode

Alle MethodenInstanzmethodenKonkrete MethodenVeraltete Methoden

Modifikator und Typ

Methode

Beschreibung

void

destroy()

Gibt dieses Objekt einschließlich aller damit verknüpften Hardware- und UI-Ressourcen frei, falls es nicht vom Garbage Collector freigegeben werden kann.

protected void

finalize()

Wird vom Garbage Collector aufgerufen, wenn dieser feststellt, dass keine Verweise mehr auf das PublisherKit-Objekt vorhanden sind.

BaseVideoCapturer

getCapturer()

Gibt den von diesem Herausgeber verwendeten Video-Capturer zurück.

PublisherKit.DegradationPreference

getDegradationPreference()

Ruft die bevorzugte Richtlinie ab, nach der die Video-Engine die Bildrate und die Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst.

int

getMaxVideoBitrate()

Ruft die maximale Videobitrate für den Videostream des Publishers in Bit pro Sekunde ab.

String

getName()

Der Name des Streams.

boolean

getPublishAudio()

Unabhängig davon, ob der Verlag Audioinhalte veröffentlicht (true) oder nicht ( false).

boolean

getPublishCaptions()

Ob der Herausgeber Bildunterschriften veröffentlicht (true) oder nicht ( false).

PublisherKit.PublisherKitVideoType

getPublisherVideoType()

Gibt den Videotyp dieses Anbieters zurück.

boolean

getPublishVideo()

Unabhängig davon, ob der Herausgeber Videos veröffentlicht (true) oder nicht ( false).

BaseVideoRenderer

getRenderer()

Gibt den Video-Renderer für diesen Publisher zurück.

void

getRtcStatsReport()

Ruft den RTC-Statistikbericht für den Publisher ab.

Session

getSession()

Gibt die Session an diese Publisher-Instanz gebunden.

Stream

getStream()

Gibt das Stream-Objekt zurück, das dem Stream des Publishers entspricht.

String

getTargetScalabilityMode()

Ruft den Zielskalierbarkeitsmodus ab, der explizit über „setTargetScalabilityMode“ festgelegt wurde.

PublisherKit.VideoBitratePreset

getVideoBitratePreset()

Ruft die derzeit aktive Voreinstellung für die Videobitrate des Streams des Publishers ab.

android.view.View

getView()

Gibt das `android.view.View`-Objekt zurück, das das Publisher-Video enthält.

protected void

onAudioLevelUpdated(float audioLevel)

Wird in regelmäßigen Abständen aufgerufen, um den Audiopegel des Publishers zu melden.

protected void

onError(OpentokError error)

Wird aufgerufen, wenn der Publisher fehlschlägt.

protected void

onMuteForced()

Wird ausgelöst, wenn ein Moderator diesen Verfasser dazu gezwungen hat, den Ton stummzuschalten.

void

onPause()

Rufen Sie nicht direkt an; rufen Sie Session.onPause() stattdessen.

void

onRestart()

Startet die zuvor freigegebenen Publisher-Ressourcen neu, indem die Funktion onStop() Methode.

void

onResume()

Rufen Sie nicht direkt an; rufen Sie Session.onResume() stattdessen.

protected void

onRtcStatsReport(PublisherKit.PublisherRtcStats[] stats)

Wird aufgerufen, wenn der RTC-Statistikbericht des Herausgebers als Antwort auf einen Aufruf von getRtcStatsReport().

void

onStop()

Gibt die mit dem Herausgeber verknüpften Ressourcen frei.

protected void

onStreamCreated(Stream stream)

Wird aufgerufen, wenn der Stream des Publishers erstellt wird.

protected void

onStreamDestroyed(Stream stream)

Wird aufgerufen, wenn der Stream des Publishers zerstört wird.

void

setAudioLevelListener(PublisherKit.AudioLevelListener listener)

Bindet ein PublisherKit.AudioLevelListener an diese PublisherKit-Instanz, um Änderungen des Audiopegels zu überwachen.

void

setAudioStatsListener(PublisherKit.AudioStatsListener listener)

Richtet einen Listener für die Audio-Statistiken des Publishers ein.

void

setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)

Legt eine Liste von Audio-Transformatoren für den Audiostream dieses Publishers fest.

void

setCapturer(BaseVideoCapturer newCapturer)

Veraltet.

void

setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)

Ruft die bevorzugte Richtlinie ab, nach der die Video-Engine die Bildrate und die Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst.

void

setMaxVideoBitrate(int maxVideoBitrate)

Legt die maximale Video-Bitrate für den Videostream des Publishers in Bit pro Sekunde fest.

void

setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener listener)

Richtet einen Listener für die Statistiken zu den Medienlinks des Publishers ein.

void

setMuteListener(PublisherKit.MuteListener listener)

Legt einen PublisherKit.MuteListener Objekt, das überwacht, wann ein Moderator diesen Publisher dazu zwingt, den Ton stummzuschalten.

void

setName(String name)

Veraltet.

void

setPublishAudio(boolean publishAudio)

Schaltet die Wiedergabe von Audio je nach dem übergebenen Wert ein oder aus.

void

setPublishCaptions(boolean publishCaptions)

Schaltet die Veröffentlichung von Untertiteln je nach dem übergebenen Wert ein oder aus.

void

setPublisherListener(PublisherKit.PublisherListener listener)

Bindet ein PublisherKit.PublisherListener an diese Publisher-Instanz, um Zustandsänderungen zu überwachen.

void

setPublisherVideoType(PublisherKit.PublisherKitVideoType type)

Gibt den Videotyp für diesen Stream an.

void

setPublishVideo(boolean publishVideo)

Schaltet die Veröffentlichung des Videos je nach dem übergebenen Wert ein oder aus.

void

setRenderer(BaseVideoRenderer renderer)

Veraltet.

void

setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)

Legt den RTC-Statistikbericht-Listener als Abonnenten fest.

void

setStyle(String key, String value)

Legt einen Stil für den von diesem Publisher verwendeten Video-Renderer fest.

void

setTargetScalabilityMode(String scalabilityMode)

Legt den Ziel-Skalierbarkeitsmodus (SVC – Scalable Video Coding) für diesen Publisher fest.

void

setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)

Legt eine Strategie für die Voreinstellung der Videobitrate für den Videostream des Publishers fest.

void

setVideoListener(PublisherKit.VideoListener listener)

Legt einen PublisherKit.VideoListener Objekt, mit dem überwacht wird, wann der Publisher mit der Übertragung von Videos beginnt und diese beendet.

void

setVideoStatsListener(PublisherKit.VideoStatsListener listener)

Richtet einen Listener für die Videostatistiken des Publishers ein.

void

setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)

Legt eine Liste von Videotransformatoren für den Videostream dieses Publishers fest.

void

update(Observable o, Object arg)

Veraltet.

Von der Klasse „java.lang.“ geerbte Methoden.Objekt

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

Felddetails

VIDEO_GRUND_KEINER

public static final  Zeichenfolge VIDEO_GRUND_KEINER

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_QUALITÄT

public static final  Zeichenfolge VIDEO_GRUND_QUALITÄT

Das Videoereignis wurde durch eine Änderung des Auslastungsgrades im Netzwerk ausgelöst.

Die PublisherKit.VideoListener.onVideoDisabled(PublisherKit, String) Methode wird aufgerufen. Sobald sich die Bedingungen verbessern, wird der Videostream fortgesetzt, und die PublisherKit.VideoListener.onVideoEnabled(PublisherKit, String) Die Methode wird aufgerufen.

Wenn der Videostream unterbrochen wird, empfängt der Teilnehmer weiterhin den Audiostream, sofern ein solcher vorhanden ist.

Siehe auch: : - method. - method. - [Konstante Feldwerte]

VIDEO_GRUND_QUALITÄTSVERLUST_BANDBREITE

public static final  Zeichenfolge VIDEO_GRUND_QUALITÄTSVERLUST_BANDBREITE

Qualitätsverlust aufgrund unzureichender Netzwerkbandbreite.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_QUALITÄTSVERLUST_CPU

public static final  Zeichenfolge VIDEO_GRUND_QUALITÄTSVERLUST_CPU

Qualitätsverlust aufgrund von CPU-Einschränkungen auf dem Client-Gerät.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_QUALITÄTSVERLUST_SONSTIGES

public static final  Zeichenfolge VIDEO_GRUND_QUALITÄTSVERLUST_SONSTIGES

Qualitätsminderung aus anderen Gründen.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_CODEC-ÄNDERUNG

public static final  Zeichenfolge VIDEO_GRUND_CODEC-ÄNDERUNG

Der Videocodec für den Stream hat sich geändert.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_AUFLÖSUNG_ÄNDERUNG

public static final  Zeichenfolge VIDEO_GRUND_AUFLÖSUNG_ÄNDERUNG

Änderung der Videoauflösung oder der Anzahl der Ebenen. Dies kann aufgrund von Bitratenbeschränkungen, einer Anpassung des Encoders, Änderungen an der Kameraquelle (z. B. Kamerawechsel oder Änderung der Eingangsauflösung) oder Konfigurationsänderungen auftreten. Dies bedeutet nicht zwangsläufig eine Verschlechterung der Qualität.

Siehe auch: : - [Konstante Feldwerte]

NETZWERK_GRUND_ÄNDERUNG_DER_NETZWERKZUSTAND

public static final  Zeichenfolge NETZWERK_GRUND_ÄNDERUNG_DER_NETZWERKZUSTAND

Zeigt an, dass sich der Netzwerkstatus des lokalen Teilnehmers geändert hat. Dieses Ereignis wird ausgelöst, wenn eine wesentliche Änderung des Netzwerkstatus festgestellt wird.

Siehe auch: : - [Konstante Feldwerte]

Handler

protected android.os.Handler handler

publisherListener

geschützt  PublisherKit.PublisherListener publisherListener

audioLevelListener

geschützt  PublisherKit.AudioLevelListener audioLevelListener

videoStatsListener

geschützt  PublisherKit.VideoStatsListener videoStatsListener

audioStatsListener

geschützt  PublisherKit.AudioStatsListener audioStatsListener

mediaLinkStatsListener

geschützt  PublisherKit.MediaLinkStatsListener mediaLinkStatsListener

muteListener

geschützt  PublisherKit.MuteListener muteListener

rtcStatsReportListener

geschützt  PublisherKit.PublisherRtcStatsReportListener rtcStatsReportListener

Kontext

protected android.content.Context context

Renderer

geschützt  BaseVideoRenderer Renderer

Aufnehmer

geschützt  BaseVideoCapturer Aufnehmer

videoListener

geschützt  PublisherKit.VideoListener videoListener

Angaben zum Hersteller

PublisherKit

protected PublisherKit(PublisherKit.Builder Bauunternehmer)

Details zur Methode

onPause

public void onPause()

Rufen Sie nicht direkt an; rufen Sie Session.onPause() stattdessen.

onResume

public void onResume()

Rufen Sie nicht direkt an; rufen Sie Session.onResume() stattdessen.

zerstören

public void destroy()

Gibt dieses Objekt einschließlich aller damit verknüpften Hardware- und UI-Ressourcen frei, falls es nicht vom Garbage Collector freigegeben werden kann. Ressourcen werden in der Regel sicher vom Garbage Collector freigegeben, sodass Sie diese Methode nicht aufrufen müssen. Dies kann jedoch jederzeit nach Ermessen der VM geschehen, was in manchen Fällen möglicherweise nicht dem gewünschten Verhalten entspricht. Diese Methode ermöglicht die manuelle Freigabe von Ressourcen in Szenarien, in denen eine sofortige Freigabe gewünscht ist:

  • Eine App möchte erneut veröffentlicht werden, benötigt jedoch unmittelbar nach der Aufhebung der Veröffentlichung Zugriff auf die Kamera.
  • Eine App möchte sicherstellen, dass das Audiogerät unmittelbar nach dem Deaktivieren freigegeben wird.

Nachdem Sie diese Methode aufgerufen haben, können Sie den Publisher nicht mehr wiederverwenden.

setPublishVideo

public void setPublishVideo(boolean publishVideo)

Schaltet die Veröffentlichung des Videos je nach dem übergebenen Wert ein oder aus.

Parameter: : publishVideo - Ob das Video veröffentlicht werden soll (true) oder nicht ( false).

setPublishAudio

public void setPublishAudio(boolean publishAudio)

Schaltet die Wiedergabe von Audio je nach dem übergebenen Wert ein oder aus.

Parameter: : publishAudio - Ob Audio veröffentlicht werden soll (true) oder nicht ( false).

setPublishCaptions

public void setPublishCaptions(boolean publishCaptions)

Schaltet die Veröffentlichung von Untertiteln je nach dem übergebenen Wert ein oder aus.

Parameter: : publishCaptions - Ob Bildunterschriften veröffentlicht werden sollen (true) oder nicht ( false).

setName

@Veraltet public void setName(Zeichenfolge Name)

Veraltet.

Legen Sie den Namen für diesen Stream fest. Der Name wird am unteren Rand des Publisher-Videos sowie am unteren Rand der Abonnenten-Videos angezeigt, die mit dem veröffentlichten Stream verknüpft sind. Sie können diesen Namen nach der Initialisierung des Publishers und vor dem PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream) Methode aufgerufen wird. Das Setzen der Eigenschaft nach dem PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream) Es spielt keine Rolle, wie die Methode aufgerufen wird – dies hat keinen Einfluss auf den Namen, der für den Stream angezeigt wird.

Der Standardname lautet „“ (eine leere Zeichenkette).

setPublisherVideoType

public void setPublisherVideoType(PublisherKit.PublisherKitVideoType Typ)

Gibt den Videotyp für diesen Stream an. Setzen Sie diesen Wert auf einen der folgenden Werte:

  • PublisherKitVideoType.PublisherKitVideoTypeScreen — Optimiert die Videokodierung für die Bildschirmfreigabe. Es wird empfohlen, bei diesem Videotyp eine niedrige Bildrate (5 Bilder pro Sekunde oder weniger) zu verwenden. Siehe Der OpenTok Media Router und die Medienmodi.
  • PublisherKitVideoType.PublisherKitVideoTypeCamera — Dies ist die Standardeinstellung, die Sie verwenden sollten, wenn Sie eine Kamera als Videoquelle nutzen.

getName

öffentlich  Zeichenfolge getName()

Der Name des Streams. Der Name wird am unteren Rand der Videos der Abonnenten angezeigt.

Rückgaben: : Name des Verlags

getPublishVideo

public boolean getPublishVideo()

Unabhängig davon, ob der Herausgeber Videos veröffentlicht (true) oder nicht ( false).

getPublishAudio

public boolean getPublishAudio()

Unabhängig davon, ob der Verlag Audioinhalte veröffentlicht (true) oder nicht ( false).

getPublishCaptions

public boolean getPublishCaptions()

Ob der Herausgeber Bildunterschriften veröffentlicht (true) oder nicht ( false).

getSession

öffentlich  Sitzung getSession()

Gibt die Session an diese Publisher-Instanz gebunden.

Rückgaben: : Die Session an diese Publisher-Instanz gebunden.

Siehe auch: : - Session.publish(com.opentok.android.PublisherKit)

getStream

öffentlich  Stream getStream()

Gibt das Stream-Objekt zurück, das dem Stream des Publishers entspricht.

Rückgabewerte: : Das Stream-Objekt.

getPublisherVideoType

öffentlich  PublisherKit.PublisherKitVideoType getPublisherVideoType()

Gibt den Videotyp dieses Anbieters zurück.

Siehe auch: : - setPublisherVideoType(PublisherKitVideoType type)

getMaxVideoBitrate

public int getMaxVideoBitrate()

Ruft die maximale Videobitrate für den Videostream des Publishers in Bit pro Sekunde ab.

Gibt die aktuell konfigurierte Obergrenze zurück. Wenn keine manuelle Bitrate festgelegt wurde oder wenn eine Bitrate-Voreinstellung aktiv ist, beträgt der Wert 0.

Rückgabewerte: : Die maximale Video-Bitrate in Bit pro Sekunde oder 0, wenn nicht festgelegt oder bei Verwendung einer Voreinstellung.

Siehe auch: : - setMaxVideoBitrate(int maxVideoBitrate)

setMaxVideoBitrate

public void setMaxVideoBitrate(int maxVideoBitrate)

Legt die maximale Video-Bitrate für den Videostream des Publishers in Bit pro Sekunde fest.

Bei dieser Methode wird eine explizite Obergrenze für die Videobitrate des Publishers festgelegt. Wird der Wert auf 0 gesetzt, wird jede manuell festgelegte Obergrenze aufgehoben und es wird wieder das standardmäßige, auf Voreinstellungen basierende adaptive Bitratenverhalten ohne explizite Begrenzung verwendet.

Parameter: : maxVideoBitrate - Die maximale Video-Bitrate in Bit pro Sekunde, zwischen 5.000 und 10.000.000.

Siehe auch: : - getMaxVideoBitrate() - setVideoBitratePreset(VideoBitratePreset videoBitratePreset) - Herausgeber Maximale Bitrate

getVideoBitratePreset

öffentlich  PublisherKit.VideoBitratePreset getVideoBitratePreset()

Ruft die derzeit aktive Voreinstellung für die Videobitrate des Streams des Publishers ab.

Gibt die derzeit verwendete voreingestellte Strategie zurück. Wenn eine benutzerdefinierte Bitrate manuell festgelegt wurde mithilfe von setMaxVideoBitrate(int), diese Methode gibt Folgendes zurück PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.

Rückgabewerte: : Der aktive PublisherKit.VideoBitratePreset.

Siehe auch: : - setVideoBitratePreset(VideoBitratePreset videoBitratePreset)

setVideoBitratePreset

public void setVideoBitratePreset(PublisherKit.VideoBitratePreset (videoBitratePreset)

Legt eine Strategie für die Voreinstellung der Videobitrate für den Videostream des Publishers fest.

Voreingestellte Konfigurationen sorgen mithilfe vordefinierter Strategien für ein ausgewogenes Verhältnis zwischen Videoqualität und Bandbreitennutzung. Voreingestellte Einstellungen und manuelle Bitraten-Einstellungen schließen sich gegenseitig aus. Das Einstellen der setMaxVideoBitrate(int) Diese Methode überschreibt alle Voreinstellungen und ändert automatisch die aktive Voreinstellung auf PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.

Anmerkung: Die PublisherKit.VideoBitratePreset.VideoBitratePresetCustom Der Wert kann nicht direkt festgelegt werden.

Parameter: : videoBitratePreset - Die PublisherKit.VideoBitratePreset um sich zu bewerben.

Siehe auch: : - getVideoBitratePreset() - setMaxVideoBitrate(int maxVideoBitrate) - Herausgeber Maximale Bitrate

getDegradationPreference

öffentlich  PublisherKit.DegradationPreference getDegradationPreference()

Ruft die bevorzugte Richtlinie ab, nach der die Video-Engine die Bildrate und Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst. Siehe PublisherKit.DegradationPreference Eine Beschreibung der möglichen Werte finden Sie hier.

Rückgabewerte: : Die aktuelle Einstellung für die Degradation.

setDegradationPreference

public void setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)

Ruft die bevorzugte Richtlinie ab, nach der die Video-Engine die Bildrate und Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst. Siehe PublisherKit.DegradationPreference Eine Beschreibung der möglichen Werte finden Sie hier.

Parameter: : degradationPreference - Die Abbaubarkeit.

setTargetScalabilityMode

public void setTargetScalabilityMode(Zeichenfolge scalabilityMode)

Legt den Ziel-Skalierbarkeitsmodus (SVC – Scalable Video Coding) für diesen Publisher fest. Der Skalierbarkeitsmodus steuert die Anzahl der räumlichen (Auflösung) und zeitlichen (Bildrate) Ebenen, die WebRTC codiert. Der Modus wird auf den Medienpfad des Media Routers angewendet. Diese Methode kann jederzeit aufgerufen werden – es ist nicht erforderlich, dass die Aushandlung des Medienpfads abgeschlossen ist. Der Modus wird angewendet, sobald der Medienpfad des Media Routers eingerichtet ist. Wenn auf dem Medienpfad des Media Routers ein Nicht-SVC-Codec (VP8, H.264) ausgehandelt wird, wird der am ehesten passende Modus verwendet: Die räumlichen Ebenen werden auf 1 festgelegt, wobei die zeitliche Dimension beibehalten wird (z. B. L2T2 → L1T2, wenn VP8 ausgehandelt wird). Dies ist eine Beta-Funktion.

Parameter: : scalabilityMode - Der gewünschte Skalierbarkeitsmodus.

Würfe: : IllegalArgumentException - wenn der angeforderte Modus kein gültiger Skalierbarkeitsmodus ist (d. h. nicht zu den Modusbezeichnungen L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2, L3T3 gehört).

getTargetScalabilityMode

öffentlich  Zeichenfolge getTargetScalabilityMode()

Ruft den Zielskalierbarkeitsmodus ab, der explizit über „setTargetScalabilityMode“ festgelegt wurde. Gibt den zuletzt an den Setter übergebenen Wert zurück oder „null“, falls der Setter noch nie aufgerufen wurde. Dies spiegelt die Absicht des Benutzers wider, nicht den tatsächlich angewendeten Modus (der aufgrund eines codec-abhängigen Fallbacks abweichen kann). Dies ist eine Beta-Funktion.

Rückgabewert: : Der vom Aufrufer festgelegte Zielskalierbarkeitsmodus oder null, falls nicht explizit festgelegt.

setPublisherListener

public void setPublisherListener(PublisherKit.PublisherListener Zuhörer)

Bindet ein PublisherKit.PublisherListener an diese Publisher-Instanz, um Zustandsänderungen zu überwachen.

Parameter: : listener - Die PublisherKit.PublisherListener das diese Instanz überwacht, oder null, um die Verbindung zu einem Listener zu trennen.

setAudioLevelListener

public void setAudioLevelListener(PublisherKit.AudioLevelListener Zuhörer)

Bindet ein PublisherKit.AudioLevelListener an diese PublisherKit-Instanz, um Änderungen des Audiopegels zu überwachen.

Parameter: : listener - Die PublisherKit.AudioLevelListener das diese Instanz überwacht. Setzen Sie diesen Wert auf null, um die Verbindung zu einem Listener zu trennen und die Überwachung der Audiopegel zu beenden.

setRtcStatsReportListener

public void setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener Zuhörer)

Legt den RTC-Statistikbericht-Listener als Abonnenten fest. Siehe getRtcStatsReport().

Parameter: : listener - Die PublisherKit.PublisherRtcStatsReportListener Objekt.

setVideoTransformers

public void setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)

Legt eine Liste von Videotransformatoren für den Videostream dieses Publishers fest. Ist die Liste leer, werden durch den Aufruf dieser Methode die Transformatoren zurückgesetzt. Das Array kann aus Vonage-Videotransformatoren bestehen, die von der ml-Bibliothek bereitgestellt werden, oder aus benutzerdefinierten Transformatoren (siehe dieses Entwicklerhandbuch). Anmerkung: Medientransformatoren werden nicht auf allen Geräten oder Android-Versionen unterstützt. Siehe diese Dokumentation.

Parameter: : videoTransformers - Die Liste der Videotransformatoren in der Reihenfolge, in der sie auf den Stream angewendet werden sollen.

setVideoListener

public void setVideoListener(PublisherKit.VideoListener Zuhörer)

Legt einen PublisherKit.VideoListener Objekt, mit dem überwacht wird, wann der Publisher mit der Übertragung von Videos beginnt und diese beendet.

Parameter: : listener - Die PublisherKit.VideoListener Instanz.

setAudioTransformers

public void setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)

Legt eine Liste von Audio-Transformatoren für den Audiostream dieses Publishers fest. Ist die Liste leer, werden durch den Aufruf dieser Methode die Transformatoren zurückgesetzt. Das Array kann aus Vonage-Audio-Transformatoren bestehen, die von der ml-Library bereitgestellt werden, oder aus benutzerdefinierten Transformatoren (siehe dieses Entwicklerhandbuch). Anmerkung: Medientransformatoren werden nicht auf allen Geräten oder Android-Versionen unterstützt. Siehe diese Dokumentation. .

Parameter: : audioTransformers - Die Liste der Audio-Transformatoren in der Reihenfolge, in der sie auf den Stream angewendet werden sollen.

setStyle

public void setStyle(Zeichenfolge Schlüssel, Zeichenfolge Wert)

Legt einen Stil für den von diesem Publisher verwendeten Video-Renderer fest.

Standardmäßig gibt es nur einen vordefinierten Stilschlüssel: BaseVideoRenderer.STYLE_VIDEO_SCALE. Sie können für diesen Schlüssel einen Wert festlegen, um die Skalierung des Videos zu bestimmen. Die folgenden Werte werden unterstützt:

  • BaseVideoRenderer.STYLE_VIDEO_FILL — Das Video wird so skaliert, dass es den gesamten Bereich des Renderers ausfüllt, wobei es bei Bedarf beschnitten wird.
  • BaseVideoRenderer.STYLE_VIDEO_FIT — Das Video wird bei Bedarf so verkleinert, dass das gesamte Video mit Pillarboxing sichtbar ist. Wenn Sie diesen Stil nicht festlegen, lautet die Standardeinstellung BaseVideoRenderer.STYLE_VIDEO_FIT.

Der Aufruf dieser Methode entspricht dem Aufruf von getRenderer().setStyle(). Wenn Sie diese Klasse jedoch erweitern, können Sie diese Methode überschreiben, um andere Stile und Verhaltensweisen zu unterstützen.

Parameter: : key - Der festzulegende Stil. : value - Der Wert, auf den Sie den Stil festlegen.

setRenderer

@Veraltet public void setRenderer(BaseVideoRenderer Renderer)

Veraltet.

Legt den Video-Renderer für diesen Publisher fest.

Diese Methode ist veraltet. Rufen Sie stattdessen die PublisherKit.Builder.renderer(BaseVideoRenderer renderer) Methode, wenn die PublisherKit-Instanz mithilfe des Builders erstellt wird.

getRenderer

öffentlich  BaseVideoRenderer getRenderer()

Gibt den Video-Renderer für diesen Publisher zurück.

getCapturer

öffentlich  BaseVideoCapturer getCapturer()

Gibt den von diesem Herausgeber verwendeten Video-Capturer zurück.

setCapturer

@Veraltet public void setCapturer(BaseVideoCapturer newCapturer)

Veraltet.

Legt den Video-Capturer für diesen Publisher fest.

Diese Methode ist veraltet. Rufen Sie stattdessen die PublisherKit.Builder.capturer(BaseVideoCapturer capturer) Methode bei der Verwendung des Builders zum Erstellen der PublisherKit-Instanz.

getView

public android.view.View getView()

Gibt das `android.view.View`-Objekt zurück, das das Publisher-Video enthält.

setVideoStatsListener

public void setVideoStatsListener(PublisherKit.VideoStatsListener Zuhörer)

Richtet einen Listener für die Videostatistiken des Publishers ein. Das Listener-Objekt implementiert die PublisherKit.VideoStatsListener.onVideoStats(PublisherKit publisher, PublisherKit.PublisherVideoStats[] stats) Methode und optional die PublisherKit.VideoStatsListener.onVideoQualityChanged(PublisherKit, PublisherVideoStats, String) Methode.

Siehe auch: : - setAudioStatsListener(AudioStatsListener listener)

setAudioStatsListener

public void setAudioStatsListener(PublisherKit.AudioStatsListener Zuhörer)

Richtet einen Listener für die Audio-Statistiken des Publishers ein. Das Listener-Objekt implementiert die PublisherKit.AudioStatsListener.onAudioStats(PublisherKit publisher, PublisherKit.PublisherAudioStats[] stats) Methode. Diese Methode wird in regelmäßigen Abständen aufgerufen, um Folgendes zu melden:

  • Gesamtzahl der verlorenen Audiopakete
  • Gesamtzahl der gesendeten Audiopakete
  • Gesamtzahl der gesendeten Audio-Bytes

Siehe auch: : - setVideoStatsListener(VideoStatsListener listener)

setMediaLinkStatsListener

public void setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener Zuhörer)

Richtet einen Listener für die Statistiken zu den Medienlinks des Publishers ein. Das Listener-Objekt implementiert die PublisherKit.MediaLinkStatsListener.onMediaLinkStats(PublisherKit, PublisherMediaLinkStats[]) und PublisherKit.MediaLinkStatsListener.onNetworkConditionChanged(PublisherKit, PublisherMediaLinkStats, String) Methoden.

Parameter: : listener - Die PublisherKit.MediaLinkStatsListener Instanz oder „null“, um sie zu entfernen.

Siehe auch: : - setVideoStatsListener(VideoStatsListener listener) - setAudioStatsListener(AudioStatsListener listener)

setMuteListener

public void setMuteListener(PublisherKit.MuteListener Zuhörer)

Legt einen PublisherKit.MuteListener Objekt, das überwacht, wann ein Moderator diesen Publisher dazu zwingt, den Ton stummzuschalten.

Parameter: : listener - Die PublisherKit.MuteListener Instanz.

getRtcStatsReport

public void getRtcStatsReport()

Ruft den RTC-Statistikbericht für den Publisher ab. Dies ist ein asynchroner Vorgang. Rufen Sie die setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener) Methode und implementieren Sie anschließend die PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats) Methode, bevor diese Methode aufgerufen wird. Sobald die Statistiken verfügbar sind, erfolgt die Implementierung der PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats) Die Methode wird aufgerufen.

Siehe auch setAudioStatsListener(PublisherKit.AudioStatsListener listener), setVideoStatsListener(PublisherKit.VideoStatsListener listener)und SubscriberKit.getRtcStatsReport().

onRtcStatsReport

protected void onRtcStatsReport(PublisherKit.PublisherRtcStats[] Statistiken)

Wird aufgerufen, wenn der RTC-Statistikbericht des Herausgebers als Antwort auf einen Aufruf von getRtcStatsReport().

Wenn Sie die Klasse „PublisherKit“ erweitern, können Sie diese Methode überschreiben, anstatt die Methode „onRtcStatsReport()“ der Schnittstelle „PublisherKit.PublisherRtcStatsReportListener“ zu implementieren.

Siehe auch: : - PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherRtcStats[] stats)

onStreamCreated

protected void onStreamCreated(Stream Stream)

Wird aufgerufen, wenn der Stream des Publishers erstellt wird.

Wenn Sie die Klasse „PublisherKit“ erweitern, können Sie diese Methode anstelle der onStreamCreated() Methode der Schnittstelle „PublisherKit.PublisherListener“ .

Parameter: : stream - Der dadurch erzeugte Stream.

onStreamDestroyed

protected void onStreamDestroyed(Stream Stream)

Wird aufgerufen, wenn der Stream des Publishers zerstört wird.

Wenn Sie die Klasse „PublisherKit“ erweitern, können Sie diese Methode anstelle der onStreamDestroyed() Methode der Schnittstelle „PublisherKit.PublisherListener“ .

Parameter: : stream - Der Stream, der zerstört wird.

onError

protected void onError(Opentok-Fehler Fehler)

Wird aufgerufen, wenn der Publisher fehlschlägt.

Wenn Sie die Klasse „PublisherKit“ erweitern, können Sie diese Methode anstelle der onError() Methode der Schnittstelle „PublisherKit.PublisherListener“ .

Parameter: : error - Der Fehler, der diesen Callback ausgelöst hat.

onAudioLevelUpdated

protected void onAudioLevelUpdated(float audioLevel)

Wird in regelmäßigen Abständen aufgerufen, um den Audiopegel des Publishers zu melden.

Parameter: : audioLevel - Der Audiopegel, von 0 bis 1,0. Passen Sie diesen Wert logarithmisch an, um ihn in einer Visualisierung der Benutzeroberfläche (z. B. einem Lautstärkemesser) zu verwenden.

onMuteForced

protected void onMuteForced()

Wird ausgelöst, wenn ein Moderator diesen Verfasser dazu gezwungen hat, den Ton stummzuschalten.

Wenn Sie die Klasse „PublisherKit“ erweitern, können Sie diese Methode anstelle der onMuteForced() Methode der Schnittstelle „PublisherKit.MuteListener“ .

Update

@Veraltet public void update(Beobachtbar o, Objekt arg)

Veraltet.

Diese Methode wird immer dann aufgerufen, wenn sich das beobachtete Objekt ändert. Diese Klasse implementiert die Observer-Schnittstelle und beobachtet daher Ereignisse, wie beispielsweise das Anhalten und die Fortsetzung einer Sitzung.

Festgelegt durch: : update in der Benutzeroberfläche  Observer

Parameter: : o - Das zu beobachtende Objekt. : arg - Ein Argument, das an die Methode `notifyObservers` übergeben wird.

abschließen

protected void finalize() throws Wurfgegenstand

Wird vom Garbage Collector aufgerufen, wenn dieser feststellt, dass keine Verweise mehr auf das PublisherKit-Objekt vorhanden sind.

Überschreibungen: : finalize im Unterricht  Object

Würfe: : Throwable

onStop

public void onStop()

Gibt die an den Publisher gebundenen Ressourcen frei. Der Aufruf dieser Methode bewirkt, dass der Publisher die Erfassung beendet und anschließend die Kamera freigibt. Um den Publisher nach dem Aufruf dieser Methode wiederverwenden zu können, rufen Sie die onRestart() Methode.

onRestart

public void onRestart()

Startet die zuvor freigegebenen Publisher-Ressourcen neu, indem die Funktion onStop() Methode.