MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual page 327

Description
Method; sets the maximum amount of bandwidth per second or the required picture quality of
the current outgoing video feed. This method is generally applicable only if you are transmitting
video using Flash Communication Server.
Use this method to specify which element of the outgoing video feed is more important to your
application—bandwidth use or picture quality.
•
To indicate that bandwidth use takes precedence, pass a value for
. Flash will transmit video at the highest quality possible within the specified
frameQuality
bandwidth. If necessary, Flash will reduce picture quality to avoid exceeding the specified
bandwidth. In general, as motion increases, quality decreases.
•
To indicate that quality takes precedence, pass 0 for
. Flash will use as much bandwidth as required to maintain the specified quality.
frameQuality
If necessary, Flash will reduce the frame rate to maintain picture quality. In general, as motion
increases, bandwidth use also increases.
•
To specify that both bandwidth and quality are equally important, pass numeric values for
both parameters. Flash will transmit video that achieves the specified quality and that doesn't
exceed the specified bandwidth. If necessary, Flash will reduce the frame rate to maintain
picture quality without exceeding the specified bandwidth.
Example
The following examples illustrate how to use this method to control bandwidth use and
picture quality.
// Ensure that no more than 8192 (8K/second) is used to send video
active_cam.setQuality(8192,0);
// Ensure that no more than 8192 (8K/second) is used to send video
// with a minimum quality of 50
active_cam.setQuality(8192,50);
// Ensure a minimum quality of 50, no matter how much bandwidth it takes
active_cam.setQuality(0,50);
See also
Camera.bandwidth
,
Camera.quality
bandwidth
and a numeric value for
bandwidth
Camera.setQuality()
and 0 for
327