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

SerialElement  - AS3 OSMF

Пакетorg.osmf.elements
Классpublic class SerialElement
НаследованиеSerialElement Inheritance CompositeElement Inheritance MediaElement Inheritance EventDispatcher Inheritance Object

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

SerialElement - это компоновка мультимедийного содержимого, элементы которой представлены последовательно (то есть друг за другом).

Элементы мультимедийного содержимого, которые составляют SerialElement, рассматриваются как единый унифицированный элемент мультимедийного содержимого. Например, если SerialElement инкапсулирует последовательность видеороликов, то SerialElement будет действовать аналогично одному VideoElement, который воспроизводит несколько видеороликов последовательно.

Как правило, характеристика SerialElement - это отражение "текущего" нижестоящего элемента компоновки. SerialElement воспроизводит свои нижестоящие элементы в последовательном порядке. После того как завершается выполнение текущего нижестоящего элемента, следующий нижестоящий элемент в последовательности становится текущим нижестоящим элементом. Переход от одного текущего нижестоящего элемента к следующему нижестоящему элементу скрыт от клиента класса. Они проявляются только при изменении характеристик этого класса.

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

Единственным способом, при котором возможна передача "текущего" состояния от одного нижестоящего элемента к другому, является то, что состояние одной из характеристик текущего нижестоящего элемента изменяется, чтобы SerialElement стало известно о необходимости изменения своего текущего нижестоящего элемента. Например, если каждый нижестоящий элемент в последовательности имеет PlayTrait, то "текущее" состояние переходит от одного нижестоящего элемента к другому, когда нижестоящий элемент завершает воспроизведение и свойство PlayState его PlayTrait изменяется с PLAYING на STOPPED. Другой пример: если клиент SerialElement с SeekTrait выполняет поиск между двумя точками, то текущее состояние может перейти от одного нижестоящего элемента к другому.

Отображение каждой характеристики при последовательном расположении:

  • AudioTrait - это комбинированная характеристика, которая сохраняет свойства прослушивания всех нижестоящих элементов в синхронизации. При изменении громкости нижестоящего элемента (или составного элемента) одновременно изменяется громкость всех нижестоящих элементов (и составной характеристики), которые могут быть слышимыми.
  • BufferTrait - это комбинированная характеристика, которая представляет характеристику буферизации текущего нижестоящего элемента в последовательности. Все изменения применяются только к текущему нижестоящему элементу.
  • DisplayObjectTrait - это комбинированная характеристика, которая представляет DisplayObjectTrait текущего нижестоящего элемента в последовательности.
  • DRMTrait - это комбинированная характеристика, которая представляет DRMTrait текущего нижестоящего элемента в последовательности.
  • DVRTrait - это комбинированная характеристика, которая представляет DVRTrait текущего нижестоящего элемента в последовательности.
  • DynamicStreamTrait - это комбинированная характеристика, которая представляет DynamicStreamTrait текущего нижестоящего элемента в последовательности. Все изменения применяются только к текущему нижестоящему элементу.
  • LoadTrait - это комбинированная характеристика, которая представляет LoadTrait текущего нижестоящего элемента в последовательности. Все изменения применяются только к текущему нижестоящему элементу.
  • PlayTrait - это комбинированная характеристика, которая представляет PlayTrait текущего нижестоящего элемента в последовательности. Все изменения применяются только к текущему нижестоящему элементу.
  • SeekTrait - это комбинированная характеристика, которая представляет SeekTrait текущего нижестоящего элемента в последовательности. Операция поиска может изменить текущий нижестоящий элемент.
  • TimeTrait: переданная продолжительность TimeTrait объекта SerialElement равна сумме только текущего дочернего элемента и всех завершенных дочерних элементов. Переданное значение не отражает общую продолжительность для всех дочерних элементов.

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheritedcontainer : IMediaContainer
[только для чтения] Контейнер мультимедийного содержимого, который использует этот элемент.
MediaElement
  currentChild : MediaElement
