VideoPlayer  - AS3 Flash

Устанавливает отображение видео относительно свойств registrationX, registrationY, registrationWidth и registrationHeight. Свойство align создает автоматическое размещение, если для свойства scaleMode установлено значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE. Изменение данного свойства после загрузки FLV-файла приводит к немедленному началу автоматического размещения. Значения приходят от класса VideoAlign.

Значением по умолчанию является VideoAlign.CENTER.

Связанные элементы API

В случае значения true логический параметр вызывает перемотку FLV-файла к кадру 1 после остановки воспроизведения по причине достижения конца потока или вызова метода stop(). Данное свойство неприменимо к потоковому воспроизведению.

Значением по умолчанию является false.

Число, указывающее количество секунд для буферизации в памяти перед началом воспроизведения видеопотока. Для FLV-файлов, воспроизводимых в потоке с RTMP, которые не загружены и не буферизированы в памяти, необходимо уменьшить данное значение со стандартного на значение 0,1. При последовательной загрузке FLV-файла с HTTP можно увеличить данное значение, что позволит улучшить воспроизведение высококачественного видео на старом медленном компьютере.

Для предварительно записанного видео (не потоковое воспроизведение) не устанавливайте для свойства bufferTime значение 0. Используйте стандартное время для буфера или увеличьте его.

Данное свойство не определяет размер загружаемого FLV-файла перед началом воспроизведения.

Связанные элементы API

Число, указывающее объем загружаемых данных по HTTP (в байтах). Возвращает значение 0, если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.

Число, указывающее общее количество загруженных байт по HTTP. Возвращает значение «-1», если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.

Число, указывающее высоту экземпляра VideoPlayer (в пикселах).

Примечание. Не путайте данное свойство с свойством flash.media.Video.height, аналогичным свойству fl.video.VideoPlayer.videoHeight.

Связанные элементы API

Промежуток времени (в миллисекундах) перед тем, как приложение Flash закрывает бездействующее подключение к видеосерверу (например, FMS) из-за того, что воспроизведение приостановлено или остановлено. Данное свойство не действует при загрузке FLV-файла по протоколу HTTP.

Если установить данное свойство, когда видео находится в режиме бездействия, то свойство перезапустит период таймаута с новым значением.

Для того чтобы объекты VideoPlayer использовали пользовательский класс как стандартную реализацию интерфейса INCManager, установите для свойства iNCManagerClass значение объекта класса или имени пользовательского класса. Класс FLVPlayback включает описание пользовательского класса. Видеопроигрыватель не включает описание класса.

Значением по умолчанию является строка fl.video.NCManager.

Логический параметр, принимающий значение true, если видеопоток воспроизводится в реальном времени. Данное свойство действительно, только если поток воспроизводится с видосервера, такого как Flash Media Server (FMS) или другого сервиса Flash Video Streaming Service (FVSS). Данное свойство игнорируется при HTTP-загрузке.

Установите для свойства isLive значение false при отправке предварительно записанного видеопотока в видеопроигрыватель и установите значение true при отправке данных реального времени, таких как прямая трансляция. Для улучшения производительности при установке для свойства isLive значения false не устанавливайте для свойства bufferTime значение 0.

Связанные элементы API

Логическая переменная, принимающая значение true, если FLV-файл воспроизводится в потоковом режиме с сервера FMS по протоколу RTMP. Принимает начение false для любых других источников FLV-файла.

Связанные элементы API

Объект, представляющий собой пакет метаданных, полученных в результате вызова метода обратного вызова NetSteam.onMetaData(), если такой объект доступен. Готово, если передано событие metadataReceived.

Если FLV-файл закодирован с помощью кодировщика Flash 8, то свойство metadata содержит следующую информацию. Старые FLV-файлы содержат только значения height, width и duration.

Связанные элементы API

Объект INCManager, предоставляющий доступ к экземпляру класса, реализующего интерфейс INCManager к классу NCManager.

Можно использовать данное свойство для реализации пользовательского класса INCManager, требующего инициализации пользователем.

Связанные элементы API

Разрешает прямой доступ к экземпляру подключения NetConnection, созданному видеопроигрывателем.

Разрешает прямой доступ к экземпляру NetStream, созданному видеопроигрывателем.

