Camera.setQuality()

Disponibilidad

Flash Player 6.

Sintaxis

active_cam.setQuality(bandwidth, frameQuality)

Parámetros

bandwidth Número entero que especifica la cantidad máxima de ancho de banda que puede utilizar la salida de vídeo actual, expresada en bytes por segundo. Para especificar que un vídeo Flash pueda utilizar todo el ancho de banda que sea necesario para mantener el valor de frameQuality, pase 0 para bandwidth. El valor predeterminado es 16384.

frameQuality Número entero que especifica el nivel necesario de calidad de la imagen, según lo determina la cantidad de compresión que se aplique a cada fotograma de vídeo. El rango de valores aceptables oscila entre 1 (calidad inferior, compresión máxima) y 100 (calidad superior, sin compresión). Para especificar que la calidad de la imagen puede variar según sea necesario para evitar que se sobrepase el ancho de banda, pase 0 para frameQuality. El valor predeterminado es 0.

Valor devuelto

Ninguno.

Descripción

Método; establece la cantidad máxima de ancho de banda por segundo o la calidad de imagen necesaria de la salida de vídeo actual. Este método generalmente sólo puede aplicarse si se transmite vídeo mediante Flash Communication Server.

Utilice este método para especificar qué elemento de salida de vídeo es más importante para la aplicación: el uso de ancho de banda o la calidad de la imagen.

• Para indicar que el uso del ancho de banda es prioritario, pase un valor para bandwidth y 0 para frameQuality. Flash transmitirá el vídeo a la calidad máxima posible utilizando el ancho de banda especificado. Si es necesario, Flash reducirá la calidad de la imagen para evitar que se sobrepase el ancho de banda especificado. Por lo general, cuando aumenta el movimiento, disminuye la calidad.
• Para indicar que la calidad es prioritaria, pase el valor 0 para bandwidth y un valor numérico para frameQuality. Flash utilizará todo el ancho de banda que sea necesario para mantener la calidad especificada. Si es necesario, Flash reducirá la velocidad de fotogramas para mantener la calidad de la imagen. Por lo general, cuando aumenta el movimiento, también aumenta el ancho de banda.
• Para especificar que el ancho de banda y la calidad tienen la misma importancia, pase un valor numérico para ambos parámetros. Flash transmitirá vídeo que cumpla la calidad especificada y que no sobrepase el ancho de banda indicado. Si es necesario, Flash reducirá la velocidad de fotogramas para mantener la calidad de la imagen sin sobrepasar el ancho de banda especificado.

Ejemplo

En los ejemplos siguientes se ilustra cómo utilizar este método para controlar el uso del ancho de banda y la calidad de la imagen.

// Garantizar que no se utilizan más de 8192 (8K/segundo) para enviar vídeo
active_cam.setQuality(8192,0);

// Garantizar que no se utilizan más de 8192 (8K/segundo) para enviar vídeo
// con una calidad mínima de 50
active_cam.setQuality(8192,50);

// Garantizar una calidad mínima de 50, independientemente del ancho de banda necesario
active_cam.setQuality(0,50);

Véase también

Camera.bandwidth, Camera.quality