SubscriberKit

java.lang.Object

com.opentok.android.SubscriberKit

Alle implementierten Schnittstellen: : Observer

Direkte bekannte Unterklassen: : Subscriber

public class SubscriberKit extends Objekt Implementierungen Beobachter

Ein „SubscriberKit“-Objekt (Subscriber) rendert an einen Stream gebundene Mediendaten. Die Klasse „SubscriberKit“ ermöglicht es Ihnen, einen benutzerdefinierten Video-Renderer für den Videostream festzulegen. Erstellen Sie eine Unterklasse von „SubscriberKit“, wenn Sie Ihre eigene Implementierung für die Videoverarbeitung und das Rendering bereitstellen möchten. Andernfalls verwenden Sie die Subscriber Klasse, die einen vorgefertigten Videoprozessor und Renderer enthält.

Die Eigenschaft „stream“ verweist auf den Stream, den Sie abonniert haben. Die Klasse „SubscriberKit“ enthält Methoden, mit denen Sie die lokale Audio- und Videowiedergabe für den abonnierten Stream deaktivieren und aktivieren können.

Zusammenfassung zu verschachtelten Klassen

Verschachtelte Klassen

Modifikator und Typ

Klasse

Beschreibung

static interface

SubscriberKit.AudioLevelListener

Überwacht Änderungen des Audiopegels des Teilnehmers.

static interface

SubscriberKit.AudioStatsListener

Definiert das Listener-Objekt zum Abrufen von Audio-Statistiken der Abonnenten.

static class

SubscriberKit.Builder

Wird verwendet, um ein SubscriberKit Objekt.

static interface

SubscriberKit.CaptionsListener

Ein Listener für aktualisierten Untertiteltext.

static interface

SubscriberKit.MediaLinkStatsListener

Definiert das Listener-Objekt zum Abrufen von Statistiken zu den Medien-Links der Abonnenten, einschließlich Metriken auf Transportebene und Änderungen des Netzwerkzustands.

static class

SubscriberKit.SenderStats

Stellt von der Senderseite gemeldete Videostatistiken dar, wie beispielsweise Schätzungen der Bitrate.

static interface

SubscriberKit.StreamListener

Überwacht, wann der Stream des Teilnehmers unterbrochen wird und wieder aufgenommen wird.

static class

SubscriberKit.SubscriberAudioStats

Legt die Audio-Statistiken für einen Teilnehmer fest.

static interface

SubscriberKit.SubscriberListener

Überwacht Zustandsänderungen eines SubscriberKit Instanz.

static class

SubscriberKit.SubscriberMediaLinkStats

Liefert Statistiken zu den Medienverbindungen der Teilnehmer, einschließlich lokaler und entfernter Transportkennzahlen sowie Informationen zu Netzwerkbeeinträchtigungen.

static interface

SubscriberKit.SubscriberRtcStatsReportListener

Definiert das Listener-Objekt zum Abrufen von RTC-Statistikberichten der Abonnenten.

static class

SubscriberKit.SubscriberVideoStats

Legt die Videostatistiken für einen Abonnenten fest.

static interface

SubscriberKit.VideoListener

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

static interface

SubscriberKit.VideoStatsListener

Definiert das Listener-Objekt zum Abrufen von Videostatistiken der Abonnenten.

Zusammenfassung der Felddaten

Felder

Modifikator und Typ

Feld

Beschreibung

protected SubscriberKit.AudioLevelListener

audioLevelListener

protected SubscriberKit.AudioStatsListener

audioStatsListener

protected SubscriberKit.CaptionsListener

captionsListener

protected SubscriberKit.MediaLinkStatsListener

mediaLinkStatsListener

static final String

NETWORK_REASON_NETWORK_CONDITION_CHANGE

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

static final float

NO_PREFERRED_FRAMERATE

Definiert einen Rücksetzwert, der an die setPreferredFrameRate(float preferredFrameRate) Methode.

static final VideoUtils.Size

NO_PREFERRED_RESOLUTION

Definiert einen Rücksetzwert, der an die setPreferredResolution(VideoUtils.Size preferredResolution) Methode.

protected BaseVideoRenderer

renderer

protected SubscriberKit.SubscriberRtcStatsReportListener

rtcStatsReportListener

protected Session

session

protected Stream

stream

protected SubscriberKit.StreamListener

streamListener

protected SubscriberKit.SubscriberListener

subscriberListener

static final String

VIDEO_REASON_CODEC_CHANGE

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

static final String

VIDEO_REASON_CODEC_NOT_SUPPORTED

Der Videofehler trat auf, als das Video im Abonnentenstrom deaktiviert wurde, da der Stream einen Videocodec (z. B. H.264) verwendet, der auf dem Gerät nicht unterstützt wird.

static final String

VIDEO_REASON_INTERRUPTION

Der Videostream wurde unterbrochen.

static final String

VIDEO_REASON_NONE

static final String

VIDEO_REASON_PUBLISH_VIDEO

Das Videoereignis wurde dadurch ausgelöst, dass der Anbieter des Streams den Videostream gestartet oder gestoppt hat.

static final String

VIDEO_REASON_QUALITY

Das Problem mit dem Video wurde durch eine Änderung der Qualität des Videostreams verursacht.

static final String

