Velocidad de bits máxima del editor

Este tema incluye información detallada sobre cómo utilizar la tasa de bits máxima del editor en el Client SDK de Vonage Video para iOS:

Para obtener una descripción general de la API de velocidad de bits máxima del editor, consulta este tema.

Configuración y recuperación de un preajuste

El OTVideoBitratePreset La enumeración incluye valores predefinidos:

  • OTVideoBitratePresetDefault
  • OTVideoBitratePresetBwSaver
  • OTVideoBitratePresetExtraBwSaver
  • OTVideoBitratePresetCustom

Véase Preajustes de velocidad de bits de vídeo para más detalles sobre estos preajustes.

Para recuperar el preajuste de velocidad de bits de vídeo configurado actualmente para un editor determinado, establezca la opción OTPublisherKit.videoBitratePreset propiedad:

OTVideoBitratePreset retrievedBitratePreset = publisher.videoBitratePreset;
NSLog(@"The video bitrate preset is: %ld", (long)retrievedBitratePreset);

Para establecer una preselección, asigne un valor a la tecla videoBitratePreset propiedad. Esta propiedad admite uno de los valores de la OTVideoBitratePreset excepto para OTVideoBitratePresetCustom.

Ejemplo:

publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;

Establecer y recuperar un valor de velocidad de bits sin procesar

Si los preajustes predefinidos no son adecuados, puedes establecer manualmente un valor de tasa de bits brutos personalizado.

Para obtener la tasa de bits de vídeo máxima establecida actualmente para un editor, compruebe la opción OTPublisherKit.maxVideoBitrate propiedad. Establece el bitrate máximo (en bits por segundo). Si no se establece ningún valor personalizado, la propiedad se establece en 0.

Ejemplo:

int retrievedMaxVideoBitrate = publisher.maxVideoBitrate;
NSLog(@"The maximum video bitrate is: %d kbps", retrievedMaxVideoBitrate);

Para utilizar un valor de velocidad de bits máxima personalizada (en lugar de una preajustada), configura el OTPublisherKit.maxVideoBitrate propiedad. Esta propiedad admite valores comprendidos entre 5.000 y 10.000.000 (en bits por segundo).

Ejemplo:

publisher.maxVideoBitrate = 300000; // 300 kbps

Véase Ajuste de los valores de la tasa de bits bruta Para más información.

Casos especiales

Al establecer el valor de la tasa de bits bruta en 0 se elimina cualquier limitación de la tasa de bits establecida previamente, volviendo al comportamiento predeterminado.

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);

Después de establecer una tasa de bits personalizada, el videoBitratePreset se establece en 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.");
}

El publisher.maxVideoBitrate se establece en 0 cuando el editor utiliza un preajuste.

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