Visión general

Un editor captura una transmisión de audio y vídeo desde el micrófono y la cámara del dispositivo. A continuación, puedes publicar la transmisión de audio y vídeo en una sesión de OpenTok enviando el [OTSession publish:error:] mensaje.

El SDK de OpenTok para iOS permite la publicación en todos los dispositivos iOS multinúcleo. Consulta la sección «Requisitos para desarrolladores y clientes» del archivo README correspondiente al SDK de OpenTok para iOS.

Ten en cuenta que, al realizar pruebas en el simulador de iOS, un objeto OTPublisher utiliza un vídeo de demostración, ya que la cámara no está disponible en el simulador.

Inicialización de un editor

– initWithDelegate:settings:

Inicializa el editor con los parámetros definidos por un OTPublisherSettings objeto.

- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate settings:(nonnull OTPublisherSettings *)settings

Parámetros

Declarado en

OTPublisher.h

– initWithDelegate:name:cameraResolution:cameraFrameRate:

Inicializar un objeto Publisher.

- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate name:(nullable NSString *)name cameraResolution:(OTCameraCaptureResolution)cameraResolution cameraFrameRate:(OTCameraCaptureFrameRate)cameraFrameRate

Parámetros

Valor devuelto

El puntero a la instancia, o nil si la inicialización ha fallado.

Debate

Este método está obsoleto. Utiliza [OTPublisher initWithDelegate:settings:] en su lugar.

Este método incluye parámetros para configurar la resolución y la frecuencia de fotogramas del vídeo del editor. Si utilizas un método de inicialización heredado de OTPublisherKit, la resolución será VGA y la frecuencia de fotogramas será de 30 fotogramas por segundo.

En el caso de las sesiones que utilizan OpenTok Media Router (en sesiones en las que el modo multimedia esté configurado como «enrutado»), reducir la frecuencia de fotogramas o la resolución reduce el ancho de banda máximo que puede utilizar la transmisión. Sin embargo, en sesiones en las que el modo multimedia esté configurado como «retransmitido», es posible que reducir la frecuencia de fotogramas o la resolución no reduzca el ancho de banda de la transmisión.

Declarado en

OTPublisher.h

Reproducción del vídeo

view

La vista para este editor. Si esta vista se hace visible, mostrará una vista previa de la señal de la cámara activa.

@property (readonly) UIView *view

Declarado en

OTPublisher.h

viewScaleBehavior

El escalado del vídeo renderizado, tal y como se define en el OTVideoViewScaleBehavior enum. El valor por defecto es OTVideoViewScaleBehaviorFill. Configúralo como OTVideoViewScaleBehaviorFit para que el vídeo se reduzca, según sea necesario, de modo que se vea el vídeo completo (con bandas negras). Esta propiedad solo afecta al vídeo del editor local. Los suscriptores de la transmisión deben establecer el [OTSubscriber viewScaleBehavior] propiedad.

@property (nonatomic) OTVideoViewScaleBehavior viewScaleBehavior

Declarado en

OTPublisher.h

Configuración del dispositivo del editor

cameraPosition

La posición preferida de la cámara. Al establecer esta propiedad, si el cambio es posible, el editor utilizará la cámara con la posición especificada. Si el editor ha comenzado a publicar, al consultar esta propiedad se obtiene la posición actual de la cámara; si el editor aún no ha comenzado a publicar, al consultar esta propiedad se obtiene la posición preferida de la cámara.

@property (nonatomic) AVCaptureDevicePosition cameraPosition

Declarado en

OTPublisher.h

cameraTorch

El modo de linterna preferido para la cámara. Al establecer esta propiedad en SÍ o NO, se indica si el desarrollador debe activar o desactivar la linterna de la cámara cuando esté disponible. Ten en cuenta que se trata de una preferencia y puede que no surta efecto si la cámara activa no admite la función de luz de la cámara (por ejemplo, la cámara frontal normalmente no admite la luz de la cámara). Si la cámara del editor está activada, al consultar esta propiedad se devuelve el modo de flash actual; si la cámara del editor no está activada, al consultar esta propiedad se devuelve el modo de flash preferido.

@property (nonatomic) BOOL cameraTorch

Declarado en

OTPublisher.h

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.

@property (nonatomic) float cameraZoomFactor

Declarado en

OTPublisher.h