Velocidad de bits máxima del editor

Este tema incluye información detallada sobre cómo configurar la tasa de bits máxima de vídeo mediante el Vonage Client SDK para Windows:

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 VideoBitratePreset La enumeración incluye valores predefinidos:

  • Default
  • BwSaver
  • ExtraBwSaver
  • Custom

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

Para recuperar el ajuste preestablecido de velocidad de bits de vídeo configurado actualmente para un editor determinado, accede a la Publisher.VideoBitratePreset propiedad:

var preset = publisher.VideoBitratePreset;
if (preset == VideoBitratePreset.BwSaver)
{
    Console.WriteLine("The publisher is using the BW_SAVER preset.");
}

Para establecer una preselección, pulse el botón Publisher.VideoBitratePreset asignar a la propiedad un valor procedente de laVideoBitratePreset enum. No utilice la función Custom valor.

Ejemplo:

publisher.VideoBitratePreset = VideoBitratePreset.BwSaver;
Console.WriteLine("Bitrate preset successfully set to BW_SAVER.");

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 actual (en bits por segundo), acceda a la función Publisher.MaxVideoBitrate propiedad. Si no se establece ningún valor personalizado, se establece en 0.

Ejemplo:

int maxBitrate = publisher.MaxVideoBitrate;
Console.WriteLine($"Current max video bitrate: {maxBitrate} bps");

Para establecer una tasa de bits máxima personalizada (en lugar de una predefinida), asigna un valor (entre 5.000 y 10.000.000) al MaxVideoBitrate propiedad.

Ejemplo:

int newBitrate = 300000; // 300 kbps
publisher.MaxVideoBitrate = newBitrate;
Console.WriteLine($"Successfully set max video bitrate to {newBitrate} bps.");

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.

int zeroBitrate = 0;  // no limitations
int newBitrate = 300000;

publisher.MaxVideoBitrate = newBitrate;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == newBitrate);

publisher.MaxVideoBitrate = zeroBitrate;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == zeroBitrate);

La configuración de una tasa de bits personalizada hace que el VideoBitratePreset que debe establecerse en VideoBitratePreset.Custom:

publisher.MaxVideoBitrate = 1000000; // 1 Mbps
System.Diagnostics.Debug.Assert(publisher.VideoBitratePreset == VideoBitratePreset.Custom);

publisher.MaxVideoBitrate = 0;
System.Diagnostics.Debug.Assert(publisher.VideoBitratePreset == VideoBitratePreset.Default);

El MaxVideoBitrate La propiedad devuelve 0 cuando el editor utiliza un ajuste preestablecido:

publisher.VideoBitratePreset = VideoBitratePreset.BwSaver;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);

publisher.VideoBitratePreset = VideoBitratePreset.ExtraBwSaver;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);

publisher.MaxVideoBitrate = 200000;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 200000);

publisher.VideoBitratePreset = VideoBitratePreset.Default;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);