com.opentok.android.PublisherKit
com.opentok.android.Publisher
Todas las interfaces implementadas:
: Observer
clase pública Publisher extende PublisherKit
Se utiliza para capturar un flujo de audio y vídeo desde el micrófono y la cámara del dispositivo para su uso en una sesión de OpenTok. Crea una instancia de Publisher llamando al constructor de Publisher.
Cuando la vista de un Publisher sale de la ventana activa, el objeto Publisher se destruye. Esto ocurre cuando una actividad se detiene o se pone en pausa.
Véase también:
: - Session.publish(PublisherKit publisher)
Resumen de clases anidadas
Clases anidadas
Modificador y tipo
Clase
Descripción
static class
Publisher.Builder
Se utiliza para crear un Publisher objeto.
static enum
Publisher.CameraCaptureFrameRate
Define los valores para el frameRate del
Publisher.Builder.frameRate(Publisher.CameraCaptureFrameRate frameRate) método.
static enum
Publisher.CameraCaptureResolution
Define los valores para el resolution del
Publisher.Builder.resolution(Publisher.CameraCaptureResolution resolution) método.
static interface
Publisher.CameraListener
Detecta cuándo cambia la cámara que utiliza el editor.
Clases e interfaces anidadas que heredan de la clase com.opentok.android.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
Resumen del campo
Campos
Modificador y tipo
Campo
Descripción
protected Publisher.CameraCaptureFrameRate
cameraFrameRate
protected Publisher.CameraListener
cameraListener
protected Publisher.CameraCaptureResolution
cameraResolution
Campos heredados de la clase com.opentok.android.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
Resumen del constructor
Constructores
Modificador
Constructor
Descripción
protected
Publisher(Publisher.Builder builder)
Resumen del método
Todos los métodosMétodos de instanciaMétodos concretosMétodos obsoletos
Modificador y tipo
Método
Descripción
void
cycleCamera()
Alterna entre las cámaras, si hay varias cámaras en el dispositivo.
int
getCameraId()
En desuso.
protected void
onCameraChanged(int newCameraId)
Se invoca cuando el editor cambia la cámara activa.
protected void
onCameraError(OpentokError error)
Se invoca cuando se produce un error al acceder a la cámara.
void
setCameraId(int cameraId)
En desuso.
void
setCameraListener(Publisher.CameraListener listener)
Establece un Publisher.CameraListener objeto que permite detectar cuándo cambia la cámara utilizada por
el editor.
void
setCameraTorch(boolean enable)
Establece el modo de linterna preferido para la cámara.
void
setCameraZoomFactor(float cameraZoomFactor)
El factor de zoom (relación) preferido para la cámara.
void
startPreview()
En desuso.
void
swapCamera()
En desuso.
Métodos heredados de la clase com.opentok.android.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
Métodos heredados de la clase java.lang.Objeto
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Detalles del campo
frecuencia de fotogramas de la cámara
protegido Publisher.CameraCaptureFrameRate frecuencia de fotogramas de la cámara
resolución de la cámara
protegido Publisher.CameraCaptureResolution resolución de la cámara
cameraListener
protegido Publisher.CameraListener cameraListener
Datos del constructor
Editorial
protected Publisher(Publisher.Builder constructor)
Detalles del método
setCameraListener
public void setCameraListener(Publisher.CameraListener oyente)
Establece un Publisher.CameraListener objeto que permite detectar cuándo cambia la cámara utilizada por
el editor.
Parámetros:
: listener - El Publisher.CameraListener instancia.
setCameraId
@Obsoleto public void setCameraId(int cameraId)
En desuso.
Selecciona la cámara deseada. cameraId puede ser un valor comprendido entre 0
y android.hardware.Camera#getNumberOfCameras() - 1.
Cuando cambia la cámara que utiliza el editor, el
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
se llama el método.
Este método está obsoleto. Debes utilizar el nuevo cycleCamera() método para alternar
entre cámaras, si hay varias cámaras en el dispositivo.
Parámetros:
: cameraId - el identificador de la cámara que quieres utilizar en este editor
setCameraTorch
public void setCameraTorch(boolean enable)
Establece el modo de linterna preferido para la cámara. Ten en cuenta que se trata de una preferencia y que puede que no se aplique si la cámara activa no admite la función de linterna (por ejemplo, la cámara frontal no suele admitir la función de linterna).
Parámetros:
: enable - El valor por defecto es «false». Al pasar «true» o «false»,
se indica si el editor debe activar o desactivar el flash de la cámara
cuando esté disponible.
setCameraZoomFactor
public void setCameraZoomFactor(float cameraZoomFactor)
El factor de zoom (relación) preferido para la cámara. Un valor de 1,0 indica que no hay zoom (vista predeterminada). El valor oscila entre 0,5 y el factor de zoom máximo. Los valores entre 0,5 y 1,0 corresponden a un gran angular extremo (alejamiento) y los valores entre 1,0 y el factor de zoom máximo corresponden a un acercamiento. El factor de zoom real aplicado se limita automáticamente al rango admitido por la configuración de la cámara activa: si la cámara no admite el ultra gran angular, los factores de zoom establecidos por debajo de 1,0 no surtirán efecto y no se aplicará ningún zoom. Para valores superiores al factor de zoom máximo admitido por la cámara, el factor de zoom se establecerá en el valor máximo. Si la cámara del editor está habilitada, al obtener esta propiedad se devuelve el factor de zoom actual; si la cámara del editor no está habilitada, al obtener esta propiedad se devuelve el factor de zoom preferido.
Parámetros:
: cameraZoomFactor - Al establecer esta propiedad se indica el nivel de zoom deseado,
siendo 1,0 el valor que corresponde a la vista sin zoom (la vista predeterminada).
cycleCamera
public void cicloCámara()
Alterna entre las cámaras, si hay varias cámaras en el dispositivo. Cuando
cambia la cámara que utiliza el editor, el
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
se llama el método.
cambiar de cámara
@Obsoleto public void cambiarCámara()
En desuso.
Este método está obsoleto. Debes utilizar el nuevo cycleCamera() método para alternar
entre cámaras, si hay varias cámaras en el dispositivo.
Si utilizas un capturador de vídeo personalizado, implementa el
BaseVideoCapturer.CaptureSwitch interfaz en el objeto que hereda de
BaseVideoCapturer, e implementar la
BaseVideoCapturer.CaptureSwitch.swapCamera(int cameraId) método para definir el comportamiento
del Publisher.swapCamera() método.
getCameraId
@Obsoleto public int getCameraId()
En desuso.
Devuelve el identificador de la cámara activa en ese momento. Este valor es 0 (para la
cámara trasera) o 1 (para la cámara frontal). Si
setCameraId(int) nunca se invoca, el valor de retorno es 1 (para la
cámara frontal).
Este método está obsoleto. Debes utilizar el nuevo cycleCamera() método para alternar
entre cámaras, si hay varias cámaras en el dispositivo.
onCameraChanged
protected void onCameraChanged(int newCameraId)
Se invoca cuando el editor cambia la cámara activa.
Si heredas de la clase Publisher, puedes sobrescribir este método en lugar del
onCameraChanged() método de la interfaz Publisher.CameraListener
.
Parámetros:
: newCameraId - El ID de la nueva cámara activa.
onCameraError
protected void onCameraError(OpentokError (error)
Se invoca cuando se produce un error al acceder a la cámara.
Parámetros:
: error - El error.
startPreview
@Obsoleto public void iniciarVistaPrevia()
En desuso.
A partir de la versión 2.17.0, este método no realiza ninguna acción. En cuanto se crea el objeto Publisher, el vídeo de la cámara se muestra en la vista del Publisher. Este cambio hace que el comportamiento sea coherente en todos los SDK de cliente de OpenTok.