VIDEO_REASON_RESOLUTION_CHANGE

Die Auflösung des Streams hat sich geändert.

static final String

VIDEO_REASON_SUBSCRIBE_TO_VIDEO

Das Video-Ereignis wurde durch einen Aufruf der Funktion setSubscribeToVideo(boolean subscribeToVideo) Methode.

protected SubscriberKit.VideoListener

videoListener

protected SubscriberKit.VideoStatsListener

videoStatsListener

Zusammenfassung zum Konstruktor

Konstruktoren

Modifikator

Konstruktor

Beschreibung

protected

SubscriberKit(SubscriberKit.Builder builder)

Zusammenfassung der Methode

Alle MethodenInstanzmethodenKonkrete MethodenVeraltete Methoden

Modifikator und Typ

Methode

Beschreibung

protected void

attachToSession(Session session)

void

destroy()

Veraltet.

protected void

detachFromSession(Session session)

protected void

finalize()

Wird vom Garbage Collector für ein „SubscriberKit“-Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind.

double

getAudioVolume()

Gibt die Lautstärke des Teilnehmers als Wert zwischen 0 und 100 zurück.

String

getCaptionsTranslationLanguage()

Ruft die für diesen Abonnenten konfigurierte Sprache für die Übersetzung der Bildunterschriften ab.

float

getPreferredFrameRate()

Gibt die bevorzugte Bildrate für den Stream des Abonnenten zurück.

VideoUtils.Size

getPreferredResolution()

Gibt die bevorzugte Auflösung für den Stream des Abonnenten zurück.

BaseVideoRenderer

getRenderer()

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

void

getRtcStatsReport()

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

Session

getSession()

Gibt die Session dass der Teilnehmer dazu verpflichtet ist (durch Anruf bei der connect() Methode des Session-Objekts).

Stream

getStream()

Gibt die Stream an die diese Instanz gebunden ist.

boolean

getSubscribeToAudio()

Ob der Abonnent Audio abonniert oder nicht.

boolean

getSubscribeToCaptions()

Ob der Abonnent Untertitel abonniert hat oder nicht.

boolean

getSubscribeToVideo()

Ob der Abonnent Audio abonniert oder nicht.

android.view.View

getView()

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

protected void

onAudioDisabled()

Wird aufgerufen, wenn der Audio-Stream des Teilnehmers deaktiviert wurde

protected void

onAudioEnabled()

Wird aufgerufen, wenn der Stream des Teilnehmers die Audiofunktion aktiviert hat.

protected void

onAudioLevelUpdated(float audioLevel)

protected void

onCaptionText(String text, boolean isFinal)

protected void

onConnected()

Wird aufgerufen, wenn die Instanz erfolgreich eine Verbindung zum Stream hergestellt hat und mit der Wiedergabe von Medien beginnt.

protected void

onDisconnected()

Veraltet.

protected void

onError(OpentokError error)

Wird aufgerufen, wenn ein Teilnehmer keine Verbindung zum OpenTok-Server herstellen konnte.

void

onPause()

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

void

onResume()

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

protected void

onRtcStatsReport(String jsonArrayOfReports)

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

protected void

onStreamDisconnected()

Wird aufgerufen, wenn der Stream des Teilnehmers unterbrochen wurde.

protected void

onStreamReconnected()

Wird aufgerufen, wenn der Stream des Teilnehmers wieder aufgenommen wurde, nachdem die onStreamDisconnected() Methode aufgerufen wird.

protected void

onVideoDataReceived()

Wird aufgerufen, wenn ein Abonnent zum ersten Mal Videodaten empfängt.

protected void

onVideoDisabled(String reason)

Wird aufgerufen, wenn der Teilnehmer kein Video mehr empfängt.

protected void

onVideoDisableWarning()

Wird aufgerufen, wenn der OpenTok Media Router feststellt, dass sich die Stream-Qualität verschlechtert hat und das Video deaktiviert wird, sollte sich die Qualität weiter verschlechtern.

protected void

onVideoDisableWarningLifted()

Wird aufgerufen, wenn der OpenTok Media Router feststellt, dass sich die Stream-Qualität so weit verbessert hat, dass das Deaktivieren des Videos kein unmittelbares Risiko mehr darstellt.

protected void

onVideoEnabled(String reason)

Wird aufgerufen, wenn der Videostream des Teilnehmers startet (wenn zuvor kein Video vorhanden war) oder fortgesetzt wird (nachdem das Video deaktiviert wurde).

void

setAudioLevelListener(SubscriberKit.AudioLevelListener listener)

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

void

setAudioStatsListener(SubscriberKit.AudioStatsListener listener)

Richtet einen Listener für die Audio-Statistiken der Abonnenten ein.

void

setAudioVolume(double volume)

Stellt die Lautstärke des Teilnehmers auf einen Wert zwischen 0 und 100 ein.

void

setCaptionsListener(SubscriberKit.CaptionsListener listener)

Bindet ein SubscriberKit.CaptionsListener zu dieser SubscriberKit-Instanz, um Untertitel zu erhalten.

void

setCaptionsTranslationLanguage(String language)

Legt die bevorzugte Sprache für die Übersetzung der Untertitel für diesen Abonnenten fest.

void

setMediaLinkStatsListener(SubscriberKit.MediaLinkStatsListener listener)

