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 StandardeinstellungBaseVideoRenderer.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.