| Пакет | flash.media |
| Класс | public class MediaPromise |
| Наследование | MediaPromise  EventDispatcher Object |
| Реализует | IFilePromise |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Свойство data объекта MediaEvent является экземпляром MediaPromise. Методы MediaPromise можно использовать для доступа к обещанному объекту мультимедиа. Поддерживаемые форматы мультимедийных данных включают фотографии и видеоролики.
Создание объекта MediaPromise невозможно. При вызове new MediaPromise() возникает ошибка cреды выполнения.
Связанные элементы 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 | свойство |
file:File [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Экземпляр File, представляющий объект мультимедиа, если таковой существует.
Это свойство ссылается на объект File, если базовый источник данных является файловым и файл доступен программе. В противном случае свойство равно null.
Реализация
public function get file():File isAsync | свойство |
mediaType | свойство |
mediaType:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Основной тип мультимедиа: изображение или видео.
Константы класса MediaType определяют возможные значения этого свойства:
- MediaType.IMAGE
- MediaType.VIDEO
Реализация
public function get mediaType():StringСвязанные элементы API
relativePath | свойство |
relativePath:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Имя файла объекта мультимедиа, если таковой существует.
Имя файла доступно, если базовый источник данных является файловым и файл доступен в программе. В противном случае свойство равно null.
Реализация
public function get relativePath():Stringclose | () | метод |
public function close():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Закрывает источник данных.
open | () | метод |
public function open():IDataInput| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.5 |
Открывает базовый источник данных и возвращает экземпляр IDataInput, доступный для чтения.
Если базовый источник данных является асинхронным, то объект MediaPromise отправляет события progress и complete, показывая доступность данных для чтения. Если источник данных является синхронным, сразу же доступны все данные и эти события не отправляются.
Примечание. Можно загрузить объект MediaPromise с использованием метода loadFilePromise() класса Loader вместо чтения данных вручную.
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 определяет значение свойства type объекта события close.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
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 определяет значение свойства type объекта complete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
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, когда данные становятся доступными.
Свойство bytesTotal всех событий progress, кроме последнего, имеет значение 0. Если сразу же доступны все данные, события progress могут не отправляться. События progress не отправляются синхронными источниками данных.
type для объекта события progress.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, сообщающий сведения о прогрессе. |
Tue Jun 12 2018, 11:34 AM Z