Richtet einen Listener für die Statistiken zu den Medienlinks der Abonnenten ein.

void

setPreferredFrameRate(float preferredFrameRate)

Legt die bevorzugte Bildrate für den Stream des Teilnehmers fest.

void

setPreferredResolution(VideoUtils.Size preferredResolution)

Legt die bevorzugte Auflösung für den Stream des Abonnenten fest.

void

setRenderer(BaseVideoRenderer renderer)

Veraltet.

void

setRtcStatsReportListener(SubscriberKit.SubscriberRtcStatsReportListener listener)

Legt den RTC-Statistikbericht-Listener für den Abonnenten fest.

void

setStreamListener(SubscriberKit.StreamListener listener)

Richtet einen Listener für Ereignisse ein, die mit der Unterbrechung und der Wiederaufnahme des Streams des Abonnenten zusammenhängen.

void

setStyle(String key, String value)

Lege einen Stil fest, der von diesem Abonnenten verwendet wird.

void

setSubscriberListener(SubscriberKit.SubscriberListener listener)

Legt einen SubscriberKit.SubscriberListener Objekt zur Überwachung von Zustandsänderungen.

void

setSubscribeToAudio(boolean subscribeToAudio)

Ob man den Audio-Stream abonnieren möchte (true) oder nicht (false).

void

setSubscribeToCaptions(boolean subscribeToCaptions)

Ob man die Untertitel des Streams abonnieren möchte (true) oder nicht (false)..

void

setSubscribeToVideo(boolean subscribeToVideo)

Ob man den Kanal abonnieren soll (true) oder nicht (false).

void

setVideoListener(SubscriberKit.VideoListener listener)

Legt einen SubscriberKit.VideoListener Objekt zur Überwachung, wann der Abonnent mit dem Empfang von Videodaten beginnt und diesen beendet.

void

setVideoStatsListener(SubscriberKit.VideoStatsListener listener)

Richtet einen Listener für die Videostatistiken der Abonnenten ein.

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_FÜR_DIE_VERÖFFENTLICHUNG_DES_VIDEOS

public static final Zeichenfolge VIDEO_GRUND_FÜR_DIE_VERÖFFENTLICHUNG_DES_VIDEOS

Das Videoereignis wurde dadurch ausgelöst, dass der Stream-Anbieter den Videostream gestartet oder gestoppt hat. Diese Zeichenfolge ist ein Wert für die Eigenschaft „reason“ des

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

VIDEO_GRUND_VIDEO_ABONNIEREN

public static final Zeichenfolge VIDEO_GRUND_VIDEO_ABONNIEREN

Das Video-Ereignis wurde durch einen Aufruf der Funktion setSubscribeToVideo(boolean subscribeToVideo) Methode.

Siehe auch: : - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit, String) - SubscriberKit.VideoListener.onVideoEnabled(SubscriberKit, String) - [Konstante Feldwerte]

VIDEO_GRUND_QUALITÄT

public static final Zeichenfolge VIDEO_GRUND_QUALITÄT

Die Störung beim Videostream wurde durch eine Änderung der Streamqualität verursacht. Die Streamqualität kann sich aufgrund der Netzwerkbedingungen oder der CPU-Auslastung sowohl auf Seiten des Abonnenten als auch des Anbieters ändern.

Wenn diese Funktion aktiviert ist, löst das Audio-Fallback-Feature ein Ereignis aus, sobald der Abonnent den Videostream aufgrund einer verschlechterten Videoqualität unterbricht, was dazu führt, dass SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit, String) Methode, die aufgerufen wird. Sobald sich die Bedingungen verbessern, wird der Videostream fortgesetzt, und die SubscriberKit.VideoListener.onVideoEnabled(SubscriberKit, String) Die Methode wird aufgerufen.

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

Bei gerouteten Sitzungen kann die Quelle dieses Ereignisses der Vonage Video Media Router (Subscriber Audio Fallback) oder der veröffentlichende Client (Publisher Audio Fallback) sein. Wenn die Quelle der veröffentlichende Client ist, folgt auf das Ereignis ein Session.StreamPropertiesListener.onStreamHasVideoChanged(Session, Stream, boolean) Vom Session-Objekt ausgelöster Callback, der anzeigt, dass der abonnierte Videokanal nicht mehr aktiv ist. Im Allgemeinen deutet dieses zusätzliche Ereignis auf eine Verschlechterung der Netzwerkqualität auf Seiten des Publishers hin; allerdings können vom Abonnenten gemeldete Metriken die Fallback-Entscheidungen des Publishers beeinflussen, was die Ermittlung der genauen Ursache der Verschlechterung erschweren kann.

In weitergeleiteten Sitzungen wird das Ereignis „quality“ ausschließlich aufgrund der internen Audio-Fallback-Logik des Publishers (Publisher Audio Fallback). Auf dieses Ereignis folgt kein Callback, das darauf hinweist, dass das Video inaktiv ist, da der Stream möglicherweise weiterhin von anderen Abonnenten mit besseren Netzwerkbedingungen empfangen wird. Beachten Sie, dass in weitergeleiteten Sitzungen Audio-Fallback-Ereignisse zwar vom Publisher ausgehen, eine Verschlechterung der Netzwerkqualität jedoch sowohl auf der Publisher- als auch auf der Abonnentenseite auftreten kann.

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

