com.opentok.android.PublisherKit.Builder
Direkte bekannte Unterklassen:
: Publisher.Builder
Übergeordnete Klasse: : PublisherKit
public static class PublisherKit.Builder erweitert Objekt
Wird verwendet, um ein PublisherKit Objekt. Erstellen Sie ein Builder-Objekt mithilfe des
PublisherKit.Builder(Context context) Konstruktor. Rufen Sie anschließend Methoden von
dem Builder Instanz, um Einstellungen für den Herausgeber hinzuzufügen. Rufen Sie anschließend die
build() Methode, die einen PublisherKit Objekt.
Verwenden Sie die Session.publish(PublisherKit publisher) Methode zum Starten des Streamings
vom Publisher in eine Sitzung.
Publisher können nicht wiederverwendet werden. Erstellen Sie eine neue Instanz von PublisherKit Objekt jedes Mal, wenn Sie
einen neuen Stream veröffentlichen möchten.
Siehe auch:
: - PublisherKit.setPublisherListener(PublisherKit.PublisherListener listener)
Zusammenfassung zum Konstruktor
Konstruktoren
Konstruktor
Beschreibung
Builder(android.content.Context context)
Erstellt eine Instanz von PublisherKit.Builder Objekt.
Zusammenfassung der Methode
Alle MethodenInstanzmethodenKonkrete Methoden
Modifikator und Typ
Methode
Beschreibung
PublisherKit.Builder
allowAudioCaptureWhileMuted(boolean allow)
Wenn dieser Wert auf „false“ gesetzt ist, wird das Mikrofon automatisch ausgeschaltet, sobald alle Redner ihr Mikrofon stummgeschaltet haben.
PublisherKit.Builder
audioBitrate(int bitsPerSecond)
Legt die gewünschte Bitrate für den veröffentlichten Ton in Bit pro Sekunde fest.
PublisherKit.Builder
audioTrack(boolean enabled)
Legt fest, ob eine Audiospur in den veröffentlichten Stream aufgenommen werden soll (true,
(Standard) oder nicht (false).
PublisherKit
build()
PublisherKit.Builder
capturer(BaseVideoCapturer capturer)
Legt fest, welcher Video-Capturer für den Publisher verwendet werden soll.
PublisherKit.Builder
enableOpusDtx(boolean enable)
Ob aktiviert werden soll Opus DTX (true) oder nicht (false(die Standardeinstellung).
PublisherKit.Builder
name(String name)
Legt den Namen des veröffentlichten Videos fest.
PublisherKit.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
PublisherKit.Builder
publisherAudioFallbackEnabled(boolean enabled)
Ob der Stream die Audio-Fallback-Funktion des Publishers nutzen wird (true) oder nicht
(false).
PublisherKit.Builder
renderer(BaseVideoRenderer renderer)
Legt den für den Publisher zu verwendenden Video-Renderer fest.
PublisherKit.Builder
scalableScreenshare(boolean enabled)
Ob die Nutzung von skalierbares Video für einen Publisher, bei dem der „videoType“ auf „PublisherKitVideoTypeScreen“ (true) gesetzt ist oder nicht (false, Standardwert).
PublisherKit.Builder
senderStatsTrack(boolean enabled)
Wenn Sie diese Funktion nicht aufrufen und true, wird das Subsystem für die Absenderstatistiken
für den Publisher nicht initialisiert.
PublisherKit.Builder
subscriberAudioFallbackEnabled(boolean enabled)
Ob der Stream die Audio-Fallback-Funktion für Abonnenten nutzen wird (true) oder nicht
(false), für Abonnenten des veröffentlichten Streams.
PublisherKit.Builder
videoTrack(boolean enabled)
Legt fest, ob eine Videospur in den veröffentlichten Stream aufgenommen werden soll (true,
(Standard) oder nicht (false).
Von der Klasse „java.lang.“ geerbte Methoden.Objekt
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Angaben zum Hersteller
Bauunternehmer
public Builder(android.content.Context context)
Erstellt eine Instanz von PublisherKit.Builder Objekt.
Parameter:
: context - Die android.content.Context für den Verlag.
Details zur Methode
Name
öffentlich PublisherKit.Builder name(Zeichenfolge Name)
Legt den Namen des veröffentlichten Videos fest. Der name Die Eigenschaft für einen Stream,
der von diesem Herausgeber veröffentlicht wird, wird (auf allen Clients) auf diesen Wert gesetzt.
audioTrack
öffentlich PublisherKit.Builder audioTrack(boolean enabled)
Legt fest, ob eine Audiospur in den veröffentlichten Stream aufgenommen werden soll (true,
(Standard) oder nicht (false). Das Erstellen eines Publishers ohne Audiospur
kann CPU-Ressourcen sparen und die vom Stream beanspruchte Bandbreite reduzieren.
Wenn Sie diese Funktion aufrufen und dabei false, wird das Audiosubsystem
für den Publisher nicht initialisiert, und der Aufruf der
PublisherKit.setPublishAudio(boolean publishAudio) Die Methode hat keine Auswirkung.
Wenn Ihre Anwendung keine Audiofunktionen benötigt, wird empfohlen, diese
Builder-Einstellung zu verwenden, anstatt die
PublisherKit.setPublishAudio(boolean publishAudio) Methode, die die Audiospur nur
vorübergehend deaktiviert.
videoTrack
öffentlich PublisherKit.Builder videoTrack(boolean enabled)
Legt fest, ob eine Videospur in den veröffentlichten Stream aufgenommen werden soll (true,
(Standard) oder nicht (false). Das Erstellen eines Publishers ohne Videospur
kann CPU-Ressourcen sparen und die vom Stream beanspruchte Bandbreite reduzieren.
Wenn Sie diese Funktion aufrufen und dabei false, wird das Videosubsystem
für den Publisher nicht initialisiert, und der Aufruf der
PublisherKit.setPublishVideo(boolean publishVideo) Die Methode hat keine Auswirkung.
Wenn Ihre Anwendung keine Videofunktionen benötigt, wird empfohlen, diese
Builder-Einstellung zu verwenden, anstatt die
PublisherKit.setPublishVideo(boolean publishVideo) Methode, die die Videospur lediglich
vorübergehend deaktiviert.
Aufnehmer
öffentlich PublisherKit.Builder capturer(BaseVideoCapturer Aufnehmer)
Legt fest, welcher Video-Capturer für den Publisher verwendet werden soll.
Renderer
öffentlich PublisherKit.Builder Renderer(BaseVideoRenderer Renderer)
Legt den für den Publisher zu verwendenden Video-Renderer fest.
audioBitrate
öffentlich PublisherKit.Builder audioBitrate(int bitsPerSecond)
Legt die gewünschte Bitrate für den übertragenen Ton in Bit pro Sekunde fest. Der unterstützte Wertebereich liegt zwischen 6.000 und 510.000. (Ungültige Werte werden ignoriert.) Legen Sie diesen Wert fest, um eine hohe Tonqualität zu aktivieren (oder um die Bandbreitennutzung bei geringerer Tonqualität zu reduzieren).
Die folgenden Einstellungen sind empfehlenswert:
- 8.000 - 12.000 für Schmalbandsprache (NB)
- 16.000 - 20.000 für Breitbandsprache (WB)
- 28.000 - 40.000 für Full-Band (FB) Sprache
- 48.000 – 64.000 für Vollband-Mono-Musik (FB)
- 64.000 – 128.000 für Vollband-Stereomusik (FB)
Der Standardwert beträgt 40.000.
Informationen zum Vornehmen weiterer Audioeinstellungen finden Sie unter AudioDeviceManager Klasse.
Parameter:
: bitsPerSecond - Die gewünschte Bitrate des Audios in Bit pro Sekunde.
Rückgabewerte: : Dieses Builder-Objekt.
enableOpusDtx
öffentlich PublisherKit.Builder enableOpusDtx(boolean enable)
Ob aktiviert werden soll Opus DTX (true) oder nicht (false(Standard). Durch die Aktivierung von Opus DTX
lässt sich der Bandbreitenverbrauch bei Streams mit langen Stillphasen reduzieren.
Standardmäßig ist Opus DTX deaktiviert. Wenn diese Eigenschaft auf true,
Opus DTX wird für den Verlag freigeschaltet.
Skalierbare Bildschirmfreigabe
öffentlich PublisherKit.Builder scalableScreenshare(boolean enabled)
Ob die Nutzung von skalierbares Video für einen Publisher, bei dem der „videoType“ auf „PublisherKitVideoTypeScreen“ (true) gesetzt ist oder nicht (false, Standardwert).
subscriberAudioFallbackEnabled
öffentlich PublisherKit.Builder subscriberAudioFallbackEnabled(boolean enabled)
Ob der Stream die Audio-Fallback-Funktion für Abonnenten nutzen wird (true) oder nicht
(false), für Teilnehmer des veröffentlichten Streams. Die Audio-Fallback-Funktion für Teilnehmer
ist in Sitzungen verfügbar, die den OpenTok Media Router nutzen. Ist die
Audio-Fallback-Funktion für Teilnehmer aktiviert (Standardeinstellung), deaktiviert der OpenTok Media Router das Video
für diesen Teilnehmer, sobald er feststellt, dass sich die
Qualität eines Streams für einen bestimmten Teilnehmer erheblich verschlechtert hat, um die Audioqualität zu erhalten.
Die Standardeinstellung lautet true (die Audio-Fallback-Funktion ist aktiviert).
Bei Verwendung des Bildschirmvideo-Typs in einer Sitzung, die den OpenTok Media Server nutzt, ist die
Audio-Fallback-Einstellung für den Teilnehmer festgelegt auf false standardmäßig,
damit das Video bei den Abonnenten nicht unterbrochen wird.
Siehe auch:
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- Der
OpenTok Media Router und die Medienmodi
publisherAudioFallbackEnabled
öffentlich PublisherKit.Builder publisherAudioFallbackEnabled(boolean enabled)
Ob der Stream die Audio-Fallback-Funktion des Publishers nutzen wird (true) oder nicht
(false). Ist die Audio-Fallback-Funktion des Publishers aktiviert (Standardeinstellung), deaktiviert der
Publisher das Video, sobald er feststellt, dass sich die Qualität eines Streams erheblich verschlechtert hat,
um die Audioqualität zu erhalten.
Die Standardeinstellung lautet false (Die Audio-Fallback-Funktion ist deaktiviert).
Siehe auch:
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- Der
OpenTok Media Router und die Medienmodi
allowAudioCaptureWhileMuted
öffentlich PublisherKit.Builder allowAudioCaptureWhileMuted(boolean allow)
Bei der Einstellung „false“ wird das Mikrofon automatisch ausgeschaltet, sobald alle Publisher ihren Ton stummgeschaltet haben. Das Mikrofon wird automatisch wieder eingeschaltet, sobald mindestens ein Publisher die Stummschaltung aufhebt. Bei der Einstellung „true“ bleibt das Mikrofon immer eingeschaltet, auch wenn alle Publisher ihren Ton stummgeschaltet haben. Beachten Sie, dass bei ausgeschaltetem Mikrofon Callbacks wie „AudioLevel“ oder „AudioData“ für die Publisher nicht mehr aufgerufen werden. Der Standardwert ist „false“.
bevorzugte Videokodecs
öffentlich PublisherKit.Builder bevorzugte Videokodecs(PublisherKit.BevorzugteVideoCodecs bevorzugte Videokodecs)
senderStatsTrack
öffentlich PublisherKit.Builder senderStatsTrack(boolean enabled)
Wenn Sie diese Funktion nicht aufrufen und true, wird das Subsystem für die Absenderstatistiken
für den Publisher nicht initialisiert.
Erstellen
öffentlich PublisherKit build()
Rückgabewert:
: Gibt einen neuen PublisherKit beispielsweise auf der Grundlage der PublisherKit.Builder
Einstellungen.