Visão geral

Um publisher captura um fluxo de áudio e vídeo a partir do microfone e da câmera do dispositivo. Em seguida, é possível publicar o fluxo de áudio e vídeo em uma sessão do OpenTok, enviando o [OTSession publish:error:] mensagem.

O SDK do OpenTok para iOS oferece suporte à publicação em todos os dispositivos iOS com vários núcleos. Consulte “Requisitos para desenvolvedores e clientes” no arquivo README do SDK do OpenTok para iOS.

Observe que, ao realizar testes no Simulador do iOS, um objeto OTPublisher utiliza um vídeo de demonstração, já que a câmera não está disponível no Simulador.

Inicializando um editor

– initWithDelegate:settings:

Inicialize o editor com as configurações definidas por um OTPublisherSettings objeto.

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

Parâmetros

Declarado em

OTPublisher.h

– initWithDelegate:name:cameraResolution:cameraFrameRate:

Inicialize um objeto Publisher.

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

Parâmetros

Valor de retorno

O ponteiro para a instância, ou nil se a inicialização falhar.

Discussão

Este método está obsoleto. Use [OTPublisher initWithDelegate:settings:] em vez disso.

Esse método inclui parâmetros para definir a resolução e a taxa de quadros do vídeo do editor. Se você usar um método inicializador herdado de OTPublisherKit, a resolução será VGA e a taxa de quadros será de 30 quadros por segundo.

Para sessões que utilizam o OpenTok Media Router (em sessões com o modo de mídia definido como “routed”), diminuir a taxa de quadros ou a resolução reduz a largura de banda máxima que a transmissão pode utilizar. No entanto, em sessões com o modo de mídia definido como “relayed”, diminuir a taxa de quadros ou a resolução pode não reduzir a largura de banda da transmissão.

Declarado em

OTPublisher.h

Exibindo o vídeo

view

A visualização para este editor. Se essa visualização ficar visível, ela exibirá uma pré-visualização da imagem da câmera ativa.

@property (readonly) UIView *view

Declarado em

OTPublisher.h

viewScaleBehavior

O redimensionamento do vídeo renderizado, conforme definido pelo OTVideoViewScaleBehavior enum. O valor padrão é OTVideoViewScaleBehaviorFill. Defina-o como OTVideoViewScaleBehaviorFit para que o vídeo seja reduzido, conforme necessário, de modo que todo o vídeo fique visível (com pillarboxing). Essa propriedade afeta apenas o vídeo do editor local. Os assinantes da transmissão devem definir o [OTSubscriber viewScaleBehavior] propriedade.

@property (nonatomic) OTVideoViewScaleBehavior viewScaleBehavior

Declarado em

OTPublisher.h

Definição da configuração do dispositivo do editor

cameraPosition

A posição preferencial da câmera. Ao definir essa propriedade, se a alteração for possível, o editor utilizará a câmera na posição especificada. Se o editor já tiver iniciado a publicação, a consulta a essa propriedade retorna a posição atual da câmera; se o editor ainda não tiver iniciado a publicação, a consulta a essa propriedade retorna a posição preferencial da câmera.

@property (nonatomic) AVCaptureDevicePosition cameraPosition

Declarado em

OTPublisher.h

cameraTorch

O modo preferencial da lanterna (tocha) para a câmera. Definir essa propriedade como SIM ou NÃO indica se o desenvolvedor deve ativar ou desativar a lanterna da câmera quando disponível. Observe que essa é uma preferência e pode não ter efeito se a câmera ativa não for compatível com a funcionalidade de flash (por exemplo, a câmera frontal normalmente não suporta flash). Se a câmera do editor estiver ativada, a consulta a esta propriedade retorna o modo atual do flash; se a câmera do editor não estiver ativada, a consulta a esta propriedade retorna o modo preferencial do flash.

@property (nonatomic) BOOL cameraTorch

Declarado em

OTPublisher.h

cameraZoomFactor

O fator de zoom (proporção) preferencial para a câmera. Um valor de 1,0 representa a ausência de zoom (a visualização padrão). O valor varia de 0,5 até o fator de zoom máximo. Valores entre 0,5 e 1,0 representam a ultra-grande angular (zoom out) e valores entre 1,0 e o fator de zoom máximo representam o zoom in. O fator de zoom real aplicado é automaticamente limitado ao intervalo suportado pela configuração da câmera ativa — se a câmera não suportar ultra-grande-angular, fatores de zoom definidos abaixo de 1,0 não terão efeito e nenhum zoom será aplicado. Para valores acima do fator de zoom máximo suportado pela câmera, o fator de zoom será definido com o valor máximo. Se a câmera do editor estiver ativada, a consulta a essa propriedade retorna o fator de zoom atual; se a câmera do editor não estiver ativada, a consulta a essa propriedade retorna o fator de zoom preferencial.

@property (nonatomic) float cameraZoomFactor

Declarado em

OTPublisher.h