VIDEO_GRUND_CODEC_WIRD_NICHT_UNTERSTÜTZT

public static final Zeichenfolge VIDEO_GRUND_CODEC_WIRD_NICHT_UNTERSTÜTZT

Der Videofehler trat auf, als das Video im Abonnentenstrom deaktiviert wurde, da der Stream einen Videocodec (z. B. H.264) verwendet, der auf dem Gerät nicht unterstützt wird.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_UNTERBRECHUNG

public static final Zeichenfolge VIDEO_GRUND_UNTERBRECHUNG

Der Videostream wurde unterbrochen.

Siehe auch: : - [Konstante Feldwerte]

VIDEO_GRUND_AUFLÖSUNG_ÄNDERUNG

public static final Zeichenfolge VIDEO_GRUND_AUFLÖSUNG_ÄNDERUNG

Die Auflösung des Streams hat sich geändert.

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]

NETZWERK_GRUND_ÄNDERUNG_DER_NETZWERKZUSTAND

public static final Zeichenfolge NETZWERK_GRUND_ÄNDERUNG_DER_NETZWERKZUSTAND

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

Siehe auch: : - [Konstante Feldwerte]

NO_PREFERRED_RESOLUTION

public static final VideoUtils.Size NO_PREFERRED_RESOLUTION

Definiert einen Rücksetzwert, der an die setPreferredResolution(VideoUtils.Size preferredResolution) Methode. Übergeben Sie diesen Wert, um den Abonnenten so zurückzusetzen, dass er keine bevorzugte Auflösung mehr hat. Der Abonnent verwendet dann je nach den Bedingungen die maximal verfügbare Auflösung.

Dies gilt nur für Streams, die mithilfe der Funktion „Scalable Video“ veröffentlicht wurden.

NO_PREFERRED_FRAMERATE

public static final float NO_PREFERRED_FRAMERATE

Definiert einen Rücksetzwert, der an die setPreferredFrameRate(float preferredFrameRate) Methode. Übergeben Sie diesen Wert, um den Abonnenten so zurückzusetzen, dass er keine bevorzugte Bildrate mehr hat. Der Abonnent verwendet dann je nach den jeweiligen Bedingungen die maximal verfügbare Bildrate.

Dies gilt nur für Streams, die mithilfe der Funktion „Scalable Video“ veröffentlicht wurden.

Siehe auch: : - [Konstante Feldwerte]

Sitzung

geschützt Sitzung Sitzung

Renderer

geschützt BaseVideoRenderer Renderer

Strom

geschützt Stream Stream

Angaben zum Hersteller

SubscriberKit

protected SubscriberKit(SubscriberKit.Builder Bauunternehmer)

Details zur Methode

zerstören

@Veraltet public void destroy()

Veraltet.

Das manuelle Löschen des Objekts ist nicht sicher. Ab Version 2.17.0 hat diese Methode keine Wirkung mehr. Die Ressourcen werden automatisch vom Garbage Collector freigegeben.

setSubscriberListener

public void setSubscriberListener(SubscriberKit.SubscriberListener Zuhörer)

Legt einen SubscriberKit.SubscriberListener Objekt zur Überwachung von Zustandsänderungen.

Parameter: : listener - Die SubscriberKit.SubscriberListener das diese SubscriberKit-Instanz überwacht.

setVideoListener

public void setVideoListener(SubscriberKit.VideoListener Zuhörer)

Legt einen SubscriberKit.VideoListener Objekt zur Überwachung, wann der Abonnent mit dem Empfang von Videodaten beginnt und diesen beendet.

Parameter: : listener - Die SubscriberKit.VideoListener Instanz.

setAudioLevelListener

public void setAudioLevelListener(SubscriberKit.AudioLevelListener Zuhörer)

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

Parameter: : listener - Die SubscriberKit.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.

setCaptionsListener

public void setCaptionsListener(SubscriberKit.CaptionsListener Zuhörer)

Bindet ein SubscriberKit.CaptionsListener zu dieser SubscriberKit-Instanz, um Untertitel zu erhalten.

Parameter: : listener - Die SubscriberKit.CaptionsListener das diese Instanz überwacht. Setzen Sie diesen Wert auf null, um die Verbindung zu einem Listener zu trennen und den Empfang von Untertiteln zu beenden.

setAudioVolume

public void setAudioVolume(double volume)

Stellt die Lautstärke des Teilnehmers auf einen Wert zwischen 0 und 100 ein. Liegt der Wert außerhalb dieses Bereichs, wird er auf einen Wert innerhalb dieses Bereichs begrenzt.

Parameter: : volume - Die Lautstärke des Teilnehmers.

getAudioVolume

public double getAudioVolume()

Gibt die Lautstärke des Teilnehmers als Wert zwischen 0 und 100 zurück.

Der Standardwert beträgt 100.

setStreamListener

public void setStreamListener(SubscriberKit.StreamListener Zuhörer)

Richtet einen Listener für Ereignisse ein, die mit der Unterbrechung und der Wiederaufnahme des Streams des Abonnenten zusammenhängen.

getSession

öffentlich Sitzung getSession()

