사운드 스트리밍 시작 전에 스트리밍 사운드를 버퍼에 미리 로드하는 시간(초)입니다.

전역 SoundMixer.bufferTime 속성을 설정하여 SoundLoaderContext.bufferTime 값을 재정의할 수 없습니다. SoundMixer.bufferTime 속성은 SWF에 포함된 사운드 스트림의 버퍼링 시간에 영향을 주며, 동적으로 만들어진 Sound 객체(ActionScript로 만든 Sound 객체)와는 무관합니다.

사운드 로드 시작 전에 Flash Player가 로드된 사운드의 서버로부터 크로스 도메인 정책 파일을 다운로드해야 할지 여부를 지정합니다. 이 속성은 호출하는 SWF 파일의 도메인 외부에서 Sound.load() 메서드를 사용하여 로드한 사운드에 적용됩니다.

호출하는 SWF 파일의 도메인 외부에서 사운드를 로드하고, ActionScript에서 해당 사운드 데이터에 대한 낮은 레벨의 액세스가 필요할 경우 이 속성을 true로 설정합니다. 사운드 데이터에 대한 낮은 레벨의 액세스란 ID3Info 객체를 가져오기 위해 Sound.id3 속성을 참조하거나 로드된 사운드로부터 사운드 샘플을 가져오기 위해 SoundMixer.computeSpectrum() 메서드를 호출하는 것 등입니다. 로딩 시 checkPolicyFile 속성을 true로 설정하지 않고 사운드 데이터에 액세스하려고 하면 필요한 정책 파일이 다운로드되지 않아 SecurityError 예외가 발생할 수 있습니다.

로드 중인 사운드 데이터에 대해 낮은 레벨의 액세스가 필요하지 않으면 checkPolicyFile을 true로 설정하지 않는 것이 좋습니다. 정책 파일을 확인하는 데 네트워크 대역폭이 소모되고 다운로드 시작이 지연될 수 있으므로 필요한 경우에만 확인해야 합니다.

SoundLoaderContext.checkPolicyFile이 true로 설정된 상태에서 Sound.load()를 호출할 경우, Flash Player는 해당하는 크로스 도메인 정책 파일을 다운로드하거나 그러한 정책 파일이 없음을 확인한 다음 지정된 사운드를 다운로드합니다. Flash Player는 다음과 같은 작업을 순서대로 수행하여 정책 파일이 있는지 확인합니다.

• 이미 다운로드된 정책 파일을 확인합니다.
• Security.loadPolicyFile() 호출에 지정된 대기 중인 정책 파일을 다운로드합니다.
• 사운드의 URL에 해당하는 기본 위치, 즉 URLRequest.url과 동일한 서버에 있는 /crossdomain.xml에서 정책 파일을 다운로드합니다. (사운드의 URL은 Sound.load() 또는 Sound 생성자에 전달된 URLRequest 객체의 url 속성에 지정되어 있습니다.)

모든 경우에 적절한 정책 파일이 사운드의 서버에 있고 그 정책 파일의 위치에 따라 URLRequest.url의 사운드 파일에 액세스할 수 있으며, 호출하는 SWF 파일의 도메인에서 하나 이상의 <allow-access-from> 태그를 통해 해당 사운드에 액세스할 수 있도록 허용해야 합니다.

checkPolicyFile을 true로 설정하면 Flash Player는 정책 파일이 확인될 때까지 기다렸다가 사운드를 로드합니다. Sound.id3 또는 SoundMixer.computeSpectrum() 호출과 같이 사운드 데이터에 대한 낮은 레벨의 작업을 수행하려면 Sound 객체로부터 progress 및 complete 이벤트가 전달될 때까지 기다려야 합니다.

checkPolicyFile을 true로 설정했지만 적절한 정책 파일이 발견되지 않은 경우, 정책 파일이 필요한 작업을 수행하면 오류 메시지가 표시되고 Flash Player에서 SecurityError 예외가 발생합니다. complete 이벤트 수신 후 try 블록 내의 Sound.id3 값을 가져와 SecurityError가 발생하는지 확인하면 정책 파일의 발견 여부를 테스트할 수 있습니다.

서버측 HTTP 리디렉션을 사용하는 URL에서 사운드를 다운로드하는 경우 checkPolicyFile 사용에 주의해야 합니다. Flash Player는 Sound.load()로 전달된 URLRequest 객체의 url 속성에 해당하는 정책 파일을 검색하려고 시도합니다. HTTP 리디렉션으로 인해 최종 사운드 파일이 다른 URL에서 다운로드된 경우 보안 결정에 중요한 최종 URL에 처음에 다운로드한 정책 파일이 적용되지 않을 수 있습니다.

이러한 상황을 해결하는 한 가지 progress 또는 complete 이벤트 수신 후 사운드의 최종 URL이 포함된 Sound.url 속성 값을 확인하는 것입니다. 그런 다음 사운드의 최종 URL을 기준으로 계산한 정책 파일의 URL로 Security.loadPolicyFile() 메서드를 호출합니다. 마지막으로, 예외가 발생하지 않을 때까지 Sound.id3 값을 폴링합니다.

정책 파일에 대한 자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.

참고 사항

새 사운드 로더 컨텍스트 객체를 만듭니다.

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);
        }

    }
}