Регистрирует пользовательский класс клиентского свойства NetStream. По умолчанию используется класс fl.video.VideoPlayerClient. Данный класс обрабатывает сообщения onMetaData() и onCuePoint(). Чтобы добавить собственный обработчик других сообщений, таких как onImageData() и onTextData(), необходимо создать собственный класс и установить в классе данное свойство.

Конструктор класса должен иметь логическое свойство ready, а в качестве единственного параметра иметь экземпляр VideoPlayer. Свойство должно иметь значение false, пока клиент еще ждет сообщения данных, ожидаемых в начале файла. Если VideoPlayer перед получением данных сообщений выполнял изменение размеров и автоматическую перемотку, то сообщения могут быть пропущены. По умолчанию объект fl.video.VideoPlayerClient из свойства ready возвращает значение true, как только вызвано сообщение onMetaData().

Можно установить свойство на сам класс объекта (как в примере ниже) или имя класса:

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

Одной установки имени класса для значения свойства недостаточно для включения класса в компиляцию SWF. Значением по умолчанию является класс объекта fl.video.VideoPlayerClient, а не имя класса.

Настоятельно рекомендуется, чтобы любые собственные реализации класса были подклассами fl.video.VideoPlayer. Иначе при выполнении построения в компоненте VideoPlayer и компоненте FLVPlayback существует вероятность нарушения метаданных и ключевой точки.

Значением по умолчанию является fl.video.VideoPlayerClient.

Число, обозначающее текущее время воспроизведения или положение, которое может быть дробным (в секундах). Установка данного свойства запускает процесс перехода и имеет все ограничения для процесса перехода.

Если измененяется время точки воспроизведения, которое при воспроизведении FLV-файла меняется четыре раза в секунду, то компонент отправляет событие playheadUpdate.

По нескольким причинам свойство playheadTime может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime. Во-первых, при последовательной загрузке можно перейти только к ключевому кадру, поэтому переход происходит к первому ближайшему ключевому кадру к заданному времени. При использовании потокового воспроизведения переход осуществляется точно в указанное время, даже если исходный FLV-файл не имеет ключевых кадров. Во-вторых, процесс перехода асинхронный, то есть, если вызвать метод перехода или установить значение для свойства playheadTime, значение свойства playheadTime обновится с задержкой. Для получения времени после завершения перехода прослушивайте событие seek, которое не посылается, пока не обновится свойство playheadTime.

Связанные элементы API

Число, представляющее промежуток времени (в миллисекундах) между событиями playheadUpdate. Установка данного значения при воспроизведении FLV-файла перезапустит таймер.

Так как ключевые точки ActionScript начинаются при обновлении точек воспроизведения, то уменьшение значения свойства playheadUpdateInterval позволит повысить точность ключевых точек ActionScript.

Так как интервал обновления точек воспроизведения устанавливается глобальным методом setInterval(), то обновление не может запускаться чаще частоты кадров SWF-файла, как и любой интервал, устанавливаемый данным методом. Так, например для стандартной частоты 12 кадров в секунду минимальный эффективный интервал, который можно создать, равен приблизительно 83 миллисекундам, или 1/12 секунды (1000 миллисекунд, деленные на 12).

Значением по умолчанию является 250.

Связанные элементы API

Число, представляющее промежуток времени (в миллисекундах) между событиями progress. Если установить данное свойство при воспроизведении видеопотока, то таймер перезапустится.

Высота, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationHeight с свойством height. Свойство height показывает фактическую высоту видео.

Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Установка свойства registrationHeight аналогична установке свойства height, и наоборот. При установке любого другого свойства или вызове любого метода, влияющего на высоту, таких как scaleX, setSize и setScale, также синхронно сохраняются свойства height и registrationHeight.

Связанные элементы API

Ширина, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationWidth с свойством width. Свойство width показывает фактическую ширину видео.

Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Установка свойства registrationWidth аналогична установке свойства width, и наоборот. При установке любого другого свойства или вызове любого метода, влияющего на ширину, таких как scaleX, setSize и setScale, также синхронно сохраняются свойства width и registrationWidth.

Связанные элементы API

Координата по горизонтали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством x, которое показывает фактическое положение видео.

Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