[только для чтения] Нижестоящий элемент этого SerialElement, активный в настоящее время.
SerialElement
 InheritedmetadataNamespaceURLs : Vector.<String>
[только для чтения] Вектор, содержащий URL-адреса пространств имен для всех объектов Metadata, которые хранятся в этом MediaElement.
MediaElement
 InheritednumChildren : int
[только для чтения] Количество MediaElements нижестоящего элемента в этой компоновке мультимедийного содержимого.
CompositeElement
 Inheritedresource : MediaResourceBase
Ресурс мультимедийного содержимого, в котором действует этот элемент.
MediaElement
 InheritedtraitTypes : Vector.<String>
[только для чтения] Вектор значений MediaTraitType, представляющих типы характеристик этого элемента мультимедийного содержимого.
MediaElement
Общедоступные методы
 МетодОпределено
  
Конструктор.
SerialElement
 Inherited
Добавляет указанный нижестоящий элемент в конец списка.
CompositeElement
 Inherited
Добавляет нижестоящий элемент в список с заданной позицией индекса.
CompositeElement
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
addMetadata(namespaceURL:String, metadata:Metadata):void
Добавляет объект Metadata к этому MediaElement в указанном URL-адресе пространства имен.
MediaElement
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Получает нижестоящий элемент с заданной позицией индекса.
CompositeElement
 Inherited
Возвращает индекс нижестоящего элемента, если он находится в списке, где, например, getChildAt(index) = нижестоящий элемент.
CompositeElement
 Inherited
Возвращает объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.
MediaElement
 Inherited
Возвращает характеристику мультимедийного содержимого указанного типа.
MediaElement
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Определяет, имеет ли этот мультимедийный элемент характеристику мультимедийного содержимого указанного типа.
MediaElement
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет указанный нижестоящий элемент и возвращает его.
CompositeElement
 Inherited
Удаляет нижестоящий элемент в указанной позиции индекса и возвращает его.
CompositeElement
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Удаляет объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.
MediaElement
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Добавляет новую характеристику мультимедийного содержимого к этому мультимедийному элементу.
MediaElement
 Inherited
Удаляет характеристику мультимедийного содержимого из этого мультимедийного элемента.
MediaElement
 Inherited
Устанавливает характеристики для этого элемента мультимедийного содержимого.
MediaElement
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется после изменения свойства контейнера элемента.MediaElement
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
 InheritedОтправляется при возникновении ошибки, влияющей на функционирование элемента мультимедийного содержимого.MediaElement
 InheritedОтправляется, когда доступна информация, влияющая на операцию элемента мультимедиа.MediaElement
 InheritedОтправляется при добавлении объекта Metadata к этому элементу мультимедийного содержимого.MediaElement
 InheritedОтправляется при удалении объекта Metadata из этого элемента мультимедийного содержимого.MediaElement
 InheritedОтправляется при добавлении характеристики к этому элементу мультимедийного содержимого.MediaElement
 InheritedОтправляется при удалении характеристики из этого элемента мультимедийного содержимого.MediaElement
Сведения о свойстве

currentChild

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

Нижестоящий элемент этого SerialElement, активный в настоящее время.



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

SerialElement

()Конструктор
public function SerialElement()

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

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

SerialElementExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.LightweightVideoElement;
    import org.osmf.elements.SerialElement;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class SerialElementExample extends Sprite
    {
        public function SerialElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var serialElement:SerialElement = new SerialElement();
            
            var videoElement:LightweightVideoElement = new LightweightVideoElement();
            videoElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/AFaerysTale_sylviaApostol_640_500_short.flv");
            
            var videoElement2:LightweightVideoElement = new LightweightVideoElement();
            videoElement2.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/elephants_dream_768x428_24_short.flv");
            
            serialElement.addChild(videoElement);
            serialElement.addChild(videoElement2);
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = serialElement;    
            
        }
    }
}




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

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