Gibt die Session dass der Teilnehmer dazu verpflichtet ist (durch Anruf bei der connect() Methode des Session-Objekts).

Rückgaben: : Die Session an die der Teilnehmer gebunden ist.

getStream

öffentlich Stream getStream()

Gibt die Stream an die diese Instanz gebunden ist. Alle Medienkanäle des Streams sollten für die Anzeige bzw. Wiedergabe mit dieser Instanz verfügbar sein.

Rückgaben: : Die Stream an die diese Instanz gebunden ist.

getSubscribeToAudio

public boolean getSubscribeToAudio()

Ob der Abonnent Audio abonniert oder nicht.

Rückgabewert: : „true“, wenn der Abonnent Audio abonniert; „false“, wenn dies nicht der Fall ist.

getSubscribeToVideo

public boolean getSubscribeToVideo()

Ob der Abonnent Audio abonniert oder nicht.

Rückgabewert: : „true“, wenn der Abonnent Audio abonniert; „false“, wenn dies nicht der Fall ist.

getSubscribeToCaptions

public boolean getSubscribeToCaptions()

Ob der Abonnent Untertitel abonniert hat oder nicht.

Rückgabewert: : „true“, wenn der Abonnent Untertitel abonniert; „false“, wenn nicht. Der Standardwert entspricht dem Wert für Untertitel des jeweiligen Herausgebers. PublisherKit.setPublishCaptions(boolean).

setSubscribeToAudio

public void setSubscribeToAudio(boolean subscribeToAudio)

Ob man den Audio-Stream abonnieren möchte (true) oder nicht (false). Das Festlegen dieser Eigenschaft hat keine Auswirkung, wenn die hasAudio Methode des Stream-Objekts gibt zurück false.

Parameter: : subscribeToAudio - Ob der Ton des Streams abonniert werden soll (true) oder nicht (false).

setSubscribeToVideo

public void setSubscribeToVideo(boolean subscribeToVideo)

Ob man den Kanal abonnieren soll (true) oder nicht (false). Das Festlegen dieser Eigenschaft hat keine Auswirkung, wenn die hasVideo Methode des Stream-Objekts gibt zurück false.

Parameter: : subscribeToVideo - Ob man den Kanal abonnieren möchte (true) oder nicht (false).

setSubscribeToCaptions

public void setSubscribeToCaptions(boolean subscribeToCaptions)

Ob man die Untertitel des Streams abonnieren möchte (true) oder nicht (false)..

Parameter: : subscribeToCaptions - Ob man die Untertitel des Streams abonnieren möchte (true) oder nicht (false).

setCaptionsTranslationLanguage

public void setCaptionsTranslationLanguage(Zeichenfolge Sprache)

Legt die bevorzugte Sprache für die Übersetzung der Untertitel für diesen Abonnenten fest.

Diese Einstellung wird nur wirksam, wenn Untertitel aktiviert sind. Wählen Sie hier einen unterstützten BCP-47-Sprachcode aus, um übersetzte Untertitel zu erhalten, oder null um die Übersetzung zu deaktivieren. Der Standardwert lautet null (Es wurde keine Übersetzung konfiguriert).

Die unterstützten Sprachcodes sind in der Server-API-Spezifikation definiert.

Dies ist eine Funktion der privaten Beta-Version.

Parameter: : language - einen unterstützten BCP-47-Sprachcode oder null um die Übersetzung zu deaktivieren.

getCaptionsTranslationLanguage

öffentlich Zeichenfolge getCaptionsTranslationLanguage()

Ruft die für diesen Abonnenten konfigurierte Sprache für die Übersetzung der Bildunterschriften ab.

Dies ist eine Funktion der privaten Beta-Version.

Rückgabewerte: : Der konfigurierte BCP-47-Sprachcode oder null wenn keine Übersetzung festgelegt ist.

setStyle

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

Lege einen Stil fest, der von diesem Abonnenten verwendet wird.

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. Folgende 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 verkleinert, sodass das gesamte Video mit Pillarboxing (Standardeinstellung) sichtbar ist.

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.

Legen Sie den Video-Renderer für diesen Abonnenten fest.

Diese Methode ist veraltet. Rufen Sie stattdessen die SubscriberKit.Builder.renderer(BaseVideoRenderer renderer) Methode, wenn die Builder-Klasse zum Erstellen der SubscriberKit-Instanz verwendet wird.

getRenderer

öffentlich BaseVideoRenderer getRenderer()

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

getView

public android.view.View getView()

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

setVideoStatsListener

public void setVideoStatsListener(SubscriberKit.VideoStatsListener Zuhörer)

Richtet einen Listener für die Videostatistiken der Abonnenten ein. Das Listener-Objekt implementiert die SubscriberKit.VideoStatsListener.onVideoStats(SubscriberKit subscriber, SubscriberKit.SubscriberVideoStats stats) Methode. Diese Methode wird in regelmäßigen Abständen aufgerufen, um Folgendes zu melden:

Gesamtzahl der verlorenen Videopakete
Gesamtzahl der empfangenen Videopakete
Gesamtzahl der empfangenen Video-Bytes

Siehe auch: : - setAudioStatsListener(AudioStatsListener listener)

setAudioStatsListener

public void setAudioStatsListener(SubscriberKit.AudioStatsListener Zuhörer)

