SoundLoaderContext  - AS3

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

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

사운드 로드를 시작하기 전에 응용 프로그램이 로드된 사운드의 서버에서 URL 정책 파일을 다운로드할지 여부를 지정합니다. 이 속성은 호출하는 파일의 도메인 외부에서 Sound.load() 메서드를 사용하여 로드한 사운드에 적용됩니다.

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

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

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

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

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

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

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

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

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

이 방법은 AIR 응용 프로그램 샌드박스의 내용에 적용되지 않습니다. 응용 프로그램 샌드박스의 내용은 출처에 관계없이 항상 사운드 내용에 프로그래밍 방식으로 액세스할 수 있습니다.

보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오.

관련 API 요소

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

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

    }
}