flash.media.SoundLoaderContext (Flex™ 2 레퍼런스 가이드)

	property	정의
		bufferTime : Number = 1000 사운드의 스트리밍을 개시하기까지, 버퍼에 스트리밍 사운드를 프리로드 하는 초수입니다.	SoundLoaderContext
		checkPolicyFile : Boolean = false 사운드의 로드를 개시하기 전에, Flash Player 가, 로드 되는 사운드의 서버로부터 크로스 도메인 policy 파일을 다운로드하려고 할지 어떨지를 지정합니다.	SoundLoaderContext
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

	Methods	정의
		SoundLoaderContext (bufferTime:Number = 1000, checkPolicyFile:Boolean = false) 새로운 ContextMenu object를 작성합니다.	SoundLoaderContext
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object

property의 상세

bufferTime

property

public var bufferTime:Number = 1000

사운드의 스트리밍을 개시하기까지, 버퍼에 스트리밍 사운드를 프리로드 하는 초수입니다.

글로벌 SoundMixer.bufferTime property를 설정해 SoundLoaderContext.bufferTime 의 값을 재정의(override) 할 수 없습니다. SoundMixer.bufferTime property는 SWF 에 포함된 스트리밍 사운드의 버퍼 시간에 영향을 주어, 동적으로 작성되는 Sound object (ActionScript 로 작성되는 Sound object)에는 영향을 주지 않습니다.

checkPolicyFile

property

public var checkPolicyFile:Boolean = false

사운드의 로드를 개시하기 전에, Flash Player 가, 로드 되는 사운드의 서버로부터 크로스 도메인 policy 파일을 다운로드하려고 할지 어떨지를 지정합니다. 이 property는, 호출원의 SWF 파일 자신의 도메인외로부터 Sound.load() Methods를 사용해 로드 된 사운드에 적용됩니다.

호출원의 SWF 파일 자신의 도메인외로부터 사운드를 로드해, ActionScript 로부터 저레벨로 사운드에 액세스 할 필요가 있는 경우는, 이 property를 true 로 설정합니다. 사운드 데이터에의 저레벨 액세스의 예입니다. ID3Info object를 취득하기 위한 Sound.id3 property에의 참조, 또는 로드 된 사운드로부터 사운드 샘플링을 취득하는 SoundMixer.computeSpectrum() Methods의 호출이 포함됩니다. 로드시에 checkPolicyFile property를 true 로 설정하지 않고 사운드 데이터에 액세스 하려고 했을 경우, 필요한 policy 파일이 다운로드되어 있지 않기 위해(때문에) SecurityError 예외를 받는 경우가 있습니다.

로드하는 사운드 데이터에의 저레벨의 액세스를 필요로 하지 않는 경우는,checkPolicyFile 를 true 로 설정하지 말아 주세요. policy 파일의 확인은 네트워크 대역폭의 낭비가 되어, 다운로드의 개시가 늦는 경우가 있기 (위해)때문에, 필요한 경우에게만 실시합니다.

SoundLoaderContext.checkPolicyFile 를 true 로 설정해 Sound.load() 를 호출하면, Flash Player 는, 관련하는 크로스 도메인 policy 파일을 정상적으로 다운로드하는지, 지정된 사운드의 다운로드를 개시하기 전에, 그러한 policy 파일이 존재하지 않는 것을 판별할 필요가 있습니다. policy 파일의 존재를 확인하기 위해(때문에), Flash Player 는 다음의 액션을 이 차례로 실행합니다.

Flash Player 는, 이미 다운로드되고 있는 policy 파일을 고려합니다.
Flash Player 는,Security.loadPolicyFile() 의 호출로 지정된 보류되고 있는 policy 파일을 다운로드하려고 합니다.
Flash Player 는 사운드의 URL 에 대응하는 디폴트의 장소로부터 policy 파일을 다운로드하려고 합니다. 이것은,URLRequest.url 와 같은 서버의 /crossdomain.xml 입니다. 사운드의 URL 는 Sound.load() 또는 Sound constructor　　 에게 건네지는 URLRequest object의 url property로 지정합니다.

어떠한 경우에서도, Flash Player 에서는, 적절한 policy 파일이 사운드의 서버상에 존재하고 있어, policy 파일의 장소에 응해 URLRequest.url 에 있는 사운드 파일에의 액세스가 제공되어<allow-access-from> 태그에 응해 호출원 SWF 파일의 도메인에 의한 액세스가 허가되고 있을 필요가 있습니다.

checkPolicyFile 를 true 로 설정했을 경우, Flash Player 는 사운드를 로드하기 전에, policy 파일이 검증될 때까지 대기합니다. Sound object로부터 progress event 및 complete 이벤트가 dispatch될 때까지,Sound.id3 의 호출해 또는 SoundMixer.computeSpectrum() 의 호출 등, 사운드 데이터에 대한 저레벨의 조작을 실행하는 것을 기다릴 필요가 있습니다.

checkPolicyFile 를 true 로 설정해 있어도, 적절한 policy 파일이 발견되지 않는 경우는, policy 파일을 필요로 하는 조작을 실행할 때까지 에러가 표시되지 않습니다. policy 파일이 필요하게 되면, Flash Player 는 SecurityError 예외를 슬로우 합니다. complete 이벤트를 받으면,try 블록내의 Sound.id3 의 값을 취득해 SecurityError 가 슬로우 되었는지 어떠했는지를 확인해, 관련하는 policy 파일이 발견되었는지 어떠했는지를 테스트할 수 있습니다.

서버 사이드 HTTP 리디렉트를 사용하는 URL 로부터 사운드를 다운로드하는 경우는,checkPolicyFile 에 주의해 주세요. Flash Player 는,Sound.load() 에게 건네지는 URLRequest object의 url property에 대응하는 policy 파일을 취득하려고 합니다. 최종적인 사운드 파일이 HTTP 리디렉트에 의해 다른 URL 로부터 취득되는 경우, 최초로 다운로드된 policy 파일은 사운드의 최종적인 URL 에 적용할 수 없는 것이 있습니다. 그 때문에, URL 는 시큐러티 판정에 대해 중요합니다.

이러한 상황이 되었을 경우의 해결 방법이 1 개 있습니다. progress event 또는 complete 이벤트를 받은 후,Sound.url property의 값을 조사할 수가 있습니다. 여기에는, 사운드의 최종적인 URL 가 포함되고 있습니다. 다음에, 사운드의 최종적인 URL 에 근거해 산출한 policy 파일의 URL 로 Security.loadPolicyFile() Methods를 호출합니다. 마지막으로, 예외가 슬로우 되지 않게 될 때까지 Sound.id3 의 값을 폴링 합니다.

policy 파일의 상세한 것에 대하여는, 「ActionScript 3.0 의 프로그래밍」의 「Flash Player 시큐러티」의 장을 참조해 주세요.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class SoundLoaderContext	property \| Methods

Package	flash.media
Class	public class SoundLoaderContext
Inheritance	SoundLoaderContext Object

	`bufferTime:Number` (default = `1000`) — 사운드의 스트리밍을 개시하기까지, 버퍼에 스트리밍 사운드를 프리로드 하는 초수입니다.

	`checkPolicyFile:Boolean` (default = `false`) — object를 로드할 때, Flash Player 가 크로스 도메인 policy 파일의 존재를 확인하는 (`true`) 화도인지를 지정합니다.