Пакетfl.video
Классpublic class VideoPlayer
НаследованиеVideoPlayer Inheritance Video Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Класс VideoPlayer позволяет создать видеопроигрыватель с объемом SWF-файла несколько меньшим, чем при использовании компонента FLVPlayback. В отличие от компонента FLVPlayback, класс VideoPlayer не позволяет добавлять обложки или элементы управления воспроизведением, и хотя нельзя искать ключевые точки или переходить к ним, события 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 для обработки нескольких потоков для нескольких полос пропускания.

Посмотреть примеры

См. также

NCManager
FLVPlayback


Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
  align : String
Задает способ отображения видео относительно свойств registrationX, registrationY, registrationWidth и registrationHeight.
VideoPlayer
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
  autoRewind : Boolean
Логический параметр, вызывающий (в случае значения true) перемотку FLV-файла к кадру 1 после остановки воспроизведения по причине достижения конца потока или вызова метода stop().
VideoPlayer
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
  bufferTime : Number
Число, указывающее количество секунд для буферизации в памяти перед началом воспроизведения видеопотока.
VideoPlayer
  bytesLoaded : uint
[только для чтения] Число, указывающее объем загружаемых данных по HTTP (в байтах).
VideoPlayer
  bytesTotal : uint
[только для чтения] Число, указывающее общее количество загруженных байт по HTTP.
VideoPlayer
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheriteddeblocking : int
Указывает тип фильтра, применяемого к дешифрованному видео в ходе последующей обработки.
Video
 Inheritedfilters : 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
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
  metadata : Object
[только для чтения] Объект, представляющий собой пакет метаданных, полученный в результате вызова метода обратного вызова NetSteam.onMetaData(), если такой объект доступен.
VideoPlayer
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
  ncMgr : INCManager
[только для чтения] Объект INCManager, предоставляющий доступ к экземпляру класса, реализующего интерфейс INCManager к классу NCManager.
VideoPlayer
  netConnection : NetConnection
[только для чтения] Разрешает прямой доступ к экземпляру подключения NetConnection, созданному видеопроигрывателем.
VideoPlayer
  netStream : NetStream
[только для чтения] Разрешает прямой доступ к экземпляру NetStream, созданному видеопроигрывателем.
VideoPlayer
  netStreamClientClass : Object
[статические] Регистрирует пользовательский класс клиентского свойства NetStream.
VideoPlayer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
  playheadTime : Number
Число, обозначающее текущее время воспроизведения или положение, которое может быть дробным (в секундах).
VideoPlayer
  playheadUpdateInterval : Number
Число, представляющее промежуток времени (в миллисекундах) между событиями playheadUpdate.
VideoPlayer
  progressInterval : Number
Число, представляющее промежуток времени (в миллисекундах) между событиями progress.
VideoPlayer
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  registrationHeight : Number
Высота, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров.
VideoPlayer
  registrationWidth : Number
Ширина, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров.
VideoPlayer
  registrationX : Number
Координата по горизонтали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров.
VideoPlayer
  registrationY : Number
Координата по вертикали, используемая для выравнивания видеосодержимого в ходе автоматического изменения размеров.
VideoPlayer
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
  scaleMode : String
Указывает способ изменения размеров видео после загрузки.
VideoPlayer
  scaleX : Number
[только для записи] Число, являющееся масштабом по горизонтали.
VideoPlayer
  scaleY : Number
[только для записи] Число, являющееся масштабом по вертикали.
VideoPlayer
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 Inheritedsmoothing : Boolean
Определяет, должно ли выполняться смягчение (интерполяция) видео при масштабировании.
Video
  soundTransform : SoundTransform
Предоставляет непосредственный доступ к свойству NetStream.soundTransform, обеспечивая дополнительный возможности управления звуком.
VideoPlayer
  source : String
[только для чтения] Строка, задающая URL-адрес FLV-файла и метод его потокового воспроизведения.
VideoPlayer
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
  state : String
[только для чтения] Строка, задающая состояние компонента.
VideoPlayer
  stateResponsive : Boolean
