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 Client SDK del cliente web de Vonage Video. Ten en cuenta que la API es compatible con las versiones recientes de todos los navegadores compatibles. Si se producen errores, asegúrate de que el cliente utilice una versión actualizada del navegador.

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 objeto Publisher incluye setVideoBitratePreset() y getVideoBitratePreset() métodos. El sitio setVideoBitratePreset() acepta valores de cadena - 'DEFAULT', 'BW_SAVER', o 'EXTRA_BW_SAVER' (o sus minúsculas) - y el método getVideoBitratePreset() devuelve estos valores valores (o 'CUSTOM'). Véase Preajustes de velocidad de bits de vídeo para obtener más información sobre estos ajustes predefinidos.

Tenga en cuenta que getVideoBitratePreset() el método devuelve undefined si no se ha establecido previamente ningún preajuste o tasa de bits.

El setVideoBitratePreset() El método tiene un parámetro: preset, la presintonía deseada.

Ejemplo:

console.log(publisher.getVideoBitratePreset());  // undefined

await publisher.setVideoBitratePreset('BW_SAVER');  // or 'DEFAULT' or 'EXTRA_BW_SAVER'

console.log(publisher.getVideoBitratePreset());  // 'BW_SAVER'

El setVideoBitratePreset() puede lanzar un error con el método name del objeto de error con el siguiente valor:

  • OT_INVALID_PARAMETER - Preajuste no válido. Debe ser 'DEFAULT', 'BW_SAVER', o 'EXTRA_BW_SAVER'.

  • OT_UNEXPECTED_ERROR_CODE - Se ha producido un error inesperado y el preajuste no se ha actualizado.

Envuelve la llamada a la setVideoBitratePreset() en un bloque try/catch, aunque el nombre de la preselección sea correcto:

const invalidPreset = 'VERY_FAST';

try {
    await publisher.setVideoBitratePreset(invalidPreset);
} catch (err) {
    console.error(err.name);
    // 'OT_INVALID_PARAMETER'
}

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, llame a la función getMaxVideoBitrate() de un objeto Publisher. Devuelve la tasa de bits máxima establecida actualmente (en bits por segundo). Si no se establece ningún valor personalizado, la función devuelve undefined.

Ejemplo:

console.log(publisher.getMaxVideoBitrate());

Para establecer un valor de velocidad de bits máxima personalizada (en lugar de una preajustada), utiliza la setMaxVideoBitrate() método de un objeto Publisher. Esta función tiene un único parámetro: bitrateBpsel bitrate máximo deseado (en bits por segundo), entre 5.000 y 10.000.000.

Ejemplo:

const new_bitrate = 300000; // 300 kbps
await publisher.setMaxVideoBitrate(new_bitrate);

El setMaxVideoBitrate() puede lanzar un error con el método name del objeto de error con el siguiente valor:

  • OT_INVALID_PARAMETER - Tasa de bits no válida. El valor debe ser 0 o un número entre 5000 y 10000000.
  • OT_UNEXPECTED_ERROR_CODE - Se ha producido un error inesperado y no se ha actualizado la tasa de bits.

Envuelve la llamada a la setVideoBitratePreset() en un bloque try/catch, aunque el número introducido sea válido.

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

Casos especiales

Si se establece el valor máximo de la tasa de bits en 0, se elimina cualquier limitación de tasa de bits establecida anteriormente y se vuelve al comportamiento predeterminado.

const zero_bitrate = 0;  // no limitations
const int new_bitrate = 300000; // 300 kbps
publisher.setMaxVideoBitrate(new_bitrate);
// publisher.getMaxVideoBitrate() === 300000

publisher.setMaxVideoBitrate(zero_bitrate);
// publisher.getMaxVideoBitrate() === 0

Llamada al getVideoBitratePreset() tras establecer una tasa de bits personalizada distinta de 0 devuelve CUSTOM.

const zero_bitrate = 0;  // no limitations
const new_bitrate = 1000000; // 1 mbps
publisher.setMaxVideoBitrate(new_bitrate);
// publisher.getVideoBitratePreset() === 'CUSTOM'

publisher.setMaxVideoBitrate(zero_bitrate);
// publisher.getVideoBitratePreset() === 'DEFAULT'

El indicador de tasa de bits bruta devuelve 0 cuando el editor utiliza un preajuste.

let bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0

publisher.setVideoBitratePreset('bw_saver);
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0

publisher.setVideoBitratePreset('extra_bw_saver');
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0

publisher.setMaxVideoBitrate(200000);
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 200000

publisher.setVideoBitratePreset('default');
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0