com.opentok.android.PublisherKit
com.opentok.android.Publisher
Alle implementierten Schnittstellen:
: Observer
public class Publisher extends PublisherKit
Dient zur Erfassung eines Audio-Video-Streams über das Mikrofon und die Kamera des Geräts zur Verwendung in einer OpenTok-Sitzung. Erstellen Sie eine „Publisher“-Instanz, indem Sie den „Publisher“-Konstruktor aufrufen.
Wenn die Ansicht eines Publishers das aktive Fenster verlässt, wird das Publisher-Objekt gelöscht. Dies ist der Fall, wenn eine Aktivität gestoppt oder angehalten wird.
Siehe auch:
: - Session.publish(PublisherKit publisher)
Zusammenfassung zu verschachtelten Klassen
Verschachtelte Klassen
Modifikator und Typ
Klasse
Beschreibung
static class
Publisher.Builder
Wird verwendet, um ein Publisher Objekt.
static enum
Publisher.CameraCaptureFrameRate
Legt Werte für die frameRate Parameter des
Publisher.Builder.frameRate(Publisher.CameraCaptureFrameRate frameRate) Methode.
static enum
Publisher.CameraCaptureResolution
Legt Werte für die resolution Parameter des
Publisher.Builder.resolution(Publisher.CameraCaptureResolution resolution) Methode.
static interface
Publisher.CameraListener
Überwacht, wann sich die vom Herausgeber verwendete Kamera ändert.
Verschachtelte Klassen/Schnittstellen, die von der Klasse „com.opentok.android“ erben.PublisherKit
PublisherKit.AudioLevelListener, PublisherKit.AudioStatsListener, PublisherKit.AudioTransformer, PublisherKit.CustomAudioTransformer, PublisherKit.CustomVideoTransformer, PublisherKit.DegradationPreference, PublisherKit.MediaLinkStatsListener, PublisherKit.MuteListener, PublisherKit.PreferredVideoCodecs, PublisherKit.PublisherAudioStats, PublisherKit.PublisherKitVideoType, PublisherKit.PublisherListener, PublisherKit.PublisherMediaLinkStats, PublisherKit.PublisherRtcStats, PublisherKit.PublisherRtcStatsReportListener, PublisherKit.PublisherVideoStats, PublisherKit.VideoBitratePreset, PublisherKit.VideoLayerStats, PublisherKit.VideoListener, PublisherKit.VideoStatsListener, PublisherKit.VideoTransformer
Zusammenfassung der Felddaten
Felder
Modifikator und Typ
Feld
Beschreibung
protected Publisher.CameraCaptureFrameRate
cameraFrameRate
protected Publisher.CameraListener
cameraListener
protected Publisher.CameraCaptureResolution
cameraResolution
Von der Klasse „com.opentok.android“ geerbte Felder.PublisherKit
audioLevelListener, audioStatsListener, capturer, context, handler, mediaLinkStatsListener, muteListener, NETWORK_REASON_NETWORK_CONDITION_CHANGE, publisherListener, renderer, rtcStatsReportListener, VIDEO_REASON_CODEC_CHANGE, VIDEO_REASON_NONE, VIDEO_REASON_QUALITY, VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH, VIDEO_REASON_QUALITY_DEGRADATION_CPU, VIDEO_REASON_QUALITY_DEGRADATION_OTHER, VIDEO_REASON_RESOLUTION_CHANGE, videoListener, videoStatsListener
Zusammenfassung zum Konstruktor
Konstruktoren
Modifikator
Konstruktor
Beschreibung
protected
Publisher(Publisher.Builder builder)
Zusammenfassung der Methode
Alle MethodenInstanzmethodenKonkrete MethodenVeraltete Methoden
Modifikator und Typ
Methode
Beschreibung
void
cycleCamera()
Wechselt zwischen den Kameras hin und her, sofern das Gerät über mehrere Kameras verfügt.
int
getCameraId()
Veraltet.
protected void
onCameraChanged(int newCameraId)
Wird aufgerufen, wenn der Publisher die aktive Kamera wechselt.
protected void
onCameraError(OpentokError error)
Wird aufgerufen, wenn beim Zugriff auf die Kamera ein Fehler auftritt.
void
setCameraId(int cameraId)
Veraltet.
void
setCameraListener(Publisher.CameraListener listener)
Legt einen Publisher.CameraListener Objekt, das überwacht, wann sich die vom
Herausgeber verwendete Kamera ändert.
void
setCameraTorch(boolean enable)
Legt den bevorzugten Taschenlampenmodus für die Kamera fest.
void
setCameraZoomFactor(float cameraZoomFactor)
Der bevorzugte Zoomfaktor (Verhältnis) für die Kamera.
void
startPreview()
Veraltet.
void
swapCamera()
Veraltet.
Von der Klasse „com.opentok.android“ geerbte Methoden.PublisherKit
destroy, finalize, getCapturer, getDegradationPreference, getMaxVideoBitrate, getName, getPublishAudio, getPublishCaptions, getPublisherVideoType, getPublishVideo, getRenderer, getRtcStatsReport, getSession, getStream, getTargetScalabilityMode, getVideoBitratePreset, getView, onAudioLevelUpdated, onError, onMuteForced, onPause, onRestart, onResume, onRtcStatsReport, onStop, onStreamCreated, onStreamDestroyed, setAudioLevelListener, setAudioStatsListener, setAudioTransformers, setCapturer, setDegradationPreference, setMaxVideoBitrate, setMediaLinkStatsListener, setMuteListener, setName, setPublishAudio, setPublishCaptions, setPublisherListener, setPublisherVideoType, setPublishVideo, setRenderer, setRtcStatsReportListener, setStyle, setTargetScalabilityMode, setVideoBitratePreset, setVideoListener, setVideoStatsListener, setVideoTransformers, update
Von der Klasse „java.lang.“ geerbte Methoden.Objekt
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Felddetails
Kamera-Bildrate
geschützt Publisher.CameraCaptureFrameRate Kamera-Bildrate
Kameraauflösung
geschützt Publisher.CameraCaptureResolution Kameraauflösung
cameraListener
geschützt Publisher.CameraListener cameraListener
Angaben zum Hersteller
Herausgeber
protected Publisher(Herausgeber.Builder Bauunternehmer)
Details zur Methode
setCameraListener
public void setCameraListener(Publisher.CameraListener Zuhörer)
Legt einen Publisher.CameraListener Objekt, das überwacht, wann sich die vom
Herausgeber verwendete Kamera ändert.
Parameter:
: listener - Die Publisher.CameraListener Instanz.
setCameraId
@Veraltet public void setCameraId(int cameraId)
Veraltet.
Stellt die gewünschte Kamera ein. cameraId kann ein Wert zwischen 0
und android.hardware.Camera#getNumberOfCameras() - 1 sein.
Wenn sich die vom Herausgeber verwendete Kamera ändert, wird die
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
Die Methode wird aufgerufen.
Diese Methode ist veraltet. Sie sollten die neue cycleCamera() Methode zum Wechseln
zwischen den Kameras, falls mehrere Kameras auf dem Gerät vorhanden sind.
Parameter:
: cameraId - die ID der Kamera, die Sie für diesen Publisher verwenden möchten
setCameraTorch
public void setCameraTorch(boolean enable)
Legt den bevorzugten Taschenlampenmodus für die Kamera fest. Beachten Sie, dass es sich hierbei um eine Einstellung handelt und diese möglicherweise nicht wirksam wird, wenn die aktive Kamera die Taschenlampenfunktion nicht unterstützt (beispielsweise unterstützt die Frontkamera in der Regel keine Taschenlampenfunktion).
Parameter:
: enable - Der Standardwert ist „false“. Durch die Übergabe von „true“ oder „false“
wird festgelegt, ob der Herausgeber den Blitz der Kamera aktivieren oder deaktivieren soll,
sofern dieser verfügbar ist.
setCameraZoomFactor
public void setCameraZoomFactor(float cameraZoomFactor)
Der bevorzugte Zoomfaktor (Verhältnis) für die Kamera. Der Wert 1,0 entspricht keinem Zoom (Standardansicht). Der Wert liegt zwischen 0,5 und dem maximalen Zoomfaktor. Werte zwischen 0,5 und 1,0 entsprechen einem Ultraweitwinkel (Herauszoomen), während Werte zwischen 1,0 und dem maximalen Zoomfaktor dem Heranzoomen entsprechen. Der tatsächlich angewandte Zoomfaktor wird automatisch auf den von der aktiven Kamerakonfiguration unterstützten Bereich begrenzt – wenn die Kamera keinen Ultraweitwinkel unterstützt, werden Zoomfaktoren unter 1,0 nicht wirksam und es wird kein Zoom angewendet. Bei Werten, die über dem von der Kamera unterstützten maximalen Zoomfaktor liegen, wird der Zoomfaktor auf den Maximalwert gesetzt. Ist die Publisher- Kamera aktiviert, gibt der Abruf dieser Eigenschaft den aktuellen Zoomfaktor zurück; ist die Publisher-Kamera nicht aktiviert, gibt der Abruf dieser Eigenschaft den bevorzugten Zoomfaktor zurück.
Parameter:
: cameraZoomFactor - Durch das Festlegen dieser Eigenschaft wird die gewünschte Zoomstufe angegeben,
wobei der Wert 1,0 für keinen Zoom steht (Standardansicht).
cycleCamera
public void cycleCamera()
Wechselt zwischen den Kameras, sofern mehrere Kameras auf dem Gerät vorhanden sind. Wenn
sich die vom Publisher verwendete Kamera ändert, wird die
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
Die Methode wird aufgerufen.
Kamera wechseln
@Veraltet public void swapCamera()
Veraltet.
Diese Methode ist veraltet. Sie sollten die neue cycleCamera() Methode zum Wechseln
zwischen den Kameras, falls mehrere Kameras auf dem Gerät vorhanden sind.
Wenn Sie einen benutzerdefinierten Video-Capturer verwenden, implementieren Sie die
BaseVideoCapturer.CaptureSwitch Schnittstelle in dem Objekt, das
BaseVideoCapturer erweitert, und implementieren Sie die
BaseVideoCapturer.CaptureSwitch.swapCamera(int cameraId) Methode zur Definition des Verhaltens
des Publisher.swapCamera() Methode.
getCameraId
@Veraltet public int getCameraId()
Veraltet.
Gibt die ID der derzeit aktiven Kamera zurück. Dieser Wert ist entweder 0 (für die
Rückkamera) oder 1 (für die Frontkamera). Wenn
setCameraId(int) wird nie aufgerufen, der Rückgabewert ist 1 (für die
Frontkamera).
Diese Methode ist veraltet. Sie sollten die neue cycleCamera() Methode zum Wechseln
zwischen den Kameras, falls mehrere Kameras auf dem Gerät vorhanden sind.
onCameraChanged
protected void onCameraChanged(int newCameraId)
Wird aufgerufen, wenn der Publisher die aktive Kamera wechselt.
Wenn Sie die Klasse „Publisher“ erweitern, können Sie diese Methode anstelle der
onCameraChanged() Methode der Schnittstelle „Publisher.CameraListener“
.
Parameter:
: newCameraId - Die ID der neuen aktiven Kamera.
onCameraError
protected void onCameraError(Opentok-Fehler Fehler)
Wird aufgerufen, wenn beim Zugriff auf die Kamera ein Fehler auftritt.
Parameter:
: error - Der Fehler.
startPreview
@Veraltet public void startPreview()
Veraltet.
Ab Version 2.17.0 hat diese Methode keine Wirkung mehr. Sobald das Publisher-Objekt erstellt wurde, wird das Videobild der Kamera in der Ansicht des Publishers angezeigt. Durch diese Änderung wird das Verhalten in allen OpenTok-Client-SDKs vereinheitlicht.