Richtet einen Listener für die Audio-Statistiken der Abonnenten ein. Das Listener-Objekt implementiert die SubscriberKit.AudioStatsListener.onAudioStats(SubscriberKit subscriber, SubscriberKit.SubscriberAudioStats stats) Methode. Diese Methode wird in regelmäßigen Abständen aufgerufen, um Folgendes zu melden:

Gesamtzahl der verlorenen Audiopakete
Gesamtzahl der empfangenen Audiopakete
Gesamtzahl der empfangenen Audio-Bytes

Siehe auch: : - setVideoStatsListener(VideoStatsListener listener)

setMediaLinkStatsListener

public void setMediaLinkStatsListener(SubscriberKit.MediaLinkStatsListener Zuhörer)

Richtet einen Listener für die Statistiken zu den Medienlinks der Abonnenten ein. Das Listener-Objekt implementiert die SubscriberKit.MediaLinkStatsListener Schnittstelle, die Folgendes umfasst:

SubscriberKit.MediaLinkStatsListener.onMediaLinkStats(SubscriberKit, SubscriberMediaLinkStats) — wird in regelmäßigen Abständen mit Metriken auf Transportebene aufgerufen.
SubscriberKit.MediaLinkStatsListener.onNetworkConditionChanged(SubscriberKit, SubscriberMediaLinkStats, String) — wird aufgerufen, wenn sich der Netzwerkstatus ändert.

Parameter: : listener - Die SubscriberKit.MediaLinkStatsListener Instanz oder „null“, um den Listener zu entfernen.

setPreferredResolution

public void setPreferredResolution(VideoUtils.Size bevorzugte Auflösung)

Legt die bevorzugte Auflösung für den Stream des Abonnenten fest.

Begrenzung der Videoauflösung und Bildfrequenz (siehe setPreferredFrameRate(float preferredFrameRate)) reduziert die Netzwerk- und CPU-Auslastung auf dem abonnierenden Client. Je nach den Abmessungen des Videos des Abonnenten in der App empfiehlt es sich möglicherweise, eine niedrigere Auflösung zu verwenden. Für Abonnenten eines Streams, der weniger wichtig (und kleiner) ist als andere Streams, empfiehlt es sich möglicherweise, eine niedrigere Bildrate oder Auflösung zu verwenden.

Diese Methode gilt nur beim Abonnieren eines Streams, der die Skalierbare Videofunktion. Skalierbare Videos sind verfügbar:

Nur in Sitzungen, die den OpenTok Media Router verwenden (Sitzungen mit dem Medien Modus auf geroutet gesetzt).
Gilt nur für Streams, die von Clients veröffentlicht werden, die skalierbares Video unterstützen (siehe die Dokumentation zu skalierbare Videofunktion).

Bei Streams, die kein skalierbares Video verwenden, hat der Aufruf dieser Methode keine Auswirkung.

Anmerkung: Die Auflösung für skalierbare Videostreams wird für jeden Abonnenten automatisch an die Netzwerkbedingungen und die CPU-Auslastung angepasst, auch wenn Sie diese Methode nicht aufrufen. Rufen Sie diese Methode auf, wenn Sie eine maximale Auflösung für diesen Abonnenten festlegen möchten.

Bei Streams, die kein skalierbares Video verwenden, hat der Aufruf dieser Methode keine Auswirkung.

Nicht jede Auflösung steht einem Abonnenten zur Verfügung. Wenn Sie die bevorzugte Auflösung festlegen, wählt das OpenTok Android SDK die beste verfügbare Auflösung aus, die Ihren Vorgaben entspricht. Die verfügbaren Auflösungen hängen von der maximalen Breite und Höhe ab, die der Publisher für den Stream festlegt und die vom Stream.getVideoWidth() und Stream.getVideoHeight() Methoden für das Stream-Objekt. Jede der für einen Stream verfügbaren Auflösungen verwendet dasselbe Seitenverhältnis.

Einreichen SubscriberKit.NO_PREFERRED_RESOLUTION um den Teilnehmer so zurückzusetzen, dass er keine bevorzugte Auflösung mehr hat. Der Teilnehmer verwendet dann die höchste verfügbare Auflösung, je nach den jeweiligen Bedingungen.

setPreferredFrameRate

public void setPreferredFrameRate(float preferredFrameRate)

Legt die bevorzugte Bildrate für den Stream des Teilnehmers fest.

Begrenzung der Bildrate und der Videoauflösung (siehe setPreferredResolution(VideoUtils.Size preferredResolution)) reduziert die Netzwerk- und CPU-Auslastung auf dem abonnierenden Client. Je nach den Abmessungen des Videos des Abonnenten in der App empfiehlt es sich möglicherweise, eine niedrigere Auflösung zu verwenden. Für Abonnenten eines Streams, der weniger wichtig (und kleiner) ist als andere Streams, empfiehlt es sich möglicherweise, eine niedrigere Bildrate oder Auflösung zu verwenden.

Diese Methode gilt nur beim Abonnieren eines Streams, der die Skalierbare Videofunktion. Skalierbare Videos sind verfügbar:

Nur in Sitzungen, die den OpenTok Media Router verwenden (Sitzungen mit dem Medien Modus auf geroutet gesetzt).
Gilt nur für Streams, die von Clients veröffentlicht werden, die skalierbares Video unterstützen (siehe die Dokumentation zu skalierbare Videofunktion).

