| Пакет | fl.video |
| Класс | public class VideoPlayer |
| Наследование | VideoPlayer  Video DisplayObject EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
cuePoint все равно отправляются. Класс FLVPlayback охватывает класс VideoPlayer.
Используйте класс FLVPlayback практически во всех случаях, поскольку в классе VideoPlayer не имеется функциональности, которой бы не было в классе FLVPlayback.
Дополнительно класс FLVPlayback автоматически взаимодействует с классом NCManager для доступа к воспроизведению FLV-файлов на видеосервере, таких как Flash Media Server. Взаимодействие с классом NCManager происходит при установке свойства contentPath, а также когда URL-адрес передается в методы play() и load(). Чтобы точно добавить класс NCManager при использовании класса VideoPlayer, необходимо в код ActionScript включить следующую инструкцию:
var _forceNCManager:fl.video.NCManager;
Класс NCManager реализует интерфейс INCManager, и его можно заменить пользовательским классом для управления сетевыми соединениями, осуществляемыми данным интерфейсом. Если выполняется замена класса, то необходимо включить следующую инструкцию, заменяя NCManager именем предоставляемого класса:
fl.video.VideoPlayer.iNCManagerClass = fl.video.NCManager;
Нет необходимости добавлять данную инструкцию, если используется стандартный класс NCManager.
Примечание. При использовании компонента FLVPlayback можно установить класс iNCManagerClass, заменяя стандартный класс fl.video.NCManager.
Класс NCManager поддерживает подмножество SMIL для обработки нескольких потоков для нескольких полос пропускания.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| align : String
Задает способ отображения видео относительно свойств registrationX, registrationY, registrationWidth и registrationHeight. | VideoPlayer | ||
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| autoRewind : Boolean
Логический параметр, вызывающий (в случае значения true) перемотку FLV-файла к кадру 1 после остановки воспроизведения по причине достижения конца потока или вызова метода stop(). | VideoPlayer | ||
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| bufferTime : Number
Число, указывающее количество секунд для буферизации в памяти перед началом воспроизведения видеопотока. | VideoPlayer | ||
| bytesLoaded : uint [только для чтения]
Число, указывающее объем загружаемых данных по HTTP (в байтах). | VideoPlayer | ||
| bytesTotal : uint [только для чтения]
Число, указывающее общее количество загруженных байт по HTTP. | VideoPlayer | ||
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| deblocking : int
Указывает тип фильтра, применяемого к дешифрованному видео в ходе последующей обработки. | Video | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| height : Number [переопределить]
Число, указывающее высоту экземпляра VideoPlayer (в пикселах). | VideoPlayer | ||
| idleTimeout : Number
Промежуток времени (в миллисекундах) перед тем, как приложение Flash закрывает бездействующее подключение к видеосерверу (например, FMS) из-за того, что воспроизведение приостановлено или остановлено. | VideoPlayer | ||
| iNCManagerClass : Object = fl.video.NCManager [статические]
Установите в качестве значения свойств iNCManagerClass объект класса или строковое имя пользовательского класса, чтобы объекты VideoPlayer использовали их в качестве реализации интерфейса INCManager по умолчанию. | VideoPlayer | ||
| isLive : Boolean [только для чтения]
Логический параметр, принимающий значение true, если видеопоток воспроизводится в реальном времени. | VideoPlayer | ||
| isRTMP : Boolean [только для чтения]
Логическое значение, принимающее значение true, если FLV-файл воспроизводится в потоковом режиме с сервера FMS по протоколу RTMP. | VideoPlayer | ||
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| metadata : Object [только для чтения]
Объект, представляющий собой пакет метаданных, полученный в результате вызова метода обратного вызова NetSteam.onMetaData(), если такой объект доступен. | VideoPlayer | ||
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| ncMgr : INCManager [только для чтения]
Объект INCManager, предоставляющий доступ к экземпляру класса, реализующего интерфейс INCManager к классу NCManager. | VideoPlayer | ||
| netConnection : NetConnection [только для чтения]
Разрешает прямой доступ к экземпляру подключения NetConnection, созданному видеопроигрывателем. | VideoPlayer | ||
| netStream : NetStream [только для чтения]
Разрешает прямой доступ к экземпляру NetStream, созданному видеопроигрывателем. | VideoPlayer | ||
| netStreamClientClass : Object [статические]
Регистрирует пользовательский класс клиентского свойства NetStream. | VideoPlayer | ||
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
| playheadTime : Number
Число, обозначающее текущее время воспроизведения или положение, которое может быть дробным (в секундах). | VideoPlayer | ||
| playheadUpdateInterval : Number
Число, представляющее промежуток времени (в миллисекундах) между событиями playheadUpdate. | VideoPlayer | ||
| progressInterval : Number
Число, представляющее промежуток времени (в миллисекундах) между событиями progress. | VideoPlayer | ||
| registrationHeight : Number
Высота, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. | VideoPlayer | ||
| registrationWidth : Number
Ширина, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. | VideoPlayer | ||
| registrationX : Number
Координата по горизонтали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. | VideoPlayer | ||
| registrationY : Number
Координата по вертикали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. | VideoPlayer | ||
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
| rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | |
| rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
| rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleMode : String
Указывает способ изменения размеров видео после загрузки. | VideoPlayer | ||
| scaleX : Number [переопределить]
Число, являющееся масштабом по горизонтали. | VideoPlayer | ||
| scaleY : Number [переопределить]
Число, являющееся масштабом по вертикали. | VideoPlayer | ||
| scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| smoothing : Boolean
Определяет, должно ли выполняться сглаживание (интерполяция) видео при масштабировании. | Video | |
| soundTransform : flash.media:SoundTransform
Предоставляет непосредственный доступ к свойству NetStream.soundTransform, обеспечивая дополнительный возможности управления звуком. | VideoPlayer | ||
| source : String [только для чтения]
Строка, задающая URL-адрес FLV-файла и метод его потокового воспроизведения. | VideoPlayer | ||
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| state : String [только для чтения]
Строка, задающая состояние компонента. | VideoPlayer | ||
| stateResponsive : Boolean [только для чтения]
Логический параметр, принимающий значение true, если состояние разрешает работу элементов управления. | VideoPlayer | ||
| totalTime : Number [только для чтения]
Число, определяющее общее время воспроизведения видео (секунды). | VideoPlayer | ||
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
| videoHeight : int [переопределить] [только для чтения]
Исходная ширина загруженного FLV-файла. | VideoPlayer | ||
| videoWidth : int [переопределить] [только для чтения]
Исходная ширина загруженного FLV-файла. | VideoPlayer | ||
| visible : Boolean [переопределить]
Логический параметр, делающий (в случае значения true) видимым экземпляр VideoPlayer. | VideoPlayer | ||
| volume : Number
Число в диапазоне от 0 до 1, указывающее уровень громкости. | VideoPlayer | ||
| width : Number [переопределить]
Число, указывающее ширину экземпляра VideoPlayer на монтажном столе. | VideoPlayer | ||
| x : Number [переопределить]
Число, указывающее положение видеопроигрывателя по горизонтали (в пикселах). | VideoPlayer | ||
| y : Number [переопределить]
Число, указывающее положение видеопроигрывателя по вертикали (в пикселах). | VideoPlayer | ||
| z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
Создает объект VideoPlayer заданной ширины и высоты. | VideoPlayer | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Задает видеопоток с камеры для отображения в пределах объекта Video в окне приложения. | Video | |
|
Задает видеопоток для отображения в пределах объекта Video в окне приложения. | Video | |
|
Удаляет отображаемое в данный момент изображение в объекте Video (а не видеопоток). | Video | |
Принудительно закрывает видеопоток и подключение к серверу Flash Media Server. | VideoPlayer | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Аналогичен методу play(), но взывает загрузку FLV-файла без воспроизведения. | VideoPlayer | ||
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения подключения после вызова метода INCManager.connectToURL(). | VideoPlayer | ||
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения переподключения после вызова метода INCManager.reconnect(). | VideoPlayer | ||
Приостанавливает воспроизведение видео. | VideoPlayer | ||
play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Вызывает воспроизведение видео. | VideoPlayer | ||
Воспроизведение FLV-файла при загрузке достаточной части файла. | VideoPlayer | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды). | VideoPlayer | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
Одновременно задает свойства масштаба по горизонтали и вертикали. | VideoPlayer | ||
Одновременно задает свойства ширины и высоты. | VideoPlayer | ||
Останавливает воспроизведение видео. | VideoPlayer | ||
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
| Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
| Отправляется при перемещении точки воспроизведения в начальное положение видеопроигрывателя, поскольку свойство autoRewind имеет значение true. | VideoPlayer | |||
| Отправляется экземпляром VideoPlayer, когда подключение NetConnection закрывается по истечении времени ожидания или вызовом метода close(), а также при вызове методов load() или play(), либо установке свойства source, в результате чего закрывается подключение RTMP. | VideoPlayer | |||
| Отправляется, когда воспроизведение завершается по достижении конца FLV-файла. | VideoPlayer | |||
| Отправляется по достижении ключевой точки. | VideoPlayer | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| событие drmAuthenticate | VideoPlayer | |||
| событие drmError | VideoPlayer | |||
| событие drmError | VideoPlayer | |||
| [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
| [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
| Отправляется при изменении размера или макета видеопроигрывателя. | VideoPlayer | |||
| Первый раз отправляется при достижении метаданных FLV-файла. | VideoPlayer | |||
| Отправляется, когда FLV-файл воспроизводится с частотой, указанной в свойстве playheadUpdateInterval, а также при начале перемотки. | VideoPlayer | |||
| Показывает ход загрузки, отображая число загруженных байтов. | VideoPlayer | |||
| Событие, отправляемое, когда FLV-файл загружен и готов к отображению. | VideoPlayer | |||
| Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
| Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
| [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
| Отправляется при изменении состояния воспроизведения. | VideoPlayer | |||
| Константа | Определено | ||
|---|---|---|---|
| SHORT_VERSION : String = "2.1" [статические]
Переменная состояния, указывающая сокращенный номер версии компонента. | VideoPlayer | ||
| VERSION : String = "2.1.0.23" [статические]
Переменная состояния, указывающая полный номер версии компонента. | VideoPlayer | ||
align | свойство |
align:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Устанавливает отображение видео относительно свойств registrationX, registrationY, registrationWidth и registrationHeight. Свойство align создает автоматическое размещение, если для свойства scaleMode установлено значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE. Изменение данного свойства после загрузки FLV-файла приводит к немедленному началу автоматического размещения. Значения приходят от класса VideoAlign.
Значением по умолчанию является VideoAlign.CENTER.
Реализация
public function get align():String public function set align(value:String):voidСвязанные элементы API
autoRewind | свойство |
autoRewind:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
В случае значения true логический параметр вызывает перемотку FLV-файла к кадру 1 после остановки воспроизведения по причине достижения конца потока или вызова метода stop(). Данное свойство неприменимо к потоковому воспроизведению.
Значением по умолчанию является false.
Реализация
public function get autoRewind():Boolean public function set autoRewind(value:Boolean):voidbufferTime | свойство |
bufferTime:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее количество секунд для буферизации в памяти перед началом воспроизведения видеопотока. Для FLV-файлов, воспроизводимых в потоке с RTMP, которые не загружены и не буферизированы в памяти, необходимо уменьшить данное значение со стандартного на значение 0,1. При последовательной загрузке FLV-файла с HTTP можно увеличить данное значение, что позволит улучшить воспроизведение высококачественного видео на старом медленном компьютере.
Для предварительно записанного видео (не потоковое воспроизведение) не устанавливайте для свойства bufferTime значение 0. Используйте стандартное время для буфера или увеличьте его.
Данное свойство не определяет размер загружаемого FLV-файла перед началом воспроизведения.
Реализация
public function get bufferTime():Number public function set bufferTime(value:Number):voidСвязанные элементы API
bytesLoaded | свойство |
bytesLoaded:uint [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее объем загружаемых данных по HTTP (в байтах). Возвращает значение 0, если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.
Реализация
public function get bytesLoaded():uintbytesTotal | свойство |
bytesTotal:uint [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее общее количество загруженных байт по HTTP. Возвращает значение «-1», если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.
Реализация
public function get bytesTotal():uintheight | свойство |
height:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее высоту экземпляра VideoPlayer (в пикселах).
Примечание. Не путайте данное свойство с свойством flash.media.Video.height, аналогичным свойству fl.video.VideoPlayer.videoHeight.
Реализация
override public function get height():Number override public function set height(value:Number):voidСвязанные элементы API
idleTimeout | свойство |
idleTimeout:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Промежуток времени (в миллисекундах) перед тем, как приложение Flash закрывает бездействующее подключение к видеосерверу (например, FMS) из-за того, что воспроизведение приостановлено или остановлено. Данное свойство не действует при загрузке FLV-файла по протоколу HTTP.
Если установить данное свойство, когда видео находится в режиме бездействия, то свойство перезапустит период таймаута с новым значением.
Реализация
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidiNCManagerClass | свойство |
public static var iNCManagerClass:Object = fl.video.NCManager| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Для того чтобы объекты VideoPlayer использовали пользовательский класс как стандартную реализацию интерфейса INCManager, установите для свойства iNCManagerClass значение объекта класса или имени пользовательского класса. Класс FLVPlayback включает описание пользовательского класса. Видеопроигрыватель не включает описание класса.
Значением по умолчанию является строка fl.video.NCManager.
isLive | свойство |
isLive:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Логический параметр, принимающий значение true, если видеопоток воспроизводится в реальном времени. Данное свойство действительно, только если поток воспроизводится с видосервера, такого как Flash Media Server (FMS) или другого сервиса Flash Video Streaming Service (FVSS). Данное свойство игнорируется при HTTP-загрузке.
Установите для свойства isLive значение false при отправке предварительно записанного видеопотока в видеопроигрыватель и установите значение true при отправке данных реального времени, таких как прямая трансляция. Для улучшения производительности при установке для свойства isLive значения false не устанавливайте для свойства bufferTime значение 0.
Реализация
public function get isLive():BooleanСвязанные элементы API
isRTMP | свойство |
isRTMP:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Логическая переменная, принимающая значение true, если FLV-файл воспроизводится в потоковом режиме с сервера FMS по протоколу RTMP. Принимает начение false для любых других источников FLV-файла.
Реализация
public function get isRTMP():BooleanСвязанные элементы API
metadata | свойство |
metadata:Object [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Объект, представляющий собой пакет метаданных, полученных в результате вызова метода обратного вызова NetSteam.onMetaData(), если такой объект доступен. Готово, если передано событие metadataReceived.
Если FLV-файл закодирован с помощью кодировщика Flash 8, то свойство metadata содержит следующую информацию. Старые FLV-файлы содержат только значения height, width и duration.
| Параметр | Описание |
|---|---|
canSeekToEnd | Логическое значение равно true, если FLV-файл закодирован с ключевым кадром в последнем кадре, позволяющем перемещаться в конец последовательно загружаемого фрагмента ролика. Значение параметра false, если FLV-файл не имеет ключевого кадра в последнем кадре. |
cuePoints | Массив объектов, один для каждой ключевой точки, встроенный в FLV-файл. Значение undefined, если FLV-файл не имеет контрольных точек. Каждый объект имеет следующие свойства:
|
audiocodecid | Число, указывающее на используемый аудиокодек (способ кодирования/декодирования). |
audiodelay | Число, представляющее момент времени 0 в исходном файле, с которого декодирован FLV-файл.
Используется задержка видеоряда на короткий период времени, необходимая для синхронизации звука. Например, если значение Обратите внимание, что классы FLVPlayback и VideoPlayer имеют параметры компенсации этой задержки. Это означает, что можно продолжать использовать параметры настройки времени, применяемые в исходном файле. |
audiodatarate | Скорость передачи аудио: килобайтов в секунду. |
videocodecid | Номер версии кодека, используемого для кодирования видео. |
framerate | Частота кадров FLV-файла. |
videodatarate | Скорость передачи видеоданных FLV-файла. |
height | Высота видео в FLV-файле. |
width | Ширина видео в FLV-файле. |
duration | Число, определяющее длительность видео в FLV-файле (в секундах). |
Реализация
public function get metadata():ObjectСвязанные элементы API
ncMgr | свойство |
ncMgr:INCManager [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Объект INCManager, предоставляющий доступ к экземпляру класса, реализующего интерфейс INCManager к классу NCManager.
Можно использовать данное свойство для реализации пользовательского класса INCManager, требующего инициализации пользователем.
Реализация
public function get ncMgr():INCManagerСвязанные элементы API
netConnection | свойство |
netConnection:NetConnection [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Разрешает прямой доступ к экземпляру подключения NetConnection, созданному видеопроигрывателем.
Реализация
public function get netConnection():NetConnectionnetStream | свойство |
netStreamClientClass | свойство |
public static var netStreamClientClass:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.115.0, AIR 1.0 |
Регистрирует пользовательский класс клиентского свойства 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.
Выдает
VideoError — Если для данного свойства установлено недопустимое значение, то вызывается ошибка VideoError.NETSTREAM_CLIENT_CLASS_UNSET.
|
playheadTime | свойство |
playheadTime:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, обозначающее текущее время воспроизведения или положение, которое может быть дробным (в секундах). Установка данного свойства запускает процесс перехода и имеет все ограничения для процесса перехода.
Если измененяется время точки воспроизведения, которое при воспроизведении FLV-файла меняется четыре раза в секунду, то компонент отправляет событие playheadUpdate.
По нескольким причинам свойство playheadTime может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime. Во-первых, при последовательной загрузке можно перейти только к ключевому кадру, поэтому переход происходит к первому ближайшему ключевому кадру к заданному времени. При использовании потокового воспроизведения переход осуществляется точно в указанное время, даже если исходный FLV-файл не имеет ключевых кадров. Во-вторых, процесс перехода асинхронный, то есть, если вызвать метод перехода или установить значение для свойства playheadTime, значение свойства playheadTime обновится с задержкой. Для получения времени после завершения перехода прослушивайте событие seek, которое не посылается, пока не обновится свойство playheadTime.
Реализация
public function get playheadTime():Number public function set playheadTime(value:Number):voidСвязанные элементы API
playheadUpdateInterval | свойство |
playheadUpdateInterval:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, представляющее промежуток времени (в миллисекундах) между событиями playheadUpdate. Установка данного значения при воспроизведении FLV-файла перезапустит таймер.
Так как ключевые точки ActionScript начинаются при обновлении точек воспроизведения, то уменьшение значения свойства playheadUpdateInterval позволит повысить точность ключевых точек ActionScript.
Так как интервал обновления точек воспроизведения устанавливается глобальным методом setInterval(), то обновление не может запускаться чаще частоты кадров SWF-файла, как и любой интервал, устанавливаемый данным методом. Так, например для стандартной частоты 12 кадров в секунду минимальный эффективный интервал, который можно создать, равен приблизительно 83 миллисекундам, или 1/12 секунды (1000 миллисекунд, деленные на 12).
Значением по умолчанию является 250.
Реализация
public function get playheadUpdateInterval():Number public function set playheadUpdateInterval(value:Number):voidСвязанные элементы API
progressInterval | свойство |
progressInterval:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, представляющее промежуток времени (в миллисекундах) между событиями progress. Если установить данное свойство при воспроизведении видеопотока, то таймер перезапустится.
Реализация
public function get progressInterval():Number public function set progressInterval(value:Number):voidregistrationHeight | свойство |
registrationHeight:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Высота, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationHeight с свойством height. Свойство height показывает фактическую высоту видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
Установка свойства registrationHeight аналогична установке свойства height, и наоборот. При установке любого другого свойства или вызове любого метода, влияющего на высоту, таких как scaleX, setSize и setScale, также синхронно сохраняются свойства height и registrationHeight.
Реализация
public function get registrationHeight():Number public function set registrationHeight(value:Number):voidСвязанные элементы API
registrationWidth | свойство |
registrationWidth:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Ширина, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationWidth с свойством width. Свойство width показывает фактическую ширину видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
Установка свойства registrationWidth аналогична установке свойства width, и наоборот. При установке любого другого свойства или вызове любого метода, влияющего на ширину, таких как scaleX, setSize и setScale, также синхронно сохраняются свойства width и registrationWidth.
Реализация
public function get registrationWidth():Number public function set registrationWidth(value:Number):voidСвязанные элементы API
registrationX | свойство |
registrationX:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Координата по горизонтали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством x, которое показывает фактическое положение видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
При установке свойства x или registrationX} второе свойство меняется, сохраняя свое смещение от первого. Например, если x = 10 и registrationX = 20, то при установке значения x = 110 значение registrationX устанавливается равным 120.
Реализация
public function get registrationX():Number public function set registrationX(value:Number):voidСвязанные элементы API
registrationY | свойство |
registrationY:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Координата по вертикали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством y, которое показывает фактическое положение видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
Пример 2. Загрузите тот же сценарий, что и в примере 1, но со следующими параметрами:
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
Пример 3. Загрузите тот же сценарий, что в примере 2, но со следующими параметрами:
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
При установке свойства y или registrationY второе свойство меняется, сохраняя свое смещение от первого. Например, если y = 10 и registrationY = 20, то при установке значения y = 110 значение registrationY устанавливается равным 120.
Реализация
public function get registrationY():Number public function set registrationY(value:Number):voidСвязанные элементы API
scaleMode | свойство |
scaleMode:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Указывает способ изменения размеров видео после загрузки. Если установлено значение 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.
Реализация
public function get scaleMode():String public function set scaleMode(value:String):voidСвязанные элементы API
scaleX | свойство |
scaleX:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, являющееся масштабом по горизонтали.
Значением по умолчанию является 1.
Реализация
override public function get scaleX():Number override public function set scaleX(value:Number):voidСвязанные элементы API
scaleY | свойство |
scaleY:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, являющееся масштабом по вертикали.
Значением по умолчанию является 1.
Реализация
override public function get scaleY():Number override public function set scaleY(value:Number):voidСвязанные элементы API
soundTransform | свойство |
soundTransform:flash.media:SoundTransform| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Предоставляет прямой доступ к свойству к свойству NetStream.soundTransform, обеспечивая дополнительные возможности управления звуком. Установите свойство для изменения параметров. Используйте метод accessor получателя для определения текущих параметров.
Реализация
public function get soundTransform():flash.media:SoundTransform public function set soundTransform(value:flash.media:SoundTransform):voidСвязанные элементы API
source | свойство |
source:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Строка, задающая 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-файла.
Реализация
public function get source():StringСвязанные элементы API
state | свойство |
state:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Строка, задающая состояние компонента. Данное свойство устанавливается методами load(), play(), stop(), pause() и seek().
Возможные значения для свойства состояния: buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking и stopped. Для определения этих состояний можно использовать свойства класса FLVPlayback.
Реализация
public function get state():StringСвязанные элементы API
stateResponsive | свойство |
stateResponsive:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Логический параметр, принимающий значение true, если состояние является управляемым. Если состояние неуправляемое, то вызов методов play(), load(), stop(), pause() и seek() будет поставлен в очередь, а выполнение отложено до момента, когда состояние изменится на управляемое. Так как эти вызовы будут поставлены в очередь и их выполнение отложено, то нет необходимости следить за значением свойства stateResponsive. Управляемые состояния: stopped, playing, paused и buffering.
Реализация
public function get stateResponsive():BooleanСвязанные элементы API
totalTime | свойство |
totalTime:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, определяющее общее время воспроизведения видео (секунды).
При потоковом воспроизведении с Flash Media Server (FMS) и использовании стандартного объекта NCManager данное значение определяется автоматически интерфейсом программного приложения сервера (APIs), и данное значение отменяет все установленное через данное свойство или полученное с метаданных. Данное свойство готово для чтения, если после установки свойства source получено состояние stopped или playing. Данное свойство неприменимо при потоковом воспроизведении с FMS.
При HTTP-загрузке, если FLV-файл имеет встроенные метаданные, значение определяется автоматически. В противном случае установите его явно, иначе оно будет установлено как NaN. При явной установке значение, полученное из метаданных потока, будет проигнорировано.
После установки данного свойства значение вступит в силу для следующего FLV-файла, загружаемого установкой свойства source. Оно не влияет на уже загруженный FLV-файл. Также данное свойство не возвращает значение, переданное до загрузки FLV-файла.
Если данное свойство не установить (явно или автоматически), то воспроизведение продолжает работать, но могут возникнуть проблемы с элементами управления переходом.
Если свойство не установлено явно, то свойство будет иметь значение NaN, пока не будет установлено правильное значение из метаданных.
Реализация
public function get totalTime():NumberСвязанные элементы API
videoHeight | свойство |
videoHeight:int [только для чтения] [переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.
Реализация
override public function get videoHeight():intСвязанные элементы API
videoWidth | свойство |
videoWidth:int [только для чтения] [переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.
Реализация
override public function get videoWidth():intСвязанные элементы API
visible | свойство |
visible:Boolean[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Если данный логический параметр имеет значение true, экземпляр VideoPlayer делается видимым. В случае значения false экземпляр делается невидимым.
Значением по умолчанию является true.
Реализация
override public function get visible():Boolean override public function set visible(value:Boolean):voidvolume | свойство |
volume:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число в диапазоне от 0 до 1, указывающее уровень громкости.
Значением по умолчанию является 1.
Реализация
public function get volume():Number public function set volume(value:Number):voidСвязанные элементы API
width | свойство |
width:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее ширину экземпляра VideoPlayer на монтажном столе.
Примечание. Свойство flash.media.Video.width аналогично свойству fl.video.VideoPlayer.videoWidth.
Реализация
override public function get width():Number override public function set width(value:Number):voidСвязанные элементы API
x | свойство |
x:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее положение видеопроигрывателя по горизонтали (в пикселах).
Установка свойства x также влияет на значение свойства registrationX. При установке свойства x или registrationX} второе свойство меняется, сохраняя свое смещение от первого. Например, если x = 10 и registrationX = 20, то при установке значения x = 110 значение registrationX устанавливается равным 120.
Реализация
override public function get x():Number override public function set x(value:Number):voidСвязанные элементы API
y | свойство |
y:Number[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Число, указывающее положение видеопроигрывателя по вертикали (в пикселах).
Установка свойства y также влияет на значение свойства registrationY. При установке свойства y или registrationY второе свойство меняется, сохраняя свое смещение от первого. Например, если y = 10 и registrationY = 20, то при установке значения y = 110 значение registrationY устанавливается равным 120.
Реализация
override public function get y():Number override public function set y(value:Number):voidСвязанные элементы API
VideoPlayer | () | Конструктор |
public function VideoPlayer(width:int = 320, height:int = 240)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Создает объект VideoPlayer заданной ширины и высоты.
Параметрыwidth:int (default = 320) | |
height:int (default = 240) |
Связанные элементы API
close | () | метод |
public function close():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Принудительно закрывает видеопоток и подключение к серверу Flash Media Server. Данный метод запускает событие close. Нет необходимости непосредственно вызывать данный метод, потому что функция таймаута при бездействии проигрывателя позаботится о закрытии потока.
Связанные элементы API
load | () | метод |
public function load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Данный метод аналогичен методу play(), но вызывает загрузку FLV-файла без последующего воспроизведения. Если необходимо, то при отображении первого кадра FLV-файла выполняется автоматическое изменение размеров. После начальной загрузки файла и автоматической установки размеров видеопроигрыватель переходит в состояние VideoState.PAUSED.
Данный метод принимает такие же параметры, как и метод play(), но нельзя вызывать метод load() без значения URL-адреса. При попытке вызова без значения URL-адреса возникает ошибка. Если видеопроигрыватель находится в неуправляемом состоянии, то запрос метода load() будет поставлен в очередь.
Параметры
url:String — URL-адрес для FLV-файла, который необходимо загрузить. Если для URL-адреса не передано значения, то создается ошибка с сообщением null URL sent to VideoPlayer.load.
| |
totalTime:Number (default = NaN)null или не определено для автоматического определения длины файла из метаданных, с сервера или XML-файла.
| |
isLive:Boolean (default = false)true при воспроизведении потока непосредственно с Flash Media Server (FMS).
| |
startTime:Number (default = NaN) | |
duration:Number (default = NaN) |
Связанные элементы API
ncConnected | () | метод |
public function ncConnected():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Вызывается объектом INCManager в случае успешного или неуспешного завершения подключения, после вызова метода INCManager.connectToURL(). После неуспешного соединения перед вызовом метода установите для свойства INCManager.netConnection значение null или «не определено».
Связанные элементы API
ncReconnected | () | метод |
public function ncReconnected():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Вызывается объектом INCManager после завершения или сбоя повторного подключения, после того как завершен вызов метода INCManager.reconnect(). Если соединение разорвано, установите для свойства INCManager.netconnection значение null перед вызовом метода.
Связанные элементы API
pause | () | метод |
public function pause():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Приостанавливает воспроизведение видео. Не влияет на остановленное или приостановленное видео. Для продолжения воспроизведения вызовите метод play(). Не имеет параметров.
Если проигрыватель находится в неуправляемом состоянии, то запрос метода pause() будет поставлен в очередь.
При вызове метода без подключенного потока создается исключение. Используйте событие stateChange и значение свойства connected для определения безопасного момента для вызова метода.
Если проигрыватель находится в остановленном состоянии, то вызов метода pause() не влияет на проигрыватель, который останется в остановленном состоянии.
Связанные элементы API
play | () | метод |
public function play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Вызывает воспроизведение видео. Можно вызвать метод, если воспроизведение приостановлено или остановлено, или если видео уже воспроизводится. Вызовите данный метод без параметров для воспроизведения уже загруженного видеофайла или передайте URL-адрес для загрузки нового потока.
Если проигрывательнаходится в неуправляемом состоянии, то запрос будет поставлен в очередь.
Если метод вызывается без аргументов и в данный момент нет подключенного потока, то создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange и значение свойства connected.
Параметры
url:String (default = null)null.
| |
totalTime:Number (default = NaN)0 или NaN. Если при вызове свойства ncConnected свойство INCManager.streamLength не равно 0, null или не определено, то то значение свойства имеет приоритет над значением данного параметра.
| |
isLive:Boolean (default = false)true, если выполняется потоковое воспроизведение с Flash Media Server (FMS).
| |
startTime:Number (default = NaN) | |
duration:Number (default = NaN) |
Связанные элементы API
playWhenEnoughDownloaded | () | метод |
public function playWhenEnoughDownloaded():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Воспроизведение FLV-файла при загрузке достаточной части файла. Если FLV-файл уже загружен или происходит потоковое воспроизведение с Flash Media Server (FMS), то вызов метода playWhenEnoughDownloaded() аналогичен вызову метода play() без параметров. Вызов данного метода не приостанавливает воспроизведение, поэтому во многих случаях перед вызовом этого метода необходимо вызвать метод pause().
seek | () | метод |
public function seek(time:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды). Если видео воспроизводится, то воспроизведение продолжится с этой точки. Если видео приостановлено, то видео переместится в эту точку и останется в приостановленном состоянии. Если видео остановлено, то видео переместится в эту точку и перейдет в приостановленное состояние. Неприменимо для потокового воспроизведения.
Свойство playheadTime может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime. При использовании последовательной загрузки можно перейти только в ключевой кадр. Поэтому переход перемещает пользователя в первый ближайший ключевой кадр к указанному времени.
Примечание. При потоковом воспроизведении переход осуществляется точно на указанное время, даже если исходный FLV-файл не имеет ключевых кадров.
Процесс перехода асинхронный, то есть при вызове метода перехода или установке значения для свойства playheadTime, значение свойства playheadTime обновляется с задержкой. Для получения значения времени после завершения перехода программа прослушивает событие seek, которое не будет запущено до завершения обновления свойства playheadTime.
При вызове метода без подключенного потока создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange и значение свойства connected.
Параметры
time:Number — Число, определяющее время (в секундах), в которое устанавливается точка воспроизведения.
|
Выдает
VideoError — Если время < 0 или NaN.
|
Связанные элементы API
setScale | () | метод |
public function setScale(scaleX:Number, scaleY:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Одновременно задает свойства scaleX и scaleY. Установка scaleX или scaleY по отдельности вызывает два события autolayout, в то время как вызов метода setScale() вызывает только одно событие autolayout.
Если свойство scaleMode имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то вызов данного метода немедленно запускает событие autolayout.
Параметры
scaleX:Number — Число, представляющее масштаб по горизонтали.
| |
scaleY:Number — Число, представляющее масштаб по вертикали.
|
Связанные элементы API
setSize | () | метод |
public function setSize(width:Number, height:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Одновременно задает свойства width и height. Установка только свойства width или height запускает два события autolayout, тогда как при вызове метода setSize() запускается только одно событие autolayout.
Если свойство scaleMode имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то вызов данного метода немедленно запускает событие autolayout.
Параметры
width:Number — Ширина видеопроигрывателя.
| |
height:Number — Высота видеопроигрывателя.
|
Связанные элементы API
stop | () | метод |
public function stop():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Останавливает воспроизведение видео. Если для свойства autoRewind установлено значение true, то производится перемотка видео к первому кадру. Не оказывает влияния на проигрыватель, если воспроизведение уже остановлено. Для продолжения воспроизведения вызовите метод play(). Не имеет параметров.
Если проигрыватель находится в неуправляемом состоянии, запрос будет поставлен в очередь.
При вызове метода без подключенного потока создается исключение. Используйте событие stateChange и значение свойства connected для определения безопасного момента для вызова метода.
Связанные элементы API
autoRewound | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.AUTO_REWOUND| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется когда точка воспроизведения переходит в начало видеопроигрывателя, потому что для свойства autoRewind установлено значение true.
Событие autoRewound относится к типу VideoEvent и имеет константу VideoEvent.AUTO_REWOUND.
type для объекта события autoRewound.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
close | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.CLOSE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется экземпляром VideoPlayer, когда подключение NetConnection закрывается по истечении времени ожидания, или при вызове метода close(), а также при вызове методов load() или play() или при установке свойства source. В результате закрывается подключение RTMP. Экземпляр FLVPlayback отправляет данное событие только при воспроизведении потока с сервера Flash Media Server (FMS) или другого сервиса Flash Video Streaming Service (FVSS).
Событие close относится к типу VideoEvent и имеет константу VideoEvent.CLOSE.
type для объекта события close.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
complete | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.COMPLETE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется, когда воспроизведение завершается по достижении конца FLV-файла. Компонент не отправляет событие, если вызван метод stop() или pause() или выбран соответствующий элемент управления.
Если приложение использует последовательную загрузку, то свойство totalTime не устанавливается явным образом. При этом загружается FLV-файл, в метаданных которого не указана длительность. Перед отправкой данного события видеопроигрыватель устанавливает свойство totalTime равным приблизительному общему значению.
Видеопроигрыватель также отправляет события stateChange и stopped.
Событие complete относится к типу VideoEvent и имеет константу VideoEvent.COMPLETE.
type для объекта события complete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
cuePoint | Событие |
fl.video.MetadataEventсвойство MetadataEvent.type =
fl.video.MetadataEvent.CUE_POINT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется по достижении ключевой точки. Объект события имеет свойство info, содержащее информацию об объекте, полученную отзывом события NetStream.onCuePoint для ключевых точек FLV-файла. Для ключевых точек ActionScript он содержит объект, переданный в методы ключевых точек ActionScript или свойства.
Событие cuePoint относится к типу MetadataEvent и имеет константу MetadataEvent.CUE_POINT.
type для объекта события cuePoint.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
info | Объект со свойствами, описывающими ключевую точку. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
drmAuthenticate | Событие |
flash.events.DRMAuthenticateEvent| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | AIR 1.0 |
событие drmAuthenticate
drmError | Событие |
flash.events.DRMErrorEvent| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | AIR 1.0 |
событие drmError
drmStatus | Событие |
flash.events.DRMStatusEvent| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | AIR 1.0 |
событие drmError
layout | Событие |
fl.video.LayoutEventсвойство LayoutEvent.type =
fl.video.LayoutEvent.LAYOUT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется при изменении размера или макета видеопроигрывателя. Есть два случая, при которых появляется событие layout.
- Если видеопроигрыватель изменяет размеры с помощью события
autoLayoutили вызова методовsetScale()илиsetSize(), или изменением свойствwidth,height,scaleXиscaleY. - Если есть два видеопроигрывателя с разными размерами, свойство
visibleVideoPlayerIndexпереключается с одно видеопроигрывателя на другой.
Событие layout относится к типу VideoEvent и имеет константу LayoutEvent.LAYOUT.
type для объекта события Layout.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
oldBounds | Указывает значения свойств x, y, width и height целевого объекта перед отправкой события layout. |
oldRegistrationBounds | Указывает значения свойств registrationX , registrationY, registrationWidth и registrationHeight целевого объекта перед отправкой события layout. |
Связанные элементы API
metadataReceived | Событие |
fl.video.MetadataEventсвойство MetadataEvent.type =
fl.video.MetadataEvent.METADATA_RECEIVED| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Первый раз отправляется при достижении метаданных FLV-файла. Объект события имеет свойство info, содержащее информацию об объекте, полученную обратным вызовом события NetStream.onMetaData.
Событие metadataReceived относится к типу VideoEvent и имеет константу MetadataEvent.METADATA_RECEIVED.
type для объекта события metadataReceived.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
info | Объект со свойствами, описывающими FLV-файл. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
playheadUpdate | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.PLAYHEAD_UPDATE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется при воспроизведении FLV-файла, с частотой, указанной в свойстве playheadUpdateInterval, или при начале процесса перемотки. Данный компонент не отправляет это событие, когда видеопроигрыватель находится в приостановленном состоянии или остановлен, если только не производится поиск.
Событие playheadUpdate относится к типу VideoEvent и имеет константу VideoEvent.PLAYHEAD_UPDATE.
type для объекта события playheadUpdate.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
progress | Событие |
fl.video.VideoProgressEventсвойство VideoProgressEvent.type =
fl.video.VideoProgressEvent.PROGRESS| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Показывает ход загрузки, отображая число загруженных байтов. Отправляется с частотой, определяемой свойством progressInterval, начинается одновременно с загрузкой и заканчивается, когда все байты загружены или произошла сетевая ошибка. По умолчанию событие отправляется каждые 0,25 секунды при вызове загрузки и заканчивается после загрузки всех байтов или появления сетевой ошибки. Используйте данное событие для проверки загруженных байтов или количества байтов в буфере.
Отправляется только при последовательной загрузке HTTP. Показывает ход загрузки, отображая количество загруженных байтов. Объект события имеет свойства bytesLoaded и bytesTotal, которые выполняют те же функции, что и свойства FLVPlayback с теми же именами.
Событие progress относится к типу VideoProgressEvent и имеет константу VideoProgressEvent.PROGRESS.
type для объекта события progress.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые будут получены в случае успешного завершения загрузки. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
ready | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.READY| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Событие, отправляемое, когда FLV-файл загружен и готов к отображению. Событие начинается первый раз при переходе видеопроигрывателя в управляемое состояние после загрузки нового FLV-файла методом play() или load(). Событие начинается один раз при каждой загрузки FLV-файла.
Событие ready относится к типу VideoEvent и имеет константу VideoEvent.READY.
type для объекта события ready.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
stateChange | Событие |
fl.video.VideoEventсвойство VideoEvent.type =
fl.video.VideoEvent.STATE_CHANGE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется при изменении состояния воспроизведения. После завершения вызова autoRewind отправляется событие stateChange с состоянием перемотки видео. Событие stateChange не отправляется, пока не будет завершена перемотка видео.
Событие может использоваться для определения перехода в состояние воспроизведения или выхода из неуправляемых состояний, таких как середина процесса подключения, изменение размеров или процесс перемотки. Методы play(), pause(), stop() и seek() образуют очередь запросов на выполнение при переходе проигрывателя в управляемое состояние.
Событие stateChange относится к типу VideoEvent и имеет константу VideoEvent.STATE_CHANGE.
type для объекта события stateChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
Связанные элементы API
SHORT_VERSION | Константа |
public static const SHORT_VERSION:String = "2.1"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Переменная состояния, указывающая сокращенный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:
FLVPlayback.SHORT_VERSION
Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0. Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11.
Связанные элементы API
VERSION | Константа |
public static const VERSION:String = "2.1.0.23"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Переменная состояния, указывающая полный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:
FLVPlayback.VERSION
Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11. Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0.
Связанные элементы API
Чтобы применить этот пример на практике, выполните следующие действия.
- Добавьте в библиотеку компонент FLVPlayback.
- Введите вместо
testVideoPathабсолютный или относительный путь к FLV-файлу. - Сохраните этот код под именем VideoPlayerExample.as в том же каталоге, что и FLA-файл.
- Присвойте классу 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);
}
}
}
Tue Jun 12 2018, 11:34 AM Z