| 패키지 | flash.media |
| 클래스 | public class MediaPromise |
| 상속 | MediaPromise  EventDispatcher Object |
| 구현 | IFilePromise |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
MediaEvent 객체의 data 속성은 MediaPromise 인스턴스입니다. MediaPromise 메서드를 사용하여 프로미스된 미디어 객체에 액세스할 수 있습니다. 지원되는 미디어 형식에는 스틸 이미지와 비디오가 포함됩니다.
MediaPromise 객체를 만들 수는 없습니다. new MediaPromise()를 호출하면 런타임 오류가 발생합니다.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| file : File [읽기 전용]
미디어 객체를 나타내는 File 인스턴스입니다(있는 경우). | MediaPromise | ||
| isAsync : Boolean [읽기 전용]
기본 데이터 소스가 비동기식인지 아니면 동기식인지를 보고합니다. | MediaPromise | ||
| mediaType : String [읽기 전용]
미디어의 일반 유형으로서, 이미지 또는 비디오입니다. | MediaPromise | ||
| relativePath : String [읽기 전용]
미디어 객체의 파일 이름입니다(있는 경우). | MediaPromise | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
데이터 소스를 닫습니다. | MediaPromise | ||
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
기본 데이터 소스를 열고 IDataInput 인스턴스를 반환하여 읽을 수 있도록 합니다. | MediaPromise | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
런타임에 의해 오류를 보고하는 데 사용됩니다. | MediaPromise | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
| 이벤트 | 요약 | 정의 주체 | ||
|---|---|---|---|---|
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | ||
| MediaPromise 객체는 기본 데이터 스트림이 닫힐 때 close 이벤트를 전달합니다. | MediaPromise | |||
| MediaPromise 객체는 모든 데이터를 읽었을 때 complete 이벤트를 전달합니다. | MediaPromise | |||
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | ||
| MediaPromise 객체는 기본 데이터 스트림을 읽는 중에 오류가 발생할 경우 ioError 이벤트를 전달합니다. | MediaPromise | |||
| MediaPromise 객체는 데이터를 사용할 수 있게 될 때 progress 이벤트를 전달합니다. | MediaPromise | |||
file | 속성 |
isAsync | 속성 |
mediaType | 속성 |
relativePath | 속성 |
close | () | 메서드 |
open | () | 메서드 |
public function open():IDataInput| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
기본 데이터 소스를 열고 IDataInput 인스턴스를 반환하여 읽을 수 있도록 합니다.
기본 데이터 소스가 비동기식일 경우 MediaPromise 객체는 progress 및 complete 이벤트를 전달하여 데이터를 읽을 수 있는지 여부를 나타냅니다. 데이터 소스가 비동기식일 경우에는 모든 데이터를 즉시 사용할 수 있으므로 이러한 이벤트가 전달되지 않습니다.
참고: 데이터를 수동으로 읽는 대신 Loader 클래스의 loadFilePromise() 메서드를 사용하여 MediaPromise 객체를 로드할 수 있습니다.
IDataInput |
관련 API 요소
reportError | () | 메서드 |
public function reportError(e:ErrorEvent):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
런타임에 의해 오류를 보고하는 데 사용됩니다.
응용 프로그램 코드는 이 메서드를 호출하지 않아야 합니다.
매개 변수
e:ErrorEvent — 전달할 오류 이벤트입니다.
|
close | 이벤트 |
flash.events.Event속성 Event.type =
flash.events.Event.CLOSE| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
MediaPromise 객체는 기본 데이터 스트림이 닫힐 때 close 이벤트를 전달합니다.
Event.CLOSE 상수는 close 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 연결이 종료된 객체입니다. |
complete | 이벤트 |
flash.events.Event속성 Event.type =
flash.events.Event.COMPLETE| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
MediaPromise 객체는 모든 데이터를 읽었을 때 complete 이벤트를 전달합니다. 이 이벤트는 기본 스트림에 사용 가능한 데이터가 더 이상 없음을 나타냅니다.
complete 이벤트는 동기식 데이터 소스에 의해 전달되지 않습니다.
Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 로드가 완료된 네트워크 객체입니다. |
ioError | 이벤트 |
flash.events.IOErrorEvent속성 IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
MediaPromise 객체는 기본 데이터 스트림을 읽는 중에 오류가 발생할 경우 ioError 이벤트를 전달합니다. 이 이벤트가 전달된 후에는 더 이상 데이터를 읽을 수 없습니다.
progress | 이벤트 |
flash.events.ProgressEvent속성 ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.5 |
MediaPromise 객체는 데이터를 사용할 수 있게 될 때 progress 이벤트를 전달합니다.
마지막을 제외한 모든 progress 이벤트의 bytesTotal 속성은 값이 0입니다. 모든 데이터를 즉시 사용할 수 있는 경우에는 progress 이벤트가 전달되지 않을 수 있습니다. 어떠한 progress 이벤트도 동기식 데이터 소스에 의해 전달되지 않습니다.
progress 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
bytesLoaded | 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다. |
bytesTotal | 로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다. |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 진행률을 보고하는 객체입니다. |
Tue Jun 12 2018, 03:17 PM Z