Bei Streams, die kein skalierbares Video verwenden, hat der Aufruf dieser Methode keine Auswirkung.

Anmerkung: Die Bildrate für skalierbare Videostreams wird für jeden Abonnenten automatisch an die Netzwerkbedingungen und die CPU-Auslastung angepasst, auch wenn Sie diese Methode nicht aufrufen. Rufen Sie diese Methode auf, wenn Sie eine maximale Bildrate für diesen Abonnenten festlegen möchten.

Die verfügbaren Bildraten richten sich nach dem Wert der maximalen Bildrate, die für den Stream zur Verfügung steht. Wenn Sie die bevorzugte Bildrate für den Abonnenten festlegen, wählt das OpenTok Android SDK die beste verfügbare Bildrate aus, die der bevorzugten Bildrate am nächsten kommt, und zwar auf der Grundlage der Bandbreite und der CPU- Einschränkungen des Clients.

Die tatsächlich verfügbaren Bildraten hängen dynamisch von den Netzwerk- und CPU-Ressourcen ab, die dem Publisher zur Verfügung stehen.

Einreichen SubscriberKit.NO_PREFERRED_FRAMERATE um den Teilnehmer so zurückzusetzen, dass er keine bevorzugte Bildrate mehr hat. Der Teilnehmer nutzt dann die maximal verfügbare Bildrate, je nach den jeweiligen Bedingungen.

getPreferredResolution

öffentlich VideoUtils.Size getPreferredResolution()

Gibt die bevorzugte Auflösung für den Stream des Abonnenten zurück. Diese Methode gilt nur für Streams, die mithilfe der Funktion „Scalable Video“ veröffentlicht wurden. Siehe setPreferredResolution(VideoUtils.Size preferredResolution).

setRtcStatsReportListener

public void setRtcStatsReportListener(SubscriberKit.SubscriberRtcStatsReportListener Zuhörer)

Legt den RTC-Statistikbericht-Listener für den Abonnenten fest. Siehe getRtcStatsReport().

Parameter: : listener - Die SubscriberKit.SubscriberRtcStatsReportListener Objekt.

getRtcStatsReport

public void getRtcStatsReport()

Ruft den RTC-Statistikbericht für den Abonnenten ab. Dies ist ein asynchroner Vorgang. Rufen Sie die Methode `SubscriberKit#setRtcStatsReportListener(SubscriberRtcStatsReportListener listener)` auf und implementieren Sie anschließend die SubscriberKit.SubscriberRtcStatsReportListener.onRtcStatsReport(SubscriberKit subscriber, String jsonArrayOfReports) Methode, bevor diese Methode aufgerufen wird. Sobald die Statistiken verfügbar sind, erfolgt die Implementierung der SubscriberKit.SubscriberRtcStatsReportListener.onRtcStatsReport(SubscriberKit subscriber, String jsonArrayOfReports) Die Methode wird aufgerufen.

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

onRtcStatsReport

protected void onRtcStatsReport(Zeichenfolge jsonArrayOfReports)

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

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

Siehe onRtcStatsReport(String jsonArrayOfReports).

getPreferredFrameRate

public float getPreferredFrameRate()

Gibt die bevorzugte Bildrate für den Stream des Abonnenten zurück. Diese Methode gilt nur für Streams, die mithilfe der Funktion „Scalable Video“ veröffentlicht wurden. Siehe setPreferredFrameRate(float preferredFrameRate).

Rückgabewerte: : Die bevorzugte Bildrate für den Abonnentenstrom oder -1, falls beim Abrufen des tatsächlichen Werts ein Fehler aufgetreten ist.

onConnected

protected void onConnected()

Wird aufgerufen, wenn die Instanz erfolgreich eine Verbindung zum Stream hergestellt hat und mit der Wiedergabe von Medien beginnt.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onConnected() Methode der Schnittstelle „SubscriberKit.SubscriberListener“.

onDisconnected

@Veraltet protected void onDisconnected()

Veraltet.

Ab Version 2.17.0 wird dieser Callback nicht mehr aufgerufen. Wenn ein Abonnent die Verbindung zur Sitzung trennt, wird die Session.SessionListener.onStreamDropped(com.opentok.android.Session, com.opentok.android.Stream) Der Callback wird aufgerufen.

onError

protected void onError(Opentok-Fehler Fehler)

Wird aufgerufen, wenn ein Teilnehmer keine Verbindung zum OpenTok-Server herstellen konnte.

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

Parameter: : error - Der Fehler.

onStreamDisconnected

protected void onStreamDisconnected()

Wird aufgerufen, wenn der Stream des Teilnehmers unterbrochen wurde.

Als Reaktion auf den Aufruf dieser Methode möchten Sie möglicherweise eine Benachrichtigung über die Benutzeroberfläche anzeigen, um den Benutzer darüber zu informieren, dass die Verbindung zum Audio-Video-Stream vorübergehend unterbrochen ist und die App versucht, die Verbindung zum Stream wiederherzustellen.

