Taxa de bits máxima do editor
Este tópico inclui detalhes sobre como usar a taxa de bits máxima do Publisher no Client SDK do Vonage Video para iOS:
- Definir e recuperar uma predefinição
- Definir e recuperar um valor de taxa de bits bruta
- Casos especiais
Para obter uma visão geral da API de taxa de bits máxima do editor, consulte esse assunto.
Definir e recuperar uma predefinição
O OTVideoBitratePreset A enumeração inclui valores predefinidos:
OTVideoBitratePresetDefaultOTVideoBitratePresetBwSaverOTVideoBitratePresetExtraBwSaverOTVideoBitratePresetCustom
Veja Predefinições de taxa de bits de vídeo para obter mais detalhes sobre essas predefinições.
Para recuperar a predefinição de taxa de bits de vídeo atualmente configurada para um determinado editor, defina o OTPublisherKit.videoBitratePreset propriedade:
OTVideoBitratePreset retrievedBitratePreset = publisher.videoBitratePreset;
NSLog(@"The video bitrate preset is: %ld", (long)retrievedBitratePreset);
Para definir uma predefinição, atribua um valor ao videoBitratePreset propriedade. Essa propriedade aceita um dos valores da OTVideoBitratePreset
enum, exceto OTVideoBitratePresetCustom.
Exemplo:
publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;
Definir e recuperar um valor de taxa de bits bruta
Se as predefinições não forem adequadas, você pode definir manualmente um valor personalizado de taxa de bits bruta.
Para verificar a taxa de bits máxima de vídeo definida atualmente para um editor, consulte o OTPublisherKit.maxVideoBitrate propriedade. Ela é definida com a taxa de bits máxima (em bits por segundo). Se nenhum valor personalizado for definido, a propriedade será definida como 0.
Exemplo:
int retrievedMaxVideoBitrate = publisher.maxVideoBitrate;
NSLog(@"The maximum video bitrate is: %d kbps", retrievedMaxVideoBitrate);
Para usar um valor personalizado de taxa de bits máxima (em vez de uma predefinição), defina o OTPublisherKit.maxVideoBitrate propriedade. Essa propriedade aceita valores entre 5.000 e 10.000.000 (em bits por segundo).
Exemplo:
publisher.maxVideoBitrate = 300000; // 300 kbps
Veja Definição de valores de taxa de bits bruta para mais detalhes.
Casos especiais
Definir o valor da taxa de bits bruta como 0 remove qualquer limitação de taxa de bits definida anteriormente, retornando ao comportamento padrão.
publisher.maxVideoBitrate = 300000; // Set the maximum video bitrate to 300 kbps
NSLog(@"Max video bitrate set successfully to: %d", publisher.maxVideoBitrate);
publisher.maxVideoBitrate = 0; // Reset the maximum video bitrate to the default behavior
NSLog(@"Max video bitrate reset to default: %d", publisher.maxVideoBitrate);
Depois de definir uma taxa de bits personalizada, o videoBitratePreset a propriedade está definida como OTVideoBitratePresetCustom.
publisher.maxVideoBitrate = 1000000; // Set a custom bitrate to 1 Mbps
if (publisher.videoBitratePreset == OTVideoBitratePresetCustom) {
NSLog(@"Video bitrate preset set to CUSTOM.");
}
publisher.maxVideoBitrate = 0; // Reset bitrate to default
if (publisher.videoBitratePreset == OTVideoBitratePresetDefault) {
NSLog(@"Video bitrate preset reset to DEFAULT.");
}
O publisher.maxVideoBitrate A propriedade é definida como 0 quando o editor está usando uma predefinição.
NSLog(@"Default bitrate: %d", publisher.maxVideoBitrate); // Default should be 0
publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;
NSLog(@"Bitrate for BW_SAVER preset: %d", publisher.maxVideoBitrate); // Should be 0
publisher.videoBitratePreset = OTVideoBitratePresetExtraBwSaver;
NSLog(@"Bitrate for EXTRA_BW_SAVER preset: %d", publisher.maxVideoBitrate); // Should be 0
publisher.maxVideoBitrate = 200000; // Set a custom bitrate
NSLog(@"Custom bitrate: %d", publisher.maxVideoBitrate);
publisher.videoBitratePreset = OTVideoBitratePresetDefault; // Reset to default preset
NSLog(@"Bitrate after reset to DEFAULT preset: %d", publisher.maxVideoBitrate); // Should be 0