패키지 | fl.rsl |
클래스 | public class RSLPreloader |
상속 | RSLPreloader EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
또는 RSLEvent.RSL_PROGRESS
)를 전달하여 RSL 파일의 로드 상태를 나타냅니다.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
debugWaitTime : int
첫 번째 RSL 파일을 다운로드하기 전에 대기하는 시간(밀리초)으로 이 값을 설정합니다. | RSLPreloader | ||
numRSLInfos : int [읽기 전용]
addRSLInfo()를 통해 추가된 RSLInfo 인스턴스의 수입니다. | RSLPreloader |
메서드 | 정의 주체 | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
생성자입니다. | RSLPreloader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
다운로드 중인 SWF 또는 SWZ 파일에 설명을 포함하는 RSLInfo 레코드를 추가합니다. | RSLPreloader | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
지정된 인덱스에서 addRSLInfo()를 통해 추가된 RSLInfo 레코드를 가져옵니다. | RSLPreloader | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
loadContent 메서드는 내용 클래스 이름이 start() 메서드에 제공될 때 래퍼 SWF의 프레임 2에서 호출됩니다. | RSLPreloader | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
RSL 파일 다운로드를 시작합니다. | RSLPreloader | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | |||
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | |||
모든 RSL 다운로드가 완료되었을 때 RSLPreloader에 의해 전달됩니다. | RSLPreloader | |||
모든 RSL 다운로드가 완료되었고 하나 이상을 다운로드하지 못했을 때 RSLPreloader에 의해 전달됩니다. | RSLPreloader | |||
RSLPreloader에 의해 전달되어 RSL 파일 다운로드 진행률을 나타냅니다. | RSLPreloader |
debugWaitTime | 속성 |
debugWaitTime:int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
첫 번째 RSL 파일을 다운로드하기 전에 대기하는 시간(밀리초)으로 이 값을 설정합니다. 이 속성은 최종 사용자 경험을 시뮬레이션하고 미리 로드된 루프를 테스트하는 방법 중 하나로, 서명된 캐시 RSL(SWZ 파일)을 테스트하여 SWZ 캐시를 플러시하지 않고 로딩 지연 시간 내에 구현하려고 할 때 특히 유용합니다. 배포 전에 이 값이 0보다 큰 값으로 설정된 코드는 사용할 수 없으므로 디버그 구성 상수(CONFIG::DEBUG
)를 사용하여 코드를 호출합니다. 또 다른 활용 방법은 지연을 아주 큰 값(예: 5000, 즉 5초)으로 설정하여 실질적으로 디버그 코드를 제거하는 것입니다. 제작에 따라 자동으로 생성된 RSLLoader 인스턴스의 경우 로드 중인 애니메이션 SWF 또는 기본 타임라인 코드에 setRSLPreloader(value:RSLPreloader):void
메서드를 정의하여 지연을 설정할 수 있습니다.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
기본값: 0.
구현
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | 속성 |
numRSLInfos:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
addRSLInfo()
를 통해 추가된 RSLInfo 인스턴스의 수입니다.
for(var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for(var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
구현
public function get numRSLInfos():int
관련 API 요소
RSLPreloader | () | 생성자 |
addRSLInfo | () | 메서드 |
public function addRSLInfo(info:RSLInfo):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
다운로드 중인 SWF 또는 SWZ 파일에 설명을 포함하는 RSLInfo 레코드를 추가합니다.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
매개 변수
info:RSLInfo |
getRSLInfoAt | () | 메서드 |
public function getRSLInfoAt(index:int):RSLInfo
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
지정된 인덱스에서 addRSLInfo()
를 통해 추가된 RSLInfo 레코드를 가져옵니다. 인덱스는 addRSLInfo()
를 통해 레코드가 추가된 순서에 해당합니다.
for (var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for (var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
매개 변수
index:int |
RSLInfo |
관련 API 요소
loadContent | () | 메서드 |
start | () | 메서드 |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
RSL 파일 다운로드를 시작합니다. 이 함수는 addRSLInfo()
를 통해 모든 RSLInfo 레코드가 추가된 후에 호출해야 합니다. 출력 코드를 자동으로 제작할 때 두 개의 선택 인수를 사용할 수 있습니다. 첫 번째 인수는 프리로더 SWF 애니메이션을 로드하기 위한 ByteArray 하위 클래스이며, 두 번째 인수는 내용 SWF용 ByteArray 하위 클래스의 이름으로, 두 인수 모두 최종 사용자 작성 코드에서는 일반적으로 사용되지 않습니다.
매개 변수
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
관련 API 요소
rslLoadComplete | 이벤트 |
fl.events.RSLEvent
속성 RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
모든 RSL 다운로드가 완료되었을 때 RSLPreloader에 의해 전달됩니다.
모든 RSL 다운로드가 완료되었을 때RSLPreloader
가 전달하는 이벤트입니다. 이 이벤트 유형에 대한 bytesLoaded
및 bytesTotal
속성은 항상 0입니다. 사용자 정의 이벤트 루프와 함께 미리 로딩하면 사용자 내용에서 이 이벤트를 수신하여 로딩 애니메이션 루프를 종료할 시점을 결정해야 합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 표시 목록에 추가할 DisplayObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
rslsLoaded | 성공적으로 다운로드한 파일의 수입니다. |
rslsFailed | 다운로드하지 못한 파일 수입니다. |
rslsTotal | 성공 여부에 관계없이 다운로드한 전체 파일 수입니다. |
bytesLoaded | 성공적으로 다운로드한 파일의 총 다운로드 바이트 수입니다. |
bytesTotal | 성공 여부에 관계없이 다운로드한 파일의 총 다운로드 바이트 수입니다. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | 이벤트 |
fl.events.RSLErrorEvent
속성 RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
모든 RSL 다운로드가 완료되었고 하나 이상을 다운로드하지 못했을 때 RSLPreloader에 의해 전달됩니다.
모든 RSL 다운로드가 완료되었고 하나 이상을 다운로드하지 못했을 때RSLPreloader
가 전달하는 오류입니다. 사용자 정의 이벤트 루프와 함께 미리 로딩하면 사용자 내용에서 이 이벤트를 수신하여 로딩 애니메이션 루프를 종료할 시점을 결정해야 합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 표시 목록에 추가할 DisplayObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
rslsLoaded | 성공적으로 다운로드한 파일의 수입니다. |
rslsFailed | 다운로드하지 못한 파일 수입니다. |
rslsTotal | 성공 여부에 관계없이 다운로드한 전체 파일 수입니다. |
failedURLs | 다운로드하지 못한 파일 배열입니다. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | 이벤트 |
fl.events.RSLEvent
속성 RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS5 |
런타임 버전: | Flash Player 10.1, AIR 2 |
RSLPreloader에 의해 전달되어 RSL 파일 다운로드 진행률을 나타냅니다.
RSL 파일 다운로드 진행률을 나타내기 위해RSLPreloader
가 전달하는 이벤트입니다. 이는 bytesLoaded
및 bytesTotal
속성이 0이 아닌 유일한 이벤트 유형입니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 표시 목록에 추가할 DisplayObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
rslsLoaded | 성공적으로 다운로드한 파일의 수입니다. |
rslsFailed | 다운로드하지 못한 파일 수입니다. |
rslsTotal | 성공 여부에 관계없이 다운로드한 전체 파일 수입니다. |
bytesLoaded | 성공적으로 다운로드한 파일의 총 다운로드 바이트 수입니다. |
bytesTotal | 성공 여부에 관계없이 다운로드한 파일의 총 다운로드 바이트 수입니다. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler); function progressHandler(e:RSLEvent) { trace('rslsLoaded = ' + e.rslsLoaded); trace('rslsFailed = ' + e.rslsFailed); trace('rslsTotal = ' + e.rslsTotal); trace('bytesLoaded = ' + e.bytesLoaded); trace('bytesTotal = ' + e.bytesTotal); }
Tue Jun 12 2018, 03:17 PM Z