Wenn der Client die Verbindung zum Stream wiederherstellt, wird die onStreamReconnected() Methode aufgerufen wird. Andernfalls wird die onDisconnected() Methode aufgerufen wird.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode überschreiben, anstatt die onDisconnected() Methode der Schnittstelle „SubscriberKit.StreamListener“.

onStreamReconnected

protected void onStreamReconnected()

Wird aufgerufen, wenn der Stream des Teilnehmers wieder aufgenommen wurde, nachdem die onStreamDisconnected() Methode aufgerufen wird.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode überschreiben, anstatt die onReconnected() Methode der Schnittstelle „SubscriberKit.StreamListener“.

onAudioEnabled

protected void onAudioEnabled()

Wird aufgerufen, wenn der Stream des Teilnehmers die Audiofunktion aktiviert hat.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode überschreiben, anstatt die onAudioEnabled() Methode der Schnittstelle „SubscriberKit.StreamListener“.

onAudioDisabled

protected void onAudioDisabled()

Wird aufgerufen, wenn der Audio-Stream des Teilnehmers deaktiviert wurde

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode überschreiben, anstatt die onAudioDisabled() Methode der Schnittstelle „SubscriberKit.StreamListener“.

onVideoDisabled

protected void onVideoDisabled(Zeichenfolge Grund)

Wird aufgerufen, wenn der Abonnent kein Video mehr empfängt. Überprüfen Sie den Parameter „reason“, um den Grund für den Abbruch der Videoübertragung zu ermitteln.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onVideoDisabled() Methode der Schnittstelle „SubscriberKit.SubscriberListener“.

Parameter: : reason - Der Grund, warum die Videospur deaktiviert wurde. Dieser Wert wird auf einen der folgenden Werte gesetzt: VIDEO_REASON_PUBLISH_VIDEO VIDEO_REASON_SUBSCRIBE_TO_VIDEO, VIDEO_REASON_QUALITY, oder VIDEO_REASON_CODEC_NOT_SUPPORTED.

onVideoEnabled

protected void onVideoEnabled(Zeichenfolge Grund)

Wird aufgerufen, wenn der Videostream des Teilnehmers startet (wenn zuvor kein Video vorhanden war) oder fortgesetzt wird (nachdem das Video deaktiviert wurde). Überprüfen Sie den Parameter „reason“, um den Grund für die Unterbrechung des Videos zu ermitteln.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onVideoEnabled() Methode der Schnittstelle „SubscriberKit.SubscriberListener“.

Parameter: : reason - Der Grund, aus dem die Videospur gestartet oder fortgesetzt wurde. Dieser Wert wird auf einen der folgenden Werte gesetzt: VIDEO_REASON_PUBLISH_VIDEO VIDEO_REASON_SUBSCRIBE_TO_VIDEO, oder VIDEO_REASON_QUALITY.

onVideoDisableWarning

protected void onVideoDisableWarning()

Wird aufgerufen, wenn der OpenTok Media Router feststellt, dass sich die Stream-Qualität verschlechtert hat und das Video deaktiviert wird, sollte sich die Qualität weiter verschlechtern. Sollte sich die Qualität weiter verschlechtern, deaktiviert der Teilnehmer das Video und die onVideoDisabled(String reason) Methode wird aufgerufen. Wenn sich die Stream-Qualität verbessert, wird die onVideoDisableWarningLifted() Methode aufgerufen wird.

Diese Funktion ist nur in Sitzungen verfügbar, die den OpenTok Media Router verwenden (Sitzungen, bei denen der Medienmodus auf „routed“ eingestellt ist), nicht jedoch in Sitzungen, bei denen der Medienmodus auf „relayed“ eingestellt ist. (Siehe Der OpenTok Media Router und die Medienmodi).

Diese Methode wird vor allem dann aufgerufen, wenn sich die Verbindungsqualität verschlechtert.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onVideoDisableWarning() Methode der Schnittstelle „SubscriberKit.SubscriberListener“ .

onVideoDisableWarningLifted

protected void onVideoDisableWarningLifted()

Wird aufgerufen, wenn der OpenTok Media Router feststellt, dass sich die Stream-Qualität so weit verbessert hat, dass die Deaktivierung des Videos kein unmittelbares Risiko mehr darstellt. Diese Methode wird aufgerufen, nachdem die onVideoDisableWarning() Die Methode wird aufgerufen.

Diese Methode wird hauptsächlich aufgerufen, wenn sich die Verbindungsqualität verbessert.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onVideoDisableWarningLifted() Methode der Schnittstelle „SubscriberKit.SubscriberListener“.

onVideoDataReceived

protected void onVideoDataReceived()

Wird aufgerufen, wenn ein Abonnent zum ersten Mal Videodaten empfängt.

Wenn Sie die Klasse „SubscriberKit“ erweitern, können Sie diese Methode anstelle der onVideoDataReceived() Methode der Schnittstelle „SubscriberKit.VideoListener“.

attachToSession

protected void attachToSession(Sitzung Sitzung)

detachFromSession

protected void detachFromSession(Sitzung Sitzung)

onAudioLevelUpdated

protected void onAudioLevelUpdated(float audioLevel)

onCaptionText

protected void onCaptionText(Zeichenfolge text, boolean isFinal)

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.

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 für ein „SubscriberKit“-Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind.

Überschreibungen: : finalize im Unterricht Object

Würfe: : Throwable