При установке свойства x или registrationX} второе свойство меняется, сохраняя свое смещение от первого. Например, если x = 10 и registrationX = 20, то при установке значения x = 110 значение registrationX устанавливается равным 120.

Связанные элементы API

Координата по вертикали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством y, которое показывает фактическое положение видео.

Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

При установке свойства y или registrationY второе свойство меняется, сохраняя свое смещение от первого. Например, если y = 10 и registrationY = 20, то при установке значения y = 110 значение registrationY устанавливается равным 120.

Связанные элементы API

Указывает способ изменения размеров видео после загрузки. Если установлено значение VideoScaleMode.MAINTAIN_ASPECT_RATIO, то сохраняется соотношение сторон видео внутри прямоугольника, заданного свойствами registrationX, registrationY, registrationWidth и registrationHeight. Если установлено значение VideoScaleMode.NO_SCALE, то видео автоматически меняет размеры соответственно исходным размерам FLV-файла. Если установлено VideoScaleMode.EXACT_FIT, то размеры исходного FLV-файла игнорируются и видео растягивается по размерам прямоугольника, заданного свойствами registrationX, registrationY, registrationWidth и registrationHeight. Если свойство устанавливается после загрузки FLV-файла, то немедленно начинается автоматическое размещение. Значения приходят от свойства VideoScaleMode.

Значением по умолчанию является VideoScaleMode.MAINTAIN_ASPECT_RATIO.

Связанные элементы API

Число, являющееся масштабом по горизонтали.

Значением по умолчанию является 1.

Связанные элементы API

Число, являющееся масштабом по вертикали.

Значением по умолчанию является 1.

Связанные элементы API

Предоставляет прямой доступ к свойству к свойству NetStream.soundTransform, обеспечивая дополнительные возможности управления звуком. Установите свойство для изменения параметров. Используйте метод accessor получателя для определения текущих параметров.

Связанные элементы API

Строка, задающая URL-адрес FLV-файла и метод его потокового воспроизведения. URL-адрес может быть URL-адресом HTTP на FLV-файл, URL-адресом RTMP на поток или URL-адресом HTTP на XML-файл.

Если данное свойство было установлено с помощью инспектора компонентов или инспектора свойств, то начнется загрузка и воспроизведение FLV-файла с приходом следующего события enterFrame. Задержка обеспечивает время для установки свойств isLive, autoPlay и cuePoints из числа других, влияющих на загрузку. Это также позволяет коду ActionScript, расположенному в первом кадре, влиять на компонент FLVPlayback до начала воспроизведения.

Если установить данное свойство через ActionScript, то оно немедленно вызовет метод VideoPlayer.load(), если для свойства autoPlay установлено значение false. Если для свойства autoPlay установлено значение true, вызывается метод VideoPlayer.play(). Свойства autoPlay, totalTime и isLive влияют на загрузку нового FLV-файла, поэтому данные свойства должны устанавливаться до установки свойства source.

Установка для свойства autoPlay значения false, предотвращает автоматическое воспроизведение нового FLV-файла.

Связанные элементы API

Строка, задающая состояние компонента. Данное свойство устанавливается методами load(), play(), stop(), pause() и seek().

Возможные значения для свойства состояния: buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking и stopped. Для определения этих состояний можно использовать свойства класса FLVPlayback.

Связанные элементы API

Логический параметр, принимающий значение true, если состояние является управляемым. Если состояние неуправляемое, то вызов методов play(), load(), stop(), pause() и seek() будет поставлен в очередь, а выполнение отложено до момента, когда состояние изменится на управляемое. Так как эти вызовы будут поставлены в очередь и их выполнение отложено, то нет необходимости следить за значением свойства stateResponsive. Управляемые состояния: stopped, playing, paused и buffering.

Связанные элементы API

Число, определяющее общее время воспроизведения видео (секунды).

При потоковом воспроизведении с Flash Media Server (FMS) и использовании стандартного объекта NCManager данное значение определяется автоматически интерфейсом программного приложения сервера (APIs), и данное значение отменяет все установленное через данное свойство или полученное с метаданных. Данное свойство готово для чтения, если после установки свойства source получено состояние stopped или playing. Данное свойство неприменимо при потоковом воспроизведении с FMS.

