Paket | org.osmf.elements |
Klasse | public class SerialElement |
Vererbung | SerialElement CompositeElement MediaElement EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Medienelemente eines SerialElement werden als ein einziges, einheitliches Medienelement behandelt. Beispiel: Wenn ein SerialElement eine Sequenz von Videos kapselt, verhält sich das SerialElement so, als ob ein einziges VideoElement vorläge. Dieses spielt jedoch mehrere Videos hintereinander ab.
In der Regel spiegelt ein Merkmal eines SerialElement das „aktuelle“ untergeordnete Element der Zusammenstellung wider. Ein SerialElement spielt seine untergeordneten Elemente nacheinander ab. Wenn die Ausführung des aktuellen untergeordneten Elements abgeschlossen ist, wird das nächste untergeordnete Element zum „aktuellen“ Element. Für den Client der Klasse bleibt der Wechsel von einem aktuellen untergeordneten Element zum nächsten verborgen. Die Wechsel sind nur durch Änderungen der Merkmale dieser Klasse bemerkbar.
Ein SerialElement ohne untergeordnete Elemente verfügt nicht über ein „aktuelles“ untergeordnetes Element und spiegelt daher keine Merkmale wider. Das erste einem SerialElement hinzugefügte untergeordnete Element wird sofort zum aktuellen untergeordneten Element der Zusammenstellung. Wenn das aktuelle untergeordnete Element entfernt wird, wird das nächste untergeordnete Element in der Sequenz zum „aktuellen“ Element, sofern ein nächstes untergeordnetes Element vorhanden ist. Ist kein nächstes untergeordnetes Element vorhanden, wird das erste untergeordnete Element zum „aktuellen“ Element.
Der Status „aktuell“ kann nur von einem untergeordneten Element auf das nächste übergehen, wenn der Status eines Merkmals des aktuellen untergeordneten Elements so geändert wird, dass das SerialElement weiß, dass es sein aktuelles untergeordnetes Element ändern muss. Beispiel: Alle untergeordneten Elemente einer Sequenz haben das Merkmal „PlayTrait“. In diesem Fall geht der Status „aktuell“ von einem untergeordneten Element auf das nächste über, wenn ein untergeordnetes Element fertig abgespielt wurde und die PlayState
-Eigenschaft seines PlayTrait vonPLAYING
in STOPPED
geändert wurde. Ein weiteres Beispiel: Der Client eines SerialElement mit dem Merkmal „SeekTrait“ führt einen Suchlauf von einem Punkt zu einem anderen durch. In diesem Fall ändert sich der Status „aktuell“ wahrscheinlich von einem untergeordneten Element zu einem anderen.
Im Folgenden wird erläutert, wie jedes Merkmal im Serienbetrieb ausgedrückt wird:
- AudioTrait - Das Compositemerkmal hält die hörbaren Eigenschaften aller untergeordneten Elemente synchronisiert. Wenn die Lautstärke eines untergeordneten Elements (oder des Compositeelements) geändert wird, wird die Lautstärke für alle hörbaren untergeordneten Elemente (und das Compositemerkmal) entsprechend geändert.
- BufferTrait – Das Compositemerkmal stellt das pufferfähige Merkmal des aktuellen untergeordneten Elements in der Sequenz dar. Änderungen gelten nur für das aktuelle untergeordnete Element.
- DisplayObjectTrait - Das Compositemerkmal stellt das DisplayObjectTrait des aktuellen untergeordneten Elements in der Sequenz dar.
- DRMTrait - Das Compositemerkmal stellt das DRMTrait des aktuellen untergeordneten Elements in der Sequenz dar.
- DRMTrait - Das Compositemerkmal stellt das DRMTrait des aktuellen untergeordneten Elements in der Sequenz dar.
- DynamicStreamTrait - Das Compositemerkmal stellt das DynamicStreamTrait des aktuellen untergeordneten Elements in der Sequenz dar. Änderungen gelten nur für das aktuelle untergeordnete Element.
- LoadTrait - Das Compositemerkmal stellt das LoadTrait des aktuellen untergeordneten Elements in der Sequenz dar. Änderungen gelten nur für das aktuelle untergeordnete Element.
- PlayTrait - Das Compositemerkmal stellt das PlayTrait des aktuellen untergeordneten Elements in der Sequenz dar. Änderungen gelten nur für das aktuelle untergeordnete Element.
- SeekTrait - Das Compositemerkmal stellt das SeekTrait des aktuellen untergeordneten Elements in der Sequenz dar. Ein Suchvorgang kann zu einer Änderung des aktuellen Elements führen.
- TimeTrait - Die gemeldete Dauer des TimeTrait eines SerialElement ist die Summe der aktuellen untergeordneten Elemente und aller abgeschlossenen untergeordneten Elemente. Der gemeldete Wert entspricht nicht der Summe der Dauer aller untergeordneten Elemente.
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
container : IMediaContainer [schreibgeschützt]
Der von diesem Element verwendete Mediencontainer. | MediaElement | ||
currentChild : MediaElement [schreibgeschützt]
Das derzeit aktive untergeordnete Element dieses SerialElement. | SerialElement | ||
metadataNamespaceURLs : Vector.<String> [schreibgeschützt]
Ein Vektor, der die Namespace-URLs für alle in diesem Medienelement gespeicherten Metadatenobjekte enthält. | MediaElement | ||
numChildren : int [schreibgeschützt]
Die Anzahl untergeordneter MediaElements in dieser Medienzusammenstellung. | CompositeElement | ||
resource : MediaResourceBase
Die Medienressource, auf die sich dieses Medienelement auswirkt. | MediaElement | ||
traitTypes : Vector.<String> [schreibgeschützt]
Ein Vektor von MediaTraitType-Werten, die die Merkmalstypen dieses Medienelements darstellen. | MediaElement |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | SerialElement | ||
Fügt das angegebene untergeordnete Element am Ende der Liste hinzu. | CompositeElement | ||
Fügt der Liste das untergeordnete Element an der festgelegten Indexposition hinzu. | CompositeElement | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Fügt diesem MediaElement unter der angegebenen Namespace-URL ein Metadatenobjekt hinzu. | MediaElement | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Ruft das untergeordnete Element an der festgelegten Indexposition ab. | CompositeElement | ||
Gibt die Indexposition des untergeordneten Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getChildAt(Index) == child. | CompositeElement | ||
Gibt das Metadatenobjekt zurück, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert ist. | MediaElement | ||
Gibt das Medienmerkmal des angegebenen Typs zurück. | MediaElement | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Bestimmt, ob dieses Medienelement ein Medienmerkmal des angegebenen Typs hat. | MediaElement | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt das untergeordnete Element und gibt es zurück. | CompositeElement | ||
Entfernt das untergeordnete Element an der angegebenen Indexposition und gibt es zurück. | CompositeElement | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Entfernt das Metadatenobjekt, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert wurde. | MediaElement | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
currentChild | Eigenschaft |
currentChild:MediaElement
[schreibgeschützt] Das derzeit aktive untergeordnete Element dieses SerialElement.
Implementierung
public function get currentChild():MediaElement
SerialElement | () | Konstruktor |
public function SerialElement()
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
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; } } }
Tue Jun 12 2018, 10:04 AM Z