Количество миллисекунд для предварительной загрузки потокового звука в буфер перед началом передачи звука в поток.

Обратите внимание, что значение SoundLoaderContext.bufferTime нельзя переопределить заданием свойства SoundMixer.bufferTime. Свойство SoundMixer.bufferTime затрагивает только время буферизации для встроенных потоковых звуков в SWF-файле и не зависит от динамически созданных объектов Sound (то есть, объектов Sound, созданных в ActionScript).

Указывает, будет ли проигрыватель Flash Player пытаться загрузить файл политики URL-адресов с сервера загружаемого звука перед началом загрузки самого звука. Это свойство применяется к звуку, загружаемому не с того домена, в котором находится вызывающий SWF-файл, с помощью метода Sound.load().

Этому свойству необходимо задать значение true, когда звук загружается не с домена вызывающего SWF-файла и для доступа к данным звука из ActionScript требуются полномочия низкого уровня. Например, доступ низкого уровня к данным звука требуется для ссылки на свойство Sound.id3 с целью получения объекта ID3Info или для вызова метода SoundMixer.computeSpectrum() для получения образцов загруженного звука При попытке доступа к данным звука без установки значения true для параметра checkPolicyFile во время загрузки можно получить исключение SecurityError, так как требуемый файл политик не был загружен.

Если вам не требуется доступ низкого уровня к данным загружаемого звука, не устанавливайте для параметра checkPolicyFile значение true. Проверка наличия файла междоменной политики потребляет сетевую полосу пропускания и может задержать начало загрузки, поэтому ее следует выполнять только при необходимости.

При вызове метода Sound.load() со свойством SoundLoaderContext.checkPolicyFile в значении true проигрыватель Flash Player должен либо успешно загрузить соответствующий файл политики URL-адресов, либо определить, что его не существует, прежде чем начнется загрузка заданного звука. Flash Player выполняет следующие действия, чтобы проверить существования файла политики:

• Проигрыватель Flash Player анализирует ранее загруженные файлы политик.
• Проигрыватель Flash Player пытается загрузить любые ожидаемые файлы политик, указанные в вызовах метода Security.loadPolicyFile().
• Проигрыватель Flash Player пытается загрузить файл политики из местоположения по умолчанию, которое соответствует URL-адресу звука (файл /crossdomain.xml на том же сервере, что и URLRequest.url). (URL звука задается в свойстве url объекта URLRequest, переданного методу Sound.load() или конструктору Sound.)

Во всех случаях для работы проигрывателя Flash Player требуется, чтобы на сервере звука существовал соответствующий файл политики, который предоставляет доступ к объекту по адресу URLRequest.url на основе места размещения файла политики, а также, чтобы он обеспечивал домену вызывающего SWF-файла доступ к звуку посредством одного или нескольких тегов <allow-access-from>.

Если установить для параметра checkPolicyFile значение true, то перед загрузкой звука проигрыватель Flash Player будет ожидать проверки файла политики. Прежде чем выполнять операции низкого уровня с данными звука, такие как вызов Sound.id3 или SoundMixer.computeSpectrum(), необходимо дождаться отправки событий progress и complete объектом Sound.

Если задать для параметра checkPolicyFile значение true, но при этом соответствующий файл политики не будет найден, сообщение об ошибке будет отправлено только при попытке выполнить операцию, требующую файл политики, после чего проигрыватель Flash Player выдаст исключение SecurityError. После получения события complete можно проверить, найден ли релевантный файл политики, получив значение Sound.id3 в блоке try и посмотрев, будет ли выдано исключение SecurityError.

Будьте внимательны при установке параметра checkPolicyFile, если вы загружаете файл с URL-адреса, в котором используется HTTP-переадресация на стороне сервера. Проигрыватель Flash Player пытается получить файлы политик, соответствующие свойству url объекта URLRequest, переданного методу Sound.load(). Если окончательный звуковой файл передается с другого URL-адреса из-за HTTP-переадресации, то изначально загруженные файлы политик могут быть не применимы к конечному URL-адресу объекта, который и следует учитывать при принятии мер безопасности.

В подобном случае можно предпринять следующее. Получив событие progress или complete, нужно проанализировать значение свойства Sound.url, которое содержит конечный URL звука. Затем вызовите метод Security.loadPolicyFile() в файле политики которого указан URL-адрес, полученный исходя из конечного URL звука. В завершение, запрашивайте значение свойства Sound.id3 до тех пор, пока не перестанет выдаваться исключение.

Дополнительные сведения о файлах политик см. в главе "Система безопасности проигрывателя Flash Player" руководства Программирование на ActionScript 3.0.

См. также

Создает новый объект Context для загрузчика звука.

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(3000, 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);
        }

    }
}