Пакет | fl.video |
Класс | public class VideoPlayer |
Наследование | VideoPlayer ![]() ![]() ![]() ![]() |
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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 для обработки нескольких потоков для нескольких полос пропускания.
См. также
Свойство | Определено | ||
---|---|---|---|
![]() | 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 Player кэширует внутреннее растровое представление экранного объекта. | 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 | ||
![]() | 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 | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
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 : SoundTransform
Предоставляет непосредственный доступ к свойству NetStream.soundTransform, обеспечивая дополнительный возможности управления звуком. | VideoPlayer | ||
source : String [только для чтения]
Строка, задающая URL-адрес FLV-файла и метод его потокового воспроизведения. | VideoPlayer | ||
![]() | stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
state : String [только для чтения]
Строка, задающая состояние компонента. | VideoPlayer | ||
stateResponsive : Boolean [только для чтения]
Логический параметр, принимающий значение true, если состояние разрешает работу элементов управления. | VideoPlayer | ||
totalTime : Number [только для чтения]
Число, определяющее общее время воспроизведения видео (секунды). | VideoPlayer | ||
![]() | transform : 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 | |
![]() | DisplayObject | ||
![]() |
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
![]() | DisplayObject | ||
![]() |
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур. | DisplayObject | |
![]() |
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные). | DisplayObject | |
![]() |
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним. | DisplayObject | |
![]() |
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Аналогичен методу play(), но взывает загрузку FLV-файла без воспроизведения. | VideoPlayer | ||
![]() |
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения подключения после вызова метода INCManager.connectToURL(). | VideoPlayer | ||
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения переподключения после вызова метода INCManager.reconnect(). | VideoPlayer | ||
![]() | DisplayObject | ||
![]() | DisplayObject | ||
Приостанавливает воспроизведение видео. | VideoPlayer | ||
Вызывает воспроизведение видео. | VideoPlayer | ||
Воспроизведение FLV-файла при загрузке достаточной части файла. | VideoPlayer | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды). | VideoPlayer | ||
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
Одновременно задает свойства масштаба по горизонтали и вертикали. | VideoPlayer | ||
Одновременно задает свойства ширины и высоты. | VideoPlayer | ||
Останавливает воспроизведение видео. | VideoPlayer | ||
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
![]() | Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
![]() | Отправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
Отправляется при перемещении точки воспроизведения в начальное положение видеопроигрывателя, поскольку свойство autoRewind имеет значение true. | VideoPlayer | |||
Отправляется экземпляром VideoPlayer, когда подключение NetConnection закрывается по истечении времени ожидания или вызовом метода close(), а также при вызове методов load() или play(), либо установке свойства source, в результате чего закрывается подключение RTMP. | VideoPlayer | |||
Отправляется, когда воспроизведение завершается по достижении конца FLV-файла. | VideoPlayer | |||
Отправляется по достижении ключевой точки. | VideoPlayer | |||
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным. | EventDispatcher | ||
![]() | [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | 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.14" [статические]
Переменная состояния, указывающая полный номер версии компонента. | VideoPlayer |
align | свойство |
align:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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
См. также
autoRewind | свойство |
autoRewind:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
В случае значения true
логический параметр вызывает перемотку FLV-файла к кадру 1 после остановки воспроизведения по причине достижения конца потока или вызова метода stop()
. Данное свойство неприменимо к потоковому воспроизведению.
Значение по умолчанию false
public function get autoRewind():Boolean
public function set autoRewind(value:Boolean):void
bufferTime | свойство |
bufferTime:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее количество секунд для буферизации в памяти перед началом воспроизведения видеопотока. Для FLV-файлов, воспроизводимых в потоке с RTMP, которые не загружены и не буферизированы в памяти, необходимо уменьшить данное значение со стандартного на значение 0,1. При последовательной загрузке FLV-файла с HTTP можно увеличить данное значение, что позволит улучшить воспроизведение высококачественного видео на старом медленном компьютере.
Для предварительно записанного видео (не потоковое воспроизведение) не устанавливайте для свойства bufferTime
значение 0
. Используйте стандартное время для буфера или увеличьте его.
Данное свойство не определяет размер загружаемого FLV-файла перед началом воспроизведения.
public function get bufferTime():Number
public function set bufferTime(value:Number):void
См. также
bytesLoaded | свойство |
bytesLoaded:uint
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее объем загружаемых данных по HTTP (в байтах). Возвращает значение 0, если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.
public function get bytesLoaded():uint
bytesTotal | свойство |
bytesTotal:uint
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее общее количество загруженных байт по HTTP. Возвращает значение "-1", если нет потока, если поток поступает с Flash Media Server (FMS) или информация еще недоступна. Возвращенное значение используется только при HTTP-загрузке.
public function get bytesTotal():uint
height | свойство |
height:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее высоту экземпляра VideoPlayer (в пикселах).
Примечание. Не путайте данное свойство с свойством flash.media.Video.height
, аналогичным свойству fl.video.VideoPlayer.videoHeight
.
public function set height(value:Number):void
См. также
idleTimeout | свойство |
idleTimeout:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Промежуток времени (в миллисекундах) перед тем, как приложение Flash закрывает бездействующее подключение к видеосерверу (например, FMS) из-за того, что воспроизведение приостановлено или остановлено. Данное свойство не действует при загрузке FLV-файла по протоколу HTTP.
Если установить данное свойство, когда видео находится в режиме бездействия, то свойство перезапустит период таймаута с новым значением.
public function get idleTimeout():Number
public function set idleTimeout(value:Number):void
iNCManagerClass | свойство |
public static var iNCManagerClass:Object = fl.video.NCManager
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Для того чтобы объекты VideoPlayer использовали пользовательский класс как стандартную реализацию интерфейса INCManager, установите для свойства iNCManagerClass
значение объекта класса или имени пользовательского класса. Класс FLVPlayback включает описание пользовательского класса. Видеопроигрыватель не включает описание класса.
Значение по умолчанию "fl.video.NCManager" as a string
isLive | свойство |
isLive:Boolean
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Логический параметр, принимающий значение true
, если видеопоток воспроизводится в реальном времени. Данное свойство действительно, только если поток воспроизводится с видосервера, такого как Flash Media Server (FMS) или другого сервиса Flash Video Streaming Service (FVSS). Данное свойство игнорируется при HTTP-загрузке.
Установите для свойства isLive
значение false
при отправке предварительно записанного видеопотока в видеопроигрыватель и установите значение true
при отправке данных реального времени, таких как прямая трансляция. Для улучшения производительности при установке для свойства isLive
значения false
не устанавливайте для свойства bufferTime
значение 0
.
public function get isLive():Boolean
См. также
isRTMP | свойство |
isRTMP:Boolean
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Логическая переменная, принимающая значение true
, если FLV-файл воспроизводится в потоковом режиме с сервера FMS по протоколу RTMP. Принимает начение false
для любых других источников FLV-файла.
public function get isRTMP():Boolean
См. также
metadata | свойство |
metadata:Object
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Объект, представляющий собой пакет метаданных, полученных в результате вызова метода обратного вызова NetSteam.onMetaData()
, если такой объект доступен. Готово, если отправлено событие metadataReceived
.
Если FLV-файл закодирован с помощью кодека Flash 8, то свойство metadata
содержит следующую информацию. Старый FLV-файл содержит только значения height
, width
и duration
.
Параметр | Описание |
---|---|
canSeekToEnd | Логический параметр принимает значение true , если FLV-файл закодирован с ключевым кадром в последнем кадре, позволяющий перемещаться в конец последовательно загружаемого фрагмента ролика. Значение параметра false , если FLV-файл не имеет ключевого кадра в последнем кадре. |
cuePoints | Массив объектов, один для каждой ключевой точки, встроенный в FLV-файл. Значение не определено, если FLV-файл не имеет ключевых точек. Каждый объект имеет следующие свойства:
|
audiocodecid | Число, указывающее на используемый аудиокодек (способ кодирования/декодирования.) |
audiodelay | Число, представляющее момент времени 0 в исходном файле, с которого декодирован FLV-файл.
Видео задерживается на короткий период времени, необходимый для синхронизации звука. Например, если значение Обратите внимание, что классы FLVPlayback и VideoPlayer имеют параметры компенсации этой задержки. Это означает, что можно продолжать использовать параметры времени, используемые в исходном файле. |
audiodatarate | Скорость передачи аудио: килобайтов в секунду. |
videocodecid | Номер версии кодека, используемого для кодирования видео. |
framerate | Частота кадров FLV-файла. |
videodatarate | Скорость передачи видеоданных FLV-файла. |
высота | Высота видео в FLV-файле. |
ширина | Ширина видео в FLV-файле. |
duration | Число, определяющее длительность видео в FLV-файле (в секундах). |
public function get metadata():Object
См. также
ncMgr | свойство |
ncMgr:INCManager
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Объект INCManager, предоставляющий доступ к экземпляру класса, реализующего интерфейс INCManager
к классу NCManager.
Можно использовать данное свойство для реализации пользовательского класса INCManager, требующего инициализации пользователем.
public function get ncMgr():INCManager
См. также
netConnection | свойство |
netConnection:NetConnection
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Разрешает прямой доступ к экземпляру подключения NetConnection, созданному видеопроигрывателем.
public function get netConnection():NetConnection
netStream | свойство |
netStream:NetStream
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Разрешает прямой доступ к экземпляру NetStream, созданному видеопроигрывателем.
public function get netStream():NetStream
netStreamClientClass | свойство |
public static var netStreamClientClass:Object
Язык версии : | ActionScript 3.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 существует вероятность нарушения метаданных и ключевой точки.
Версия проигрывателя: Flash Player 9 обновление 3.
Значение по умолчанию fl.video.VideoPlayerClient
VideoError — Если для данного свойства установлено недопустимое значение, то вызывается ошибка VideoError.NETSTREAM_CLIENT_CLASS_UNSET .
|
playheadTime | свойство |
playheadTime:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, обозначающее текущее время воспроизведения или положение, которое может быть дробным (в секундах). Установка данного свойства запускает процесс перехода и имеет все ограничения для процесса перехода.
Если измененяется время точки воспроизведения, которое при воспроизведении FLV-файла меняется четыре раза в секунду, то компонент отправляет событие playheadUpdate
.
По нескольким причинам свойство playheadTime
может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime
. Во-первых, при последовательной загрузке можно перейти только к ключевому кадру, поэтому переход происходит к первому ближайшему ключевому кадру к заданному времени. При использовании потокового воспроизведения переход осуществляется точно в указанное время, даже если исходный FLV-файл не имеет ключевых кадров. Во-вторых, процесс перехода асинхронный, то есть, если вызвать метод перехода или установить значение для свойства playheadTime, значение свойства playheadTime
обновится с задержкой. Для получения времени после завершения перехода прослушивайте событие seek
, которое не посылается, пока не обновится свойство playheadTime
.
public function get playheadTime():Number
public function set playheadTime(value:Number):void
См. также
playheadUpdateInterval | свойство |
playheadUpdateInterval:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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
См. также
progressInterval | свойство |
progressInterval:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, представляющее промежуток времени (в миллисекундах) между событиями progress
. Если установить данное свойство при воспроизведении видеопотока, то таймер перезапустится.
public function get progressInterval():Number
public function set progressInterval(value:Number):void
registrationHeight | свойство |
registrationHeight:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Высота, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationHeight
с свойством height
. Свойство height
показывает фактическую высоту видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= 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
См. также
registrationWidth | свойство |
registrationWidth:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Ширина, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте свойство registrationWidth
с свойством width
. Свойство width
показывает фактическую ширину видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= 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
См. также
registrationX | свойство |
registrationX:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Координата по горизонтали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством x
, которое показывает фактическое положение видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= 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
См. также
registrationY | свойство |
registrationY:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Координата по вертикали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров. Не путайте с свойством y
, которое показывает фактическое положение видео.
Пример 1. Загрузите FLV-файл 80x80 со следующими параметрами:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= 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
См. также
scaleMode | свойство |
scaleMode:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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
См. также
scaleX | свойство |
scaleX:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, являющееся масштабом по горизонтали.
Значение по умолчанию 1
public function set scaleX(value:Number):void
См. также
scaleY | свойство |
scaleY:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, являющееся масштабом по вертикали.
Значение по умолчанию 1
public function set scaleY(value:Number):void
См. также
soundTransform | свойство |
soundTransform:SoundTransform
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Предоставляет прямой доступ к свойству к свойству NetStream.soundTransform
, обеспечивая дополнительные возможности управления звуком. Установите свойство для изменения параметров. Используйте метод accessor получателя для определения текущих параметров.
public function get soundTransform():SoundTransform
public function set soundTransform(value:SoundTransform):void
См. также
source | свойство |
source:String
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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
См. также
state | свойство |
state:String
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Строка, задающая состояние компонента. Данное свойство устанавливается методами load()
, play()
, stop()
, pause()
и seek()
.
Возможные значения для свойства состояния: buffering
, connectionError
, disconnected
, loading
, paused
, playing
, rewinding
, seeking
и stopped
. Для определения этих состояний можно использовать свойства класса FLVPlayback.
public function get state():String
См. также
stateResponsive | свойство |
stateResponsive:Boolean
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Логический параметр, принимающий значение true
, если состояние является управляемым. Если состояние неуправляемое, то вызов методов play()
, load()
, stop()
, pause()
и seek()
будет поставлен в очередь, а выполнение отложено до момента, когда состояние изменится на управляемое. Так как эти вызовы будут поставлены в очередь и их выполнение отложено, то нет необходимости следить за значением свойства stateResponsive
. Управляемые состояния: stopped
, playing
, paused
и buffering
.
public function get stateResponsive():Boolean
См. также
totalTime | свойство |
totalTime:Number
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, определяющее общее время воспроизведения видео (секунды).
При потоковом воспроизведении с Flash Media Server (FMS) и использовании стандартного объекта NCManager
данное значение определяется автоматически интерфейсом программного приложения сервера (APIs), и данное значение отменяет все установленное через данное свойство или полученное с метаданных. Данное свойство готово для чтения, если после установки свойства source
получено состояние stopped
или playing
. Данное свойство неприменимо при потоковом воспроизведении с FMS.
При HTTP-загрузке, если FLV-файл имеет встроенные метаданные, значение определяется автоматически. В противном случае установите его явно, иначе оно будет установлено как NaN. При явной установке значение, полученное из метаданных потока, будет проигнорировано.
После установки данного свойства значение вступит в силу для следующего FLV-файла, загружаемого установкой свойства source
. Оно не влияет на уже загруженный FLV-файл. Также данное свойство не возвращает значение, переданное до загрузки FLV-файла.
Если данное свойство не установить (явно или автоматически), то воспроизведение продолжает работать, но могут возникнуть проблемы с элементами управления переходом.
Если свойство не установлено явно, то свойство будет иметь значение NaN, пока не будет установлено правильное значение из метаданных.
public function get totalTime():Number
См. также
videoHeight | свойство |
videoHeight:int
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.
public function get videoHeight():int
См. также
videoWidth | свойство |
videoWidth:int
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Исходная ширина загруженного FLV-файла. Свойство возвращает значение -1, если еще нет доступной информации.
public function get videoWidth():int
См. также
visible | свойство |
visible:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Если данный логический параметр имеет значение true
, экземпляр VideoPlayer делается видимым. В случае значения false
экземпляр делается невидимым.
Значение по умолчанию true
public function get visible():Boolean
public function set visible(value:Boolean):void
volume | свойство |
volume:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число в диапазоне от 0 до 1, указывающее уровень громкости.
Значение по умолчанию 1
public function get volume():Number
public function set volume(value:Number):void
См. также
width | свойство |
width:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее ширину экземпляра VideoPlayer в рабочей области.
Примечание. Свойство flash.media.Video.width
аналогично свойству fl.video.VideoPlayer.videoWidth
.
public function set width(value:Number):void
См. также
x | свойство |
x:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее положение видеопроигрывателя по горизонтали (в пикселах).
Установка свойства x
также влияет на значение свойства registrationX
. При установке свойства x
или registrationX
} второе свойство меняется, сохраняя свое смещение от первого. Например, если x
= 10 и registrationX
= 20, то при установке значения x
= 110 значение registrationX
устанавливается равным 120.
public function set x(value:Number):void
См. также
y | свойство |
y:Number
[только для записи] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Число, указывающее положение видеопроигрывателя по вертикали (в пикселах).
Установка свойства y
также влияет на значение свойства registrationY
. При установке свойства y
или registrationY
второе свойство меняется, сохраняя свое смещение от первого. Например, если y
= 10 и registrationY
= 20, то при установке значения y
= 110 значение registrationY
устанавливается равным 120.
public function set y(value:Number):void
См. также
VideoPlayer | () | Конструктор |
public function VideoPlayer(width:int = 320, height:int = 240)
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Создает объект VideoPlayer заданной ширины и высоты.
Параметрыwidth:int (default = 320 ) — Ширина видеопроигрывателя в пикселях.
| |
height:int (default = 240 ) — Высота видеопроигрывателя в пикселях.
|
См. также
close | () | метод |
public function close():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Принудительно закрывает видеопоток и подключение к серверу Flash Media Server. Данный метод запускает событие close
. Нет необходимости непосредственно вызывать данный метод, потому что функция таймаута при бездействии проигрывателя позаботится о закрытии потока.
См. также
load | () | метод |
public function load(url:String, totalTime:Number = NaN, isLive:Boolean = false):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Данный метод аналогичен методу play()
, но вызывает загрузку FLV-файла без последующего воспроизведения. Если необходимо, при отображении первого кадра FLV-файла выполняется автоматическое изменение размеров. После начальной загрузки файла и автоматической установки размеров видеопроигрыватель переходит в состояние VideoState.PAUSED
.
Данный метод принимает такие же параметры, как и метод play()
, но при этом нельзя вызывать метод load()
без значения URL-адреса. При попытке вызова без значения URL-адреса возникает ошибка. Если видеопроигрыватель находится в неуправляемом состоянии, то запрос метода load()
будет поставлен в очередь.
Параметры
url:String — URL-адрес для FLV-файла, который необходимо загрузить. Если для URL-адреса не передано значения, то создается ошибка с сообщением "В VideoPlayer.load передан пустой адрес URL" .
| |
totalTime:Number (default = NaN ) — Длина FLV-файла. Передайте значение 0, null или "не определено" для автоматического определения длины файла из метаданных, с сервера или из XML-файла.
| |
isLive:Boolean (default = false ) — Передайте значение true при воспроизведении потока непосредственно с Flash Media Server (FMS).
|
См. также
ncConnected | () | метод |
public function ncConnected():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Вызывается объектом INCManager в случае успешного или неуспешного завершения подключения, после вызова метода INCManager.connectToURL()
. После неуспешного соединения перед вызовом метода установите для свойства INCManager.netConnection
значение null
или "не определено".
См. также
ncReconnected | () | метод |
public function ncReconnected():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Вызывается объектом INCManager после завершения или сбоя повторного подключения, после того как завершен вызов метода INCManager.reconnect()
. Если соединение разорвано, установите для свойства INCManager.netconnection
значение null
перед вызовом метода.
См. также
pause | () | метод |
public function pause():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Приостанавливает воспроизведение видео. Не влияет на остановленное или приостановленное видео. Для продолжения воспроизведения вызовите метод play()
. Не имеет параметров.
Если проигрыватель находится в неуправляемом состоянии, то запрос метода pause()
будет поставлен в очередь.
При вызове метода без подключенного потока создается исключение. Используйте событие stateChange
и значение свойства connected
для определения безопасного момента для вызова метода.
Если проигрыватель находится в остановленном состоянии, то вызов метода pause()
не влияет на проигрыватель, который останется в остановленном состоянии.
См. также
play | () | метод |
public function play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Вызывает воспроизведение видео. Можно вызвать метод, если воспроизведение приостановлено или остановлено, или если видео уже воспроизводится. Вызовите данный метод без параметров для воспроизведения уже загруженного видеофайла или передайте URL-адрес для загрузки нового потока.
Если проигрывательнаходится в неуправляемом состоянии, то запрос будет поставлен в очередь.
Если метод вызывается без аргументов и в данный момент нет подключенного потока, то создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange
и значение свойства connected
.
Параметры
url:String (default = null ) — Передайте URL-адрес, если необходимо загрузить или воспроизвести новый FLV-файл. Если FLV-файл уже загружен, и необходимо продолжить воспроизведение, то передайте значение null .
| |
totalTime:Number (default = NaN ) — Передайте длину FLV-файла. Для автоматического определения длины файла из метаданных, с сервера или из XML-файла передайте значение 0 или NaN . Если при вызове свойства ncConnected свойство INCManager.streamLength не равно 0 , null или не определено, то значение этого свойства имеет приоритет над значением данного параметра.
| |
isLive:Boolean (default = false ) — Передайте значение true , если выполняется потоковое воспроизведение с Flash Media Server (FMS).
|
См. также
playWhenEnoughDownloaded | () | метод |
public function playWhenEnoughDownloaded():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Воспроизведение FLV-файла при загрузке достаточной части файла. Если FLV-файл уже загружен или происходит потоковое воспроизведение с Flash Media Server (FMS), то вызов метода playWhenEnoughDownloaded()
аналогичен вызову метода play()
без параметров. Вызов данного метода не приостанавливает воспроизведение, поэтому во многих случаях перед вызовом этого метода необходимо вызвать метод pause()
.
seek | () | метод |
public function seek(time:Number):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды). Если видео воспроизводится, то воспроизведение продолжится с этой точки. Если видео приостановлено, то видео переместится в эту точку и останется в приостановленном состоянии. Если видео остановлено, то видео переместится в эту точку и перейдет в приостановленное состояние. Неприменимо для потокового воспроизведения.
Свойство playheadTime
может не иметь ожидаемого значения немедленно после вызова одного из методов перехода или установки свойства playheadTime
. При использовании последовательной загрузки можно перейти только в ключевой кадр. Поэтому переход перемещает пользователя в первый ближайший ключевой кадр к указанному времени.
Примечание. При потоковом воспроизведении переход осуществляется точно в указанное время, даже если исходный FLV-файл не имеет ключевых кадров.
Процесс перехода асинхронный, то есть при вызове метода перехода или установке значения для свойства playheadTime
значение свойства playheadTime
обновляется с задержкой. Для получения значения времени после завершения перехода прослушивайте событие seek
, которое не будет послано, пока не обновится свойство playheadTime
.
При вызове метода без подключенного потока создается исключение. Для определения безопасного момента для вызова метода используйте событие stateChange
и значение свойства connected
.
Параметры
time:Number — Число, определяющее время (в секундах), в которое устанавливается точка воспроизведения.
|
VideoError — Если значение времени меньше 0 или равно NaN .
|
См. также
setScale | () | метод |
public function setScale(scaleX:Number, scaleY:Number):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Одновременно задает свойства scaleX
и scaleY
. Установка только свойства scaleX
или scaleY
запускает два события autolayout
, тогда как при вызове метода setScale()
запускается только одно событие autolayout
.
Если свойство scaleMode
имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO
или VideoScaleMode.NO_SCALE
, то вызов данного метода немедленно запускает событие autolayout
.
Параметры
scaleX:Number — Число, представляющее масштаб по горизонтали.
| |
scaleY:Number — Число, представляющее масштаб по вертикали.
|
См. также
setSize | () | метод |
public function setSize(width:Number, height:Number):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Одновременно задает свойства width
и height
. Установка только свойства width
или height
запускает два события autolayout
, тогда как при вызове метода setSize()
запускается только одно событие autolayout
.
Если свойство scaleMode
имеет значение VideoScaleMode.MAINTAIN_ASPECT_RATIO
или VideoScaleMode.NO_SCALE
, то вызов данного метода немедленно запускает событие autolayout
.
Параметры
width:Number — Ширина видеопроигрывателя.
| |
height:Number — Высота видеопроигрывателя.
|
См. также
stop | () | метод |
public function stop():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Останавливает воспроизведение видео. Если для свойства autoRewind
установлено значение true
, производится перемотка видео к первому кадру. Не влияет на проигрыватель, если воспроизведение уже остановлено. Для продолжения воспроизведения вызовите метод play()
. Не имеет параметров.
Если проигрыватель находится в неуправляемом состоянии, запрос будет поставлен в очередь.
При вызове метода без подключенного потока создается исключение. Используйте событие stateChange
и значение свойства connected
для определения безопасного момента для вызова метода.
См. также
autoRewound | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.AUTO_REWOUND
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется когда точка воспроизведения переходит в начало видеопроигрывателя, потому что для свойства autoRewind
установлено значение true
.
Событие autoRewound
относится к типу VideoEvent и имеет константу VideoEvent.AUTO_REWOUND
.
type
для объекта события autoRewound
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
См. также
close | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.CLOSE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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. |
См. также
complete | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.COMPLETE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, когда воспроизведение завершается по достижении конца FLV-файла. Компонент не отправляет событие, если вызван метод stop()
или pause()
или выбран соответствующий элемент управления.
Если приложение использует последовательную загрузку, то свойство totalTime
не устанавливается явным образом. При этом загружается FLV-файл, в метаданных которого не указана длительность. Перед отправкой данного события видеопроигрыватель устанавливает свойство totalTime
равным приблизительному общему значению.
Видеопроигрыватель также отправляет события stateChange
и stopped
.
Событие complete
относится к типу VideoEvent и имеет константу VideoEvent.COMPLETE
.
type
для объекта события complete
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
См. также
cuePoint | Событие |
fl.video.MetadataEvent
fl.video.MetadataEvent.CUE_POINT
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется по достижении ключевой точки. Объект события имеет свойство info
, содержащее информацию об объекте, полученную отзывом события NetStream.onCuePoint
для ключевых точек FLV-файла. Для ключевых точек ActionScript он содержит объект, переданный в методы ключевых точек ActionScript или свойства.
Событие cuePoint
относится к типу MetadataEvent и имеет константу MetadataEvent.CUE_POINT
.
type
для объекта события cuePoint
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
сведения | Объект со свойствами, описывающими ключевую точку. |
vp | Индекс объекта VideoPlayer. |
См. также
layout | Событие |
fl.video.LayoutEvent
fl.video.LayoutEvent.LAYOUT
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.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 . |
См. также
metadataReceived | Событие |
fl.video.MetadataEvent
fl.video.MetadataEvent.METADATA_RECEIVED
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Первый раз отправляется при достижении метаданных FLV-файла. Объект события имеет свойство info
, содержащее информацию об объекте, полученную обратным вызовом события NetStream.onMetaData
.
Событие metadataReceived
относится к типу VideoEvent и имеет константу MetadataEvent.METADATA_RECEIVED
.
type
для объекта события metadataReceived
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
сведения | Объект со свойствами, описывающими FLV-файл. |
vp | Индекс объекта VideoPlayer. |
См. также
playheadUpdate | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.PLAYHEAD_UPDATE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется при воспроизведении FLV-файла, с частотой, указанной в свойстве playheadUpdateInterval
, или при начале процесса перемотки. Данный компонент не отправляет это событие, когда видеопроигрыватель находится в приостановленном состоянии или остановлен, если только не производится поиск.
Событие playheadUpdate
относится к типу VideoEvent и имеет константу VideoEvent.PLAYHEAD_UPDATE
.
type
для объекта события playheadUpdate
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
См. также
progress | Событие |
fl.video.VideoProgressEvent
fl.video.VideoProgressEvent.PROGRESS
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Показывает ход загрузки, отображая число загруженных байт. Отправляется с частотой, определяемой свойством progressInterval
, начинается одновременно с загрузкой и заканчивается, когда все байты загружены или произошла сетевая ошибка. По умолчанию событие отправляется каждые 0,25 секунды при вызове загрузки и заканчивается после загрузки всех байтов или появления сетевой ошибки. Используйте данное событие для проверки загруженных байтов или количества байтов в буфере.
Отправляется только при последовательной загрузке HTTP. Показывает ход загрузки количеством загруженных байтов. Объект события имеет свойства bytesLoaded
и bytesTotal
, сходные со свойствами объекта FLVPlayback с такими же именами.
Событие progress
относится к типу VideoProgressEvent и имеет константу VideoProgressEvent.PROGRESS
.
type
для объекта события progress
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
bytesLoaded | Число элементов или байт, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байт, которые будут получены в случае успешного завершения загрузки. |
vp | Индекс объекта VideoPlayer. |
См. также
ready | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.READY
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Событие, отправляемое, когда FLV-файл загружен и готов к отображению. Событие начинается первый раз при переходе видеопроигрывателя в управляемое состояние после загрузки нового FLV-файла методом play()
или load()
. Событие начинается один раз при каждой загрузки FLV-файла.
Событие ready
относится к типу VideoEvent и имеет константу VideoEvent.READY
.
type
для объекта события ready
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
См. также
stateChange | Событие |
fl.video.VideoEvent
fl.video.VideoEvent.STATE_CHANGE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется при изменении состояния воспроизведения. После завершения вызова autoRewind
отправляется событие stateChange
с состоянием перемотки видео. Событие stateChange
не отправляется, пока не будет завершена перемотка видео.
Событие может использоваться для определения перехода в состояние воспроизведения или выхода из неуправляемых состояний, таких как середина процесса подключения, изменение размеров или процесс перемотки. Методы play()
, pause()
, stop()
и seek()
образуют очередь запросов на выполнение при переходе проигрывателя в управляемое состояние.
Событие stateChange
относится к типу VideoEvent и имеет константу VideoEvent.STATE_CHANGE
.
type
для объекта события stateChange
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
state | Строка, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента. |
playheadTime | Число, показывающее текущую точку воспроизведения или положение. |
vp | Индекс объекта VideoPlayer. |
См. также
SHORT_VERSION | Константа |
public static const SHORT_VERSION:String = "2.1"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Переменная состояния, указывающая сокращенный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:
FLVPlayback.SHORT_VERSION
Переменная SHORT_VERSION
включает только старший и младший номер версии, например 2.0. Переменная VERSION
включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11.
См. также
VERSION | Константа |
public static const VERSION:String = "2.1.0.14"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Переменная состояния, указывающая полный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:
FLVPlayback.VERSION
Переменная VERSION
включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11. Переменная SHORT_VERSION
включает только старший и младший номер версии, например 2.0.
См. также
Чтобы применить этот пример на практике, выполните следующие действия.
testVideoPath
абсолютный или относительный путь к FLV-файлу.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); } } }