[только для чтения] Логический параметр, принимающий значение true, если состояние разрешает работу элементов управления.
VideoPlayer
  totalTime : Number
[только для чтения] Число, определяющее общее время воспроизведения видео (секунды).
VideoPlayer
 Inheritedtransform : 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
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
VideoPlayer(width:int = 320, height:int = 240)
Создает объект VideoPlayer заданной ширины и высоты.
VideoPlayer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
 Inherited
Задает видеопоток с камеры для отображения в пределах объекта Video в окне приложения.
Video
 Inherited
Задает видеопоток для отображения в пределах объекта Video в окне приложения.
Video
 Inherited
Удаляет отображаемое в данный момент изображение в объекте Video (а не видеопоток).
Video
  
Принудительно закрывает видеопоток и подключение к серверу Flash Media Server.
VideoPlayer
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
DisplayObject
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
load(url:String, totalTime:Number = NaN, isLive:Boolean = false):void
Аналогичен методу play(), но взывает загрузку FLV-файла без воспроизведения.
VideoPlayer
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
  
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения подключения после вызова метода INCManager.connectToURL().
VideoPlayer
  
Вызывается интерфейсом INCManager в случае успешного или неуспешного завершения переподключения после вызова метода INCManager.reconnect().
VideoPlayer
 Inherited
DisplayObject
 Inherited
DisplayObject
  
Приостанавливает воспроизведение видео.
VideoPlayer
  
play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false):void
Вызывает воспроизведение видео.
VideoPlayer
  
Воспроизведение FLV-файла при загрузке достаточной части файла.
VideoPlayer
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Переходит в файле в положение, заданное временем в секундах с точностью в три десятичных разряда (до миллисекунды).
VideoPlayer
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setScale(scaleX:Number, scaleY:Number):void
Одновременно задает свойства масштаба по горизонтали и вертикали.
VideoPlayer
  
setSize(width:Number, height:Number):void
Одновременно задает свойства ширины и высоты.
VideoPlayer
  
Останавливает воспроизведение видео.
VideoPlayer
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
  Отправляется при перемещении точки воспроизведения в начальное положение видеопроигрывателя, поскольку свойство autoRewind имеет значение true.VideoPlayer
  Отправляется экземпляром VideoPlayer, когда подключение NetConnection закрывается по истечении времени ожидания или вызовом метода close(), а также при вызове методов load() или play(), либо установке свойства source, в результате чего закрывается подключение RTMP.VideoPlayer
  Отправляется, когда воспроизведение завершается по достижении конца FLV-файла.VideoPlayer
  Отправляется по достижении ключевой точки.VideoPlayer
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
  Отправляется при изменении размера или макета видеопроигрывателя.VideoPlayer
  Первый раз отправляется при достижении метаданных FLV-файла.VideoPlayer
  Отправляется, когда FLV-файл воспроизводится с частотой, указанной в свойстве playheadUpdateInterval, а также при начале перемотки.VideoPlayer
  Показывает ход загрузки, отображая число загруженных байт.VideoPlayer
  Событие, отправляемое, когда FLV-файл загружен и готов к отображению.VideoPlayer
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.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-файл не имеет ключевых точек. Каждый объект имеет следующие свойства:
  • type — строка, определяющая тип ключевой точки: navigation или event.
  • name — строка, являющаяся именем ключевой точки.
  • time — число, являющееся временем ключевой точки в секундах с точностью до третьего десятичного знака (миллисекунды).
  • parameters — необязательный параметр, имеющий пары "имя-значение", назначаемые пользователем при создании ключевых точек.
audiocodecidЧисло, указывающее на используемый аудиокодек (способ кодирования/декодирования.)
audiodelay Число, представляющее момент времени 0 в исходном файле, с которого декодирован FLV-файл.

Видео задерживается на короткий период времени, необходимый для синхронизации звука. Например, если значение audiodelay равно 0,038, то видео, начинающееся в исходном файле с момента времени 0, начнется в FLV-файле с момента времени 0,038.

