Пакет | 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():String
close | () | метод |
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