При HTTP-загрузке, если FLV-файл имеет встроенные метаданные, значение определяется автоматически. В противном случае установите его явно, иначе оно будет установлено как NaN. При явной установке значение, полученное из метаданных потока, будет проигнорировано.

После установки данного свойства значение вступит в силу для следующего FLV-файла, загружаемого установкой свойства source. Оно не влияет на уже загруженный FLV-файл. Также данное свойство не возвращает значение, переданное до загрузки FLV-файла.

Если данное свойство не установить (явно или автоматически), то воспроизведение продолжает работать, но могут возникнуть проблемы с элементами управления переходом.

Если свойство не установлено явно, то свойство будет иметь значение NaN, пока не будет установлено правильное значение из метаданных.

Связанные элементы API

Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.

Связанные элементы API

Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.

Связанные элементы API

Если данный логический параметр имеет значение true, экземпляр VideoPlayer делается видимым. В случае значения false экземпляр делается невидимым.

Значением по умолчанию является true.

Число в диапазоне от 0 до 1, указывающее уровень громкости.

Значением по умолчанию является 1.

Связанные элементы API

Число, указывающее ширину экземпляра VideoPlayer на монтажном столе.

Примечание. Свойство flash.media.Video.width аналогично свойству fl.video.VideoPlayer.videoWidth.

Связанные элементы API

Число, указывающее положение видеопроигрывателя по горизонтали (в пикселах).

Установка свойства x также влияет на значение свойства registrationX. При установке свойства x или registrationX} второе свойство меняется, сохраняя свое смещение от первого. Например, если x = 10 и registrationX = 20, то при установке значения x = 110 значение registrationX устанавливается равным 120.

Связанные элементы API

Число, указывающее положение видеопроигрывателя по вертикали (в пикселах).

Установка свойства y также влияет на значение свойства registrationY. При установке свойства y или registrationY второе свойство меняется, сохраняя свое смещение от первого. Например, если y = 10 и registrationY = 20, то при установке значения y = 110 значение registrationY устанавливается равным 120.

Связанные элементы API

Создает объект VideoPlayer заданной ширины и высоты.

Связанные элементы API

Принудительно закрывает видеопоток и подключение к серверу Flash Media Server. Данный метод запускает событие close. Нет необходимости непосредственно вызывать данный метод, потому что функция таймаута при бездействии проигрывателя позаботится о закрытии потока.

Связанные элементы API

Данный метод аналогичен методу play(), но вызывает загрузку FLV-файла без последующего воспроизведения. Если необходимо, то при отображении первого кадра FLV-файла выполняется автоматическое изменение размеров. После начальной загрузки файла и автоматической установки размеров видеопроигрыватель переходит в состояние VideoState.PAUSED.

Данный метод принимает такие же параметры, как и метод play(), но нельзя вызывать метод load() без значения URL-адреса. При попытке вызова без значения URL-адреса возникает ошибка. Если видеопроигрыватель находится в неуправляемом состоянии, то запрос метода load() будет поставлен в очередь.

Параметры

Связанные элементы API

Вызывается объектом INCManager в случае успешного или неуспешного завершения подключения, после вызова метода INCManager.connectToURL(). После неуспешного соединения перед вызовом метода установите для свойства INCManager.netConnection значение null или «не определено».

Связанные элементы API

Вызывается объектом INCManager после завершения или сбоя повторного подключения, после того как завершен вызов метода INCManager.reconnect(). Если соединение разорвано, установите для свойства INCManager.netconnection значение null перед вызовом метода.

Связанные элементы API

Приостанавливает воспроизведение видео. Не влияет на остановленное или приостановленное видео. Для продолжения воспроизведения вызовите метод play(). Не имеет параметров.

Если проигрыватель находится в неуправляемом состоянии, то запрос метода pause() будет поставлен в очередь.

При вызове метода без подключенного потока создается исключение. Используйте событие stateChange и значение свойства connected для определения безопасного момента для вызова метода.

Если проигрыватель находится в остановленном состоянии, то вызов метода pause() не влияет на проигрыватель, который останется в остановленном состоянии.

Связанные элементы API

Вызывает воспроизведение видео. Можно вызвать метод, если воспроизведение приостановлено или остановлено, или если видео уже воспроизводится. Вызовите данный метод без параметров для воспроизведения уже загруженного видеофайла или передайте URL-адрес для загрузки нового потока.

