Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
org.osmf.metadata 

TimelineMetadata  - AS3 OSMF

Пакетorg.osmf.metadata
Классpublic class TimelineMetadata
НаследованиеTimelineMetadata Inheritance Metadata Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Класс TimelineMetadata инкапсулирует метаданные, связанные с временной шкалой элемента MediaElement.

TimelineMetadata использует класс TimelineMarker для представления ключей и значений (то есть TimelineMarker будет храниться и как ключ, и как значение). Объект TimelineMetadata отправляет событие TimelineMetadataEvent, когда свойство currentTime объекта TimeTrait элемента MediaElement совпадает с любым из временных значений в коллекции объектов TimelineMarker.

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheritedkeys : Vector.<String>
[только для чтения] Ключи хранятся в этом объекте Metadata.
Metadata
  numMarkers : int
[только для чтения] Количество объектов TimelineMarker, содержащихся в этом объекте.
TimelineMetadata
Общедоступные методы
 МетодОпределено
  
Конструктор.
TimelineMetadata
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
Добавляет указанный TimelineMarker к этому объекту.
TimelineMetadata
 Inherited
Хранит указанное значение в этом объекте Metadata с использованием определенного ключа.
Metadata
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
Возвращает TimelineMarker в указанной позиции индекса.
TimelineMetadata
 Inherited
Возвращает значение, связанное с указанным ключом.
Metadata
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Удаляет указанный TimelineMarker из этого объекта.
TimelineMetadata
 Inherited
Удаляет значение, связанное с указанным ключом из этого объекта Metadata.
Metadata
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  Отправляется при добавлении TimelineMarker к этому объекту.TimelineMetadata
  Отправляется, когда свойство currentTime элемента MediaElement, связанного с этим TimelineMetadata, достигает смещение продолжительности одного из TimelineMarker в этом TimelineMetadata.TimelineMetadata
  Отправляется при удалении TimelineMarker из этого объекта.TimelineMetadata
  Отправляется, когда свойство currentTime элемента MediaElement, связанного с этим TimelineMetadata, достигает значение времени одного из TimelineMarker в этом TimelineMetadata.TimelineMetadata
 InheritedОтправляется при добавлении нового значения к объекту Metadata.Metadata
 InheritedОтправляется при изменении значения в объекте Metadata.Metadata
 InheritedОтправляется при удалении значения из объекта Metadata.Metadata
Сведения о свойстве

numMarkers

свойство
numMarkers:int  [только для чтения]

Количество объектов TimelineMarker, содержащихся в этом объекте.



Реализация
    public function get numMarkers():int
Сведения о конструкторе

TimelineMetadata

()Конструктор
public function TimelineMetadata(media:MediaElement)

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Конструктор.

Параметры
media:MediaElement — Элемент мультимедийного содержимого, к которому применяются метаданные временной шкалы.

Выдает
ArgumentError — Если аргумент мультимедийного содержимого имеет значение null.
Сведения о методе

addMarker

()метод
public function addMarker(marker:org.osmf.metadata:TimelineMarker):void

Добавляет указанный TimelineMarker к этому объекту. Этот класс обслуживает объекты TimelineMarker в порядке времени. Если в пределах этого объекта существует другой TimelineMarker с аналогичным значением времени, то существующее значение будет перезаписано.

Параметры

marker:org.osmf.metadata:TimelineMarker — Добавляемый маркер.


Выдает
ArgumentError — Если маркер - null или указывает недопустимое время.

getMarkerAt

()метод 
public function getMarkerAt(index:int):org.osmf.metadata:TimelineMarker

Возвращает TimelineMarker в указанной позиции индекса. Обратите внимание, что маркеры отсортированы по времени.

Параметры

index:int — Индекс возвращаемого маркера.

Возвращает
org.osmf.metadata:TimelineMarker

removeMarker

()метод 
public function removeMarker(marker:org.osmf.metadata:TimelineMarker):org.osmf.metadata:TimelineMarker

Удаляет указанный TimelineMarker из этого объекта.

Параметры

marker:org.osmf.metadata:TimelineMarker — Удаляемый маркер.

Возвращает
org.osmf.metadata:TimelineMarker

Выдает
ArgumentError — Если маркер - null.
Сведения о событии

markerAdd

Событие
Тип объекта события: org.osmf.events.TimelineMetadataEvent
свойство TimelineMetadataEvent.type = org.osmf.events.TimelineMetadataEvent.MARKER_ADD

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Отправляется при добавлении TimelineMarker к этому объекту.

Константа TimelineMetadataEvent.MARKER_ADD определяет значение свойства type объекта события markerAdd.

markerDurationReached

Событие  
Тип объекта события: org.osmf.events.TimelineMetadataEvent
свойство TimelineMetadataEvent.type = org.osmf.events.TimelineMetadataEvent.MARKER_TIME_REACHED

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Отправляется, когда свойство currentTime элемента MediaElement, связанного с этим TimelineMetadata, достигает смещение продолжительности одного из TimelineMarker в этом TimelineMetadata.

Константа TimelineMetadataEvent.MARKER_TIME_REACHED определяет значение свойства type объекта события markerTimeReached.

markerRemove

Событие  
Тип объекта события: org.osmf.events.TimelineMetadataEvent
свойство TimelineMetadataEvent.type = org.osmf.events.TimelineMetadataEvent.MARKER_REMOVE

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Отправляется при удалении TimelineMarker из этого объекта.

Константа TimelineMetadataEvent.MARKER_REMOVE определяет значение свойства type объекта события markerRemove.

markerTimeReached

Событие  
Тип объекта события: org.osmf.events.TimelineMetadataEvent
свойство TimelineMetadataEvent.type = org.osmf.events.TimelineMetadataEvent.MARKER_TIME_REACHED

Язык версии: ActionScript 3.0
Версия продукта: OSMF 1.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Отправляется, когда свойство currentTime элемента MediaElement, связанного с этим TimelineMetadata, достигает значение времени одного из TimelineMarker в этом TimelineMetadata.

Константа TimelineMetadataEvent.MARKER_TIME_REACHED определяет значение свойства type объекта события markerTimeReached.
TimelineMetadataExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.VideoElement;
    import org.osmf.events.MediaElementEvent;
    import org.osmf.events.TimelineMetadataEvent;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    import org.osmf.metadata.CuePoint;
    import org.osmf.metadata.TimelineMetadata;
    
    public class TimelineMetadataExample extends Sprite
    {
        public function TimelineMetadataExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var urlResource:URLResource = new URLResource("rtmp://cp67126.edgefcs.net/ondemand/mp4:mediapm/osmf/content/test/cuepoints/spacealonehd_sounas_640_with_nav.f4v");
            videoElement= new VideoElement();
            videoElement.resource = urlResource;
            videoElement.addEventListener(MediaElementEvent.METADATA_ADD, onMetadataAdd);

            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = videoElement;    
        }

        private function onMetadataAdd(event:MediaElementEvent):void
        {
            if (event.namespaceURL == CuePoint.DYNAMIC_CUEPOINTS_NAMESPACE)
            {
                var timelineMetadata:TimelineMetadata = videoElement.getMetadata(CuePoint.DYNAMIC_CUEPOINTS_NAMESPACE) as TimelineMetadata;
                timelineMetadata.addEventListener(TimelineMetadataEvent.MARKER_TIME_REACHED, onCuePoint);
            }
        }

        private function onCuePoint(event:TimelineMetadataEvent):void
        {
            var cuePoint:CuePoint = event.marker as CuePoint;
            trace("Cue Point at " + cuePoint.time);
        }

        private var videoElement:VideoElement;
    }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.