Visão geral

Define as configurações a serem utilizadas ao inicializar um editor por meio do [OTPublisherKit initWithDelegate:settings:] método.

Definindo as configurações do editor

name

O nome do vídeo do editor. O [Nome do OTStream] A propriedade de um stream publicado por esse editor será definida com esse valor (em todos os clientes). O valor padrão é nil.

@property (nonatomic, copy, nullable) NSString *name

Declarado em

OTPublisherKit.h

audioTrack

Se deve publicar o áudio (SIM, é a configuração padrão) ou não (NÃO).

@property (nonatomic) BOOL audioTrack

Discussão

Se essa propriedade for definida como NÃO, o subsistema de áudio não será inicializado para o editor, e definir o [OTPublisherKit publishAudio] propriedade não terá efeito. Se sua aplicação não exigir o uso de áudio, recomenda-se definir essa propriedade do Builder em vez de usar o [OTPublisherKit publishAudio] propriedade, que desativa apenas temporariamente a trilha de áudio.

Declarado em

OTPublisherKit.h

videoTrack

Se deve publicar o vídeo (SIM, é a opção padrão) ou não (NÃO).

@property (nonatomic) BOOL videoTrack

Discussão

Se essa propriedade for definida como NÃO, o subsistema de vídeo não será inicializado para o editor, e definir a [OTPublisherKit publishVideo] propriedade não terá efeito. Se sua aplicação não exigir o uso de vídeo, recomenda-se definir essa propriedade do Builder em vez de usar o [OTPublisherKit publishVideo] propriedade, que desativa apenas temporariamente a trilha de vídeo.

Declarado em

OTPublisherKit.h

senderStatsTrack

Se as estatísticas do remetente devem ser publicadas (SIM) ou não (NÃO, opção padrão).

@property (nonatomic) BOOL senderStatsTrack

Discussão

Se essa propriedade for definida como NÃO, o subsistema de estatísticas do remetente não será inicializado para o editor.

Declarado em

OTPublisherKit.h

audioBitrate

A taxa de bits desejada para o áudio transmitido, em bits por segundo. O intervalo de valores aceito é de 6.000 a 510.000. (Valores inválidos são ignorados.) Defina esse valor para ativar o áudio de alta qualidade (ou para reduzir o uso de largura de banda com áudio de qualidade inferior).

@property (nonatomic) int audioBitrate

Discussão

A seguir, apresentamos as configurações recomendadas:

• 8.000 – 12.000 para voz em banda estreita (NB)
• 16.000 – 20.000 para fala em banda larga (WB)
• 28.000 – 40.000 para fala em banda completa (FB)
• 48.000 – 64.000 para música mono em banda completa (FB)
• 64.000 – 128.000 para música estéreo em banda completa (FB)

O valor padrão é 40.000.

Para definir outras configurações de áudio, consulte o OTAudioDeviceManager interface.

Declarado em

OTPublisherKit.h

enableOpusDtx

Se deve ser ativado Opus DTX (SIM) ou não (NÃO, a configuração padrão). Ativar o Opus DTX pode reduzir o uso de largura de banda em transmissões que apresentam longos períodos de silêncio.

@property (nonatomic) BOOL enableOpusDtx

Declarado em

OTPublisherKit.h

scalableScreenshare

Se deve permitir o uso de vídeo escalável para um editor cujo atributo `videoType` esteja definido como `OTStreamVideoTypeScreen` (SIM) ou não (NÃO, o padrão).

@property (nonatomic) BOOL scalableScreenshare

Declarado em

OTPublisherKit.h

subscriberAudioFallbackEnabled

Se a transmissão utilizará o recurso de fallback de áudio do assinante (YES) ou não (NO), para assinantes do fluxo publicado. O recurso de fallback de áudio do assinante está disponível em sessões que utilizam o OpenTok Media Router. Com o recurso de fallback de áudio do assinante ativado, quando o OpenTok Media Router determinar que a qualidade de uma transmissão se deteriorou significativamente para um assinante específico, ele desativa o vídeo desse assinante a fim de preservar a qualidade da chamada.

@property (nonatomic, assign) BOOL subscriberAudioFallbackEnabled

Discussão

A configuração padrão é YES (o recurso de fallback de áudio está ativado) para editores que utilizam a câmera. Ao utilizar o tipo de vídeo de tela em uma sessão que utiliza o OpenTok Media Server, a propriedade de fallback de áudio do assinante é definida como NO por padrão, para que o vídeo não pare de ser exibido para os inscritos.

Para obter mais informações, consulte [OTPublisherKit videoType], [OTSubscriberKitDelegate subscriberVideoDisabled:reason:], OTSubscriberVideoEventReason, o OpenTok Media Router.

Declarado em

OTPublisherKit.h

publisherAudioFallbackEnabled

Se a transmissão utilizará o recurso de fallback de áudio do editor (YES) ou não (NO). Com o recurso de fallback de áudio do Publisher ativado, quando o Publisher determina que a qualidade de um stream se deteriorou significativamente, ele desativa o vídeo para preservar a qualidade da chamada.

@property (nonatomic, assign) BOOL publisherAudioFallbackEnabled

Discussão

A configuração padrão é NO (o recurso de alternância de áudio está desativado).

Para obter mais informações, consulte [OTPublisherKit videoType], [OTPublisherKitDelegate publisherVideoDisabled:reason:], OTPublisherVideoEventReason, o OpenTok Media Router.

Declarado em

OTPublisherKit.h

allowAudioCaptureWhileMuted

Se definido como NÃO, o microfone será desligado automaticamente quando todos os emissores tiverem silenciado seu áudio. O microfone será ligado automaticamente novamente quando pelo menos um emissor desativar o silenciamento do áudio. Se definido como SIM, o microfone permanecerá sempre ligado, mesmo quando todos os emissores tiverem silenciado seu áudio. Esteja ciente de que, quando o microfone estiver desligado, callbacks como AudioLevel ou AudioData não serão mais invocados para os editores. O valor padrão é NÃO.

@property (nonatomic) BOOL allowAudioCaptureWhileMuted

Declarado em

OTPublisherKit.h

videoCodecPreference

Define o(s) codec(s) de vídeo preferido(s) para publicação.

@property (nonatomic, nullable) OTVideoCodecPreference *videoCodecPreference

Discussão

Use esta propriedade para controlar quais codecs de vídeo têm prioridade durante a negociação. Se não for definida, o SDK usa a preferência padrão de codec do projeto. Atribua uma instância de OTVideoCodecPreference para especificar se a seleção do codec deve ser automática ou para fornecer uma lista explícita e ordenada de codecs.

• Definir como [OTVideoCodecPreference automatic] para permitir que o SDK selecione o codec mais adequado.
• Definir como [OTVideoCodecPreference manualWithCodecs:...] para especificar explicitamente uma ordem de preferência na negociação de codecs. Codecs suportados: OTVideoCodecTypeVP8, OTVideoCodecTypeH264, OTVideoCodecTypeVP9.

Se for fornecida uma lista de codecs inválida (por exemplo, um array vazio ou um valor de codec desconhecido), a inicialização do editor falhará.

Para obter detalhes sobre a seleção de codecs e os valores válidos, consulte OTVideoCodecPreference.

Declarado em

OTPublisherKit.h