El número de segundos que se tarda en precargar un flujo de sonido en un búfer antes de que el sonido comience a reproducirse.

Tenga en cuenta que no es posible anular el valor de SoundLoaderContext.bufferTime estableciendo la propiedad global SoundMixer.bufferTime. La propiedad SoundMixer.bufferTime afecta al tiempo de búfer en los flujos de sonido incorporados de un archivo SWF y no tiene nada que ver con los objetos Sound creados dinámicamente (es decir, objetos Sound creados con ActionScript).

Especifica si Flash Player debe intentar descargar un archivo de política entre dominios desde el servidor del sonido cargado antes de comenzar la carga del mismo. Esta propiedad se aplica a sonidos cargados desde fuera del dominio del archivo SWF que llama con el método Sound.load().

Establezca esta propiedad como true al cargar un sonido desde fuera del dominio del archivo SWF que llama y podrá acceder a los datos del sonido de ActionScript con privilegios de acceso de bajo nivel. Algunos ejemplos de acceso de bajo nivel a los datos de un sonido son la propiedad Sound.id3 para obtener un objeto ID3Info o llamar al método SoundMixer.computeSpectrum() para obtener muestras del sonido cargado. Si intenta acceder a los datos de sonido sin establecer la propiedad checkPolicyFile como true en el momento de la carga, es posible que obtenga una excepción SecurityError, ya que no ha descargado el archivo de política necesario.

Si no necesita privilegios de acceso de bajo nivel para los datos de sonido que está cargando, no establezca checkPolicyFile en true. La búsqueda de un archivo de política consume ancho de banda de la red y podría demorar el inicio de la descarga, por lo que sólo debe hacerse si es necesario.

Al llamar a Sound.load() con SoundLoaderContext.checkPolicyFile establecido en true, Flash Player debe descargar correctamente un archivo de política entre dominios adecuado o determinar que no existe ninguno antes de comenzar la descarga del sonido especificado. Flash Player lleva a cabo las acciones siguientes (en el orden indicado) para comprobar la existencia de un archivo de política:

• Flash Player tiene en cuenta los archivos de política ya descargados.
• Flash Player intenta descargar cualquier archivo de política especificado en las llamadas a Security.loadPolicyFile().
• Flash Player intenta descargar un archivo de política desde la ubicación predeterminada correspondiente a la URL del sonido, que es /crossdomain.xml en el mismo servidor que URLRequest.url. (La URL del sonido se especifica en la propiedad url del objeto URLRequest transmitido a Sound.load() o al constructor Sound).

En todos los casos, Flash Player necesita que exista un archivo de política adecuado en el servidor del sonido, que proporcione acceso al archivo de sonido en URLRequest.url de acuerdo con la ubicación del archivo de política, y que permita que el dominio acceda al archivo SWF que realiza la llamada gracias a una o varias etiquetas <allow-access-from>.

Si establece checkPolicyFile en true, Flash Player espera a que se verifique el archivo de política antes de cargar el sonido. Para poder realizar operaciones de bajo nivel en los datos de sonido, como llamar a Sound.id3 o a SoundMixer.computeSpectrum(), debe esperar a que los eventos progress y complete se distribuyan desde el objeto Sound.

Si define checkPolicyFile como true, pero no se encuentra ningún archivo de política adecuado, no recibirá ningún error hasta que no se realice alguna operación que requiera un archivo de política; cuando esto ocurra, Flash Player emitirá una excepción SecurityError. Tras recibir un evento complete, se puede comprobar si el archivo de política correspondiente se encontró mediante la obtención del valor de Sound.id3 en un bloque try y comprobando si se emitía una excepción SecurityError.

Tenga cuidado con checkPolicyFile si descarga un sonido desde una URL que utilice redirección HTTP en el servidor. Flash Player intenta recuperar archivos de política que correspondan a la propiedad url del objeto URLRequest transmitida a Sound.load(). Si el archivo de sonido final proviene de una URL distinta por la redirección HTTP, es posible que los archivos de política descargados inicialmente no se puedan aplicar a la URL final del archivo de sonido, que es la URL determinante en las decisiones de seguridad.

Si se encuentra en esta situación, le presentamos una posible solución. Tras recibir un evento progress o complete, puede examinar el valor de la propiedad Sound.url, que contiene la URL final del sonido. A continuación, llame al método Security.loadPolicyFile() con una URL de archivo de política calculada según la URL final del sonido. Finalmente, sondee el valor de Sound.id3 hasta que deje de emitir excepciones.

Para más información acerca de los archivos de política, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0.

Véase también

Crea un nuevo objeto contextual de carga de sonido.

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundLoaderContext;
    import flash.events.IOErrorEvent;

    public class SoundLoaderContextExample extends Sprite {

        public function SoundLoaderContextExample() {
            var snd:Sound = new Sound();
            var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
            var context:SoundLoaderContext = new SoundLoaderContext(30000, false);

            snd.load(req, context);
            snd.play();

            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }

        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace("The sound could not be loaded: " + errorEvent.text);
        }

    }
}