Обратите внимание, что классы 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 со следующими параметрами:

После автоматического изменения размеров будут получены следующее значения:

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

Будут получены следующие значения:

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

Будут получены все значения, аналогичные зарегистрированным значениям:

Установка свойства 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 со следующими параметрами:

После автоматического изменения размеров будут получены следующее значения:

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

Будут получены следующие значения:

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

Будут получены все значения, аналогичные зарегистрированным значениям:

Установка свойства 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 со следующими параметрами:

После автоматического изменения размеров будут получены следующее значения:

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

Будут получены следующие значения:

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

Будут получены все значения, аналогичные зарегистрированным значениям:

При установке свойства 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 со следующими параметрами:

После автоматического изменения размеров будут получены следующее значения:

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

Будут получены следующие значения:

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

Будут получены все значения, аналогичные зарегистрированным значениям:

При установке свойства 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
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
stateСтрока, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента.
playheadTimeЧисло, показывающее текущую точку воспроизведения или положение.
vpИндекс объекта VideoPlayer.

См. также

close Событие  
Тип объекта события: fl.video.VideoEvent
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
stateСтрока, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента.
playheadTimeЧисло, показывающее текущую точку воспроизведения или положение.
vpИндекс объекта VideoPlayer.

См. также

complete Событие  
Тип объекта события: fl.video.VideoEvent
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
stateСтрока, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента.
playheadTimeЧисло, показывающее текущую точку воспроизведения или положение.
vpИндекс объекта VideoPlayer.

См. также

cuePoint Событие  
Тип объекта события: fl.video.MetadataEvent
свойство MetadataEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
сведенияОбъект со свойствами, описывающими ключевую точку.
vpИндекс объекта VideoPlayer.

См. также

layout Событие  
Тип объекта события: fl.video.LayoutEvent
свойство LayoutEvent.type = fl.video.LayoutEvent.LAYOUT

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

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

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

Задает значение свойства type для объекта события Layout.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
oldBoundsУказывает значения свойств x, y, width и height целевого объекта перед отправкой события layout.
oldRegistrationBoundsУказывает значения свойств registrationX , registrationY, registrationWidth и registrationHeight целевого объекта перед отправкой события layout.

См. также

metadataReceived Событие  
Тип объекта события: fl.video.MetadataEvent
свойство MetadataEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
сведенияОбъект со свойствами, описывающими FLV-файл.
vpИндекс объекта VideoPlayer.

См. также

playheadUpdate Событие  
Тип объекта события: fl.video.VideoEvent
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
stateСтрока, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента.
playheadTimeЧисло, показывающее текущую точку воспроизведения или положение.
vpИндекс объекта VideoPlayer.

См. также

progress Событие  
Тип объекта события: fl.video.VideoProgressEvent
свойство VideoProgressEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
bytesLoadedЧисло элементов или байт, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые будут получены в случае успешного завершения загрузки.
vpИндекс объекта VideoPlayer.

См. также

ready Событие  
Тип объекта события: fl.video.VideoEvent
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
stateСтрока, идентифицирующая константу из класса VideoState, которая описывает состояние воспроизведения компонента.
playheadTimeЧисло, показывающее текущую точку воспроизведения или положение.
vpИндекс объекта VideoPlayer.

См. также

stateChange Событие  
Тип объекта события: fl.video.VideoEvent
свойство VideoEvent.type = 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.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
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.

См. также

Примеры Как пользоваться примерами
VideoPlayerExample.as

В данном примере динамически создаются два экземпляра VideoPlayer, и к одному экземпляру применяется размывающий фильтр.

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

  1. Добавьте в библиотеку компонент FLVPlayback.
  2. Введите вместо testVideoPath абсолютный или относительный путь к FLV-файлу.
  3. Сохраните этот код под именем VideoPlayerExample.as в том же каталоге, что и FLA-файл.
  4. Присвойте классу Document в FLA-файле значение VideoPlayerExample.
package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

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