RSLInfo

패키지	fl.rsl
클래스	public class RSLInfo
상속	RSLInfo EventDispatcher Object
하위 클래스	SWZInfo

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

RSLInfo 클래스를 사용하면 RSL(런타임 공유 라이브러리 파일)의 사용과 관련된 내용을 지정할 수 있습니다. addEntry()와 함께 일련의 url을 추가할 수 있습니다. 이 url은 SWF 파일용 및 필수 정책 파일용으로 모두 사용할 수 있습니다. RSLInfo 클래스는 Event.COMPLETE, IOErrorEvent.IO_ERROR, SecurityErrorEvent.SECURITY_ERROR 및 ProgressEvent.PROGRESS와 같은 이벤트를 모두 전달할 수 있습니다. 장애 조치를 사용하므로, SecurityErrorEvents 또는 IOErrorEvents가 전달되어도 failed 속성이 true를 반환하는 한 RSL 다운로드가 실패하지 않습니다.

관련 API 요소

addEntry()

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		bytesLoaded : int [읽기 전용] 로드되고 있는 모든 파일에 대해 지금까지 로드된 바이트 수를 나타냅니다.	RSLInfo
		bytesTotal : int [읽기 전용] 로드되고 있는 모든 파일에 대해 지금까지 로드된 전체 바이트 수를 나타냅니다.	RSLInfo
		complete : Boolean [읽기 전용] 다운로드가 정상적으로 완료되면 true 값을, 다운로드가 아직 완료되지 않았거나 실패하면 false 값을 반환합니다.	RSLInfo
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		currentAttemptIndex : int [읽기 전용] 현재 다운로드를 시도하고 있는 URL의 인덱스를 반환합니다.	RSLInfo
		failed : Boolean [읽기 전용] 다운로드가 실패하면 true 값을, 다운로드가 아직 완료되지 않았거나 정상적으로 완료되면 false 값을 반환합니다.	RSLInfo
		loader : Loader [읽기 전용] RSL을 다운로드하는 데 사용된 로더를 반환합니다.	RSLInfo
		policyFileURLs : Array [읽기 전용] addEntry()를 통해 추가된 정책 파일 URL 배열을 반환합니다.	RSLInfo
		rslURLs : Array [읽기 전용] addEntry()를 통해 추가된 RSL URL 배열을 반환합니다.	RSLInfo

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		RSLInfo() 생성자입니다.	RSLInfo
		addEntry(url:String, policyFileURL:String = null):void 일련의 URL(RSL 파일 및 정책 파일)을 추가합니다.	RSLInfo
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		load():void RSL 다운로드를 시작합니다.	RSLInfo
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	이벤트		요약	정의 주체
		activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
		deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher

속성 세부 정보

bytesLoaded

속성

bytesLoaded:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

로드되고 있는 모든 파일에 대해 지금까지 로드된 바이트 수를 나타냅니다. 일부 로드가 실패하여 URL 장애 조치로 넘어갈 수 있으므로 시간이 경과함에 따라 bytesLoaded 값이 증가하거나 감소할 수 있습니다. 따라서 진행률 막대에서 이러한 점을 보정하여 뒤로 이동하지 않도록 해야 합니다.

구현
public function get bytesLoaded():int

bytesTotal

속성

bytesTotal:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

로드되고 있는 모든 파일에 대해 지금까지 로드된 전체 바이트 수를 나타냅니다. 일부 로드가 실패하여 URL 장애 조치로 넘어갈 수 있으므로 시간이 경과함에 따라 bytesTotal 값이 증가하거나 감소할 수 있습니다. 따라서 진행률 막대에서 이러한 점을 보정하여 뒤로 이동하지 않도록 해야 합니다.

구현
public function get bytesTotal():int

complete

속성

complete:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

다운로드가 정상적으로 완료되면 true 값을, 다운로드가 아직 완료되지 않았거나 실패하면 false 값을 반환합니다.

구현
public function get complete():Boolean

currentAttemptIndex

속성

currentAttemptIndex:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

현재 다운로드를 시도하고 있는 URL의 인덱스를 반환합니다. 실패 이벤트가 수신되면 이 인덱스가 실패한 URL을 가리킵니다. 인덱스는 rslURLs 및 policyFileURLs 배열에 속합니다. 다운로드 시작 전 인덱스 값은 -1이며, 다운로드 완료 후 인덱스 값은 배열의 길이가 됩니다. 따라서 이 값을 사용하여 URL 배열 멤버에 액세스하기 전에 범위 검사를 수행하는 것이 좋습니다.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEventListener(IOErrorEvent.IO_ERROR, handleErr);
         function handleErr(e:Event) {
         trace('error: ' + e);
         trace('on download of url: ' + info.rslURLs[info.currentAttemptIndex]);
         }

구현
public function get currentAttemptIndex():int

failed

속성

failed:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

다운로드가 실패하면 true 값을, 다운로드가 아직 완료되지 않았거나 정상적으로 완료되면 false 값을 반환합니다. 하나의 url이 실패했으며 추가로 시도할 장애 조치 URL이 있는 경우 failed 속성이 true로 설정되지 않습니다.

구현
public function get failed():Boolean

loader

속성

loader:Loader [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

RSL을 다운로드하는 데 사용된 로더를 반환합니다. NULL일 수 있습니다. 로더 인스턴스는 load()가 호출된 후에 만들어집니다.

구현
public function get loader():Loader

policyFileURLs

속성

policyFileURLs:Array [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

addEntry()를 통해 추가된 정책 파일 URL 배열을 반환합니다. 이 배열은 읽기 전용으로 간주됩니다. addEntry()를 호출하여 항목을 추가합니다. 이 배열을 바로 편집하면 예기치 않은 결과가 발생합니다.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.policyFileURLs.length; i++) {
            trace('url: ' + info.policyFileURLs[i]);
         }

구현
public function get policyFileURLs():Array

rslURLs

속성

rslURLs:Array [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

addEntry()를 통해 추가된 RSL URL 배열을 반환합니다. 이 배열은 읽기 전용으로 간주됩니다. addEntry()를 호출하여 항목을 추가합니다. 이 배열을 바로 편집하면 예기치 않은 결과가 발생합니다.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.rslURLs.length; i++) {
            trace('url: ' + info.rslURLs[i]);
         }

구현
public function get rslURLs():Array

()

생성자

public function RSLInfo()

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

생성자입니다.

메서드 세부 정보

addEntry

()

메서드

public function addEntry(url:String, policyFileURL:String = null):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

일련의 URL(RSL 파일 및 정책 파일)을 추가합니다. URL이 추가된 순서에 따라 다운로드 우선 순위가 결정됩니다. 즉, 첫 번째 URL이 처음 시도되며 첫 번째 URL이 실패하면 두 번째 URL이 시도되는 식입니다. 일치하는 RSL 파일 URL이 다운로드될 때만 정책 파일이 추가됩니다.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();

매개 변수

	`url:String`

	`policyFileURL:String` (default = `null`)

load

()

메서드

public function load():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS5

런타임 버전:

Flash Player 10.1, AIR 2

RSL 다운로드를 시작합니다. 첫 번째로 추가된 항목이 처음으로 시도됩니다. 다음 항목은 첫 번째 항목이 실패하는 경우 백업으로 시도됩니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

RSLInfo - AS3 Flash

클래스 x

bytesLoaded

bytesTotal

complete

currentAttemptIndex

failed

loader

policyFileURLs

rslURLs

RSLInfo

addEntry

load