Если проигрывательнаходится в неуправляемом состоянии, то запрос будет поставлен в очередь.

Если метод вызывается без аргументов и в данный момент нет подключенного потока, то создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange и значение свойства connected.

Параметры

Связанные элементы API

Воспроизведение FLV-файла при загрузке достаточной части файла. Если FLV-файл уже загружен или происходит потоковое воспроизведение с Flash Media Server (FMS), то вызов метода playWhenEnoughDownloaded() аналогичен вызову метода play() без параметров. Вызов данного метода не приостанавливает воспроизведение, поэтому во многих случаях перед вызовом этого метода необходимо вызвать метод pause().

Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды). Если видео воспроизводится, то воспроизведение продолжится с этой точки. Если видео приостановлено, то видео переместится в эту точку и останется в приостановленном состоянии. Если видео остановлено, то видео переместится в эту точку и перейдет в приостановленное состояние. Неприменимо для потокового воспроизведения.

Свойство playheadTime может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime. При использовании последовательной загрузки можно перейти только в ключевой кадр. Поэтому переход перемещает пользователя в первый ближайший ключевой кадр к указанному времени.

Примечание. При потоковом воспроизведении переход осуществляется точно на указанное время, даже если исходный FLV-файл не имеет ключевых кадров.

Процесс перехода асинхронный, то есть при вызове метода перехода или установке значения для свойства playheadTime, значение свойства playheadTime обновляется с задержкой. Для получения значения времени после завершения перехода программа прослушивает событие seek, которое не будет запущено до завершения обновления свойства playheadTime.

При вызове метода без подключенного потока создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange и значение свойства connected.

Параметры

Связанные элементы API

Одновременно задает свойства scaleX и scaleY. Установка scaleX или scaleY по отдельности вызывает два события autolayout, в то время как вызов метода setScale() вызывает только одно событие autolayout.

Если свойство scaleMode имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то вызов данного метода немедленно запускает событие autolayout.

Параметры

Связанные элементы API

Одновременно задает свойства width и height. Установка только свойства width или height запускает два события autolayout, тогда как при вызове метода setSize() запускается только одно событие autolayout.

Если свойство scaleMode имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то вызов данного метода немедленно запускает событие autolayout.

Параметры

Связанные элементы API

Останавливает воспроизведение видео. Если для свойства autoRewind установлено значение true, то производится перемотка видео к первому кадру. Не оказывает влияния на проигрыватель, если воспроизведение уже остановлено. Для продолжения воспроизведения вызовите метод play(). Не имеет параметров.

Если проигрыватель находится в неуправляемом состоянии, запрос будет поставлен в очередь.

При вызове метода без подключенного потока создается исключение. Используйте событие stateChange и значение свойства connected для определения безопасного момента для вызова метода.

Связанные элементы API

Отправляется когда точка воспроизведения переходит в начало видеопроигрывателя, потому что для свойства autoRewind установлено значение true.

Событие autoRewound относится к типу VideoEvent и имеет константу VideoEvent.AUTO_REWOUND.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется экземпляром VideoPlayer, когда подключение NetConnection закрывается по истечении времени ожидания, или при вызове метода close(), а также при вызове методов load() или play() или при установке свойства source. В результате закрывается подключение RTMP. Экземпляр FLVPlayback отправляет данное событие только при воспроизведении потока с сервера Flash Media Server (FMS) или другого сервиса Flash Video Streaming Service (FVSS).

Событие close относится к типу VideoEvent и имеет константу VideoEvent.CLOSE.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется, когда воспроизведение завершается по достижении конца FLV-файла. Компонент не отправляет событие, если вызван метод stop() или pause() или выбран соответствующий элемент управления.

Если приложение использует последовательную загрузку, то свойство totalTime не устанавливается явным образом. При этом загружается FLV-файл, в метаданных которого не указана длительность. Перед отправкой данного события видеопроигрыватель устанавливает свойство totalTime равным приблизительному общему значению.

Видеопроигрыватель также отправляет события stateChange и stopped.

Событие complete относится к типу VideoEvent и имеет константу VideoEvent.COMPLETE.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется по достижении ключевой точки. Объект события имеет свойство info, содержащее информацию об объекте, полученную отзывом события NetStream.onCuePoint для ключевых точек FLV-файла. Для ключевых точек ActionScript он содержит объект, переданный в методы ключевых точек ActionScript или свойства.

Событие cuePoint относится к типу MetadataEvent и имеет константу MetadataEvent.CUE_POINT.

Это событие имеет следующие свойства:

Связанные элементы API

событие drmAuthenticate

событие drmError

событие drmError

Отправляется при изменении размера или макета видеопроигрывателя. Есть два случая, при которых появляется событие layout.

• Если видеопроигрыватель изменяет размеры с помощью события autoLayout или вызова методов setScale() или setSize(), или изменением свойств width, height, scaleX и scaleY.
• Если есть два видеопроигрывателя с разными размерами, свойство visibleVideoPlayerIndex переключается с одно видеопроигрывателя на другой.

Событие layout относится к типу VideoEvent и имеет константу LayoutEvent.LAYOUT.

Это событие имеет следующие свойства:

Связанные элементы API

Первый раз отправляется при достижении метаданных FLV-файла. Объект события имеет свойство info, содержащее информацию об объекте, полученную обратным вызовом события NetStream.onMetaData.

Событие metadataReceived относится к типу VideoEvent и имеет константу MetadataEvent.METADATA_RECEIVED.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется при воспроизведении FLV-файла, с частотой, указанной в свойстве playheadUpdateInterval, или при начале процесса перемотки. Данный компонент не отправляет это событие, когда видеопроигрыватель находится в приостановленном состоянии или остановлен, если только не производится поиск.

Событие playheadUpdate относится к типу VideoEvent и имеет константу VideoEvent.PLAYHEAD_UPDATE.

Это событие имеет следующие свойства:

Связанные элементы API

Показывает ход загрузки, отображая число загруженных байтов. Отправляется с частотой, определяемой свойством progressInterval, начинается одновременно с загрузкой и заканчивается, когда все байты загружены или произошла сетевая ошибка. По умолчанию событие отправляется каждые 0,25 секунды при вызове загрузки и заканчивается после загрузки всех байтов или появления сетевой ошибки. Используйте данное событие для проверки загруженных байтов или количества байтов в буфере.

Отправляется только при последовательной загрузке HTTP. Показывает ход загрузки, отображая количество загруженных байтов. Объект события имеет свойства bytesLoaded и bytesTotal, которые выполняют те же функции, что и свойства FLVPlayback с теми же именами.

Событие progress относится к типу VideoProgressEvent и имеет константу VideoProgressEvent.PROGRESS.

Это событие имеет следующие свойства:

Связанные элементы API

Событие, отправляемое, когда FLV-файл загружен и готов к отображению. Событие начинается первый раз при переходе видеопроигрывателя в управляемое состояние после загрузки нового FLV-файла методом play() или load(). Событие начинается один раз при каждой загрузки FLV-файла.

Событие ready относится к типу VideoEvent и имеет константу VideoEvent.READY.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется при изменении состояния воспроизведения. После завершения вызова autoRewind отправляется событие stateChange с состоянием перемотки видео. Событие stateChange не отправляется, пока не будет завершена перемотка видео.

Событие может использоваться для определения перехода в состояние воспроизведения или выхода из неуправляемых состояний, таких как середина процесса подключения, изменение размеров или процесс перемотки. Методы play(), pause(), stop() и seek() образуют очередь запросов на выполнение при переходе проигрывателя в управляемое состояние.

Событие stateChange относится к типу VideoEvent и имеет константу VideoEvent.STATE_CHANGE.

Это событие имеет следующие свойства:

Связанные элементы API

Переменная состояния, указывающая сокращенный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:

FLVPlayback.SHORT_VERSION

Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0. Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11.

Связанные элементы API

Переменная состояния, указывающая полный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:

FLVPlayback.VERSION

Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11. Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0.

Связанные элементы API

Чтобы применить этот пример на практике, выполните следующие действия.

1. Добавьте в библиотеку компонент FLVPlayback.
2. Введите вместо testVideoPath абсолютный или относительный путь к FLV-файлу.
3. Сохраните этот код под именем VideoPlayerExample.as в том же каталоге, что и FLA-файл.
4. Присвойте классу Document в FLA-файле значение VideoPlayerExample.

package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}