OTPublisher

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 [publicar:error:] mensaje.

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

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

Propiedades

Nombre Tipo Descripción
view UIView * La vista de este editor. Si esta vista se hace visible, mostrará una vista previa de la señal de la cámara activa.
viewScaleBehavior OTVideoViewScaleBehavior El escalado del vídeo renderizado, tal y como se define en la enumeración OTVideoViewScaleBehavior. El valor por defecto es OTVideoViewScaleBehaviorFill. Establece este valor en OTVideoViewScaleBehaviorFit para que el vídeo se reduzca, según sea necesario, de modo que se vea en su totalidad (con bandas negras). Esta propiedad solo afecta al vídeo del editor local. Los suscriptores de la transmisión deben establecer el [OTSuscriptor Propiedad [viewScaleBehavior].
cameraPosition AVCaptureDevicePosition 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.
cameraTorch BOOL 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 que 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 no suele admitirla). Si la cámara del editor está activada, al consultar esta propiedad se obtiene el modo de luz actual; si la cámara del editor no está activada, al consultar esta propiedad se obtiene el modo de luz preferido.
cameraZoomFactor flotante 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 (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 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.

Métodos

Nombre Descripción
initWithDelegate:settings:(delegate, settings) → {instancetype} Inicializa el editor con los parámetros definidos por un OTPublisherSettings objeto.
initWithDelegate:name:cameraResolution:cameraFrameRate:(delegate, name, cameraResolution, __attribute) → {instancetype} Inicializar un objeto Publisher.

initWithDelegate:settings:(delegate, settings) → {instancetype}

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

Parámetros:
Nombre Tipo Descripción
delegate id<OTPublisherKitDelegate> El delegado (OTPublisherKitDelegate) objeto para el editor.
settings OTPublisherSettings * El (OTPublisherSettings) objeto que define la configuración del editor.
Devoluciones:

initWithDelegate:name:cameraResolution:cameraFrameRate:(delegate, name, cameraResolution, __attribute) → {instancetype}

Inicializar un objeto Publisher.

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 velocidad 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 el OpenTok Media Router (en sesiones en las que el modo multimedia esté configurado como «enrutado»), reducir la frecuencia de fotogramas o la resolución disminuye 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.

Parámetros:
Nombre Tipo Descripción
delegate id<OTPublisherKitDelegate> El delegado (OTPublisherKitDelegate) objeto para el editor.
name NSString * El nombre que aparecerá al final del vídeo.
cameraResolution OTCameraCaptureResolution La resolución del vídeo publicado. Establece este valor en uno de los valores definidos en la enumeración OTCameraCaptureResolution.
__attribute (obsoleto(("Utiliza en su lugar initWithDelegate: settings:")))
Devoluciones:

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