Paket | org.osmf.media |
Klasse | public class MediaElement |
Vererbung | MediaElement EventDispatcher Object |
Unterklassen | BeaconElement, CompositeElement, HTMLElement, LoadableElementBase, ProxyElement |
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Medienelement kapselt programmgesteuert eine Gruppe von Medienmerkmalen und Raum für Status. Die Medienmerkmale stellen die Funktionen des Medienelements dar und sind dynamischer Natur. Es kann z. B. zu einem bestimmten Zeitpunkt möglich sein, bei einem Medienelement einen Suchlauf durchzuführen, zu einem anderen Zeitpunkt aber nicht. Beispiel: Das Medienelement ist eine Videosequenz mit Werbespots, die nicht übersprungen werden können.
Ein Medienelement wirkt sich auf eine Medienressource aus. Beispiel: Wenn das Medienelement einen Videoplayer darstellt, kann die Medienressource eine URL zu einem Videostream enthalten. Wenn das Medienelement für eine komplexe Medienzusammenstelllungsteht, kann die Medienressourcen-URL ein Dokument sein, das mehrere in der Medienzusammenstellung verwendete Ressourcen referenziert.
Verwandte API-Elemente
MediaResourceBase
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 | ||
metadataNamespaceURLs : Vector.<String> [schreibgeschützt]
Ein Vektor, der die Namespace-URLs für alle in diesem Medienelement gespeicherten Metadatenobjekte enthält. | MediaElement | ||
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. | MediaElement | ||
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 | ||
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 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 |
Methode | Definiert von | ||
---|---|---|---|
Fügt diesem Medienelement ein neues Medienmerkmal hinzu. | MediaElement | ||
Entfernt ein Medienmerkmal von diesem Medienelement. | MediaElement | ||
Richtet die Merkmale dieses Medienelements ein. | MediaElement |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird nach einer Änderung der container-Eigenschaft des Elements ausgelöst. | MediaElement | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein Fehler auftritt, der sich auf den Betrieb des Medienelements auswirkt. | MediaElement | |||
Wird abgesetzt, wenn Informationen verfügbar sind, die sich auf den Betrieb des Medienelements auswirken. | MediaElement | |||
Wird ausgelöst, wenn diesem Medienelement ein Metadatenobjekt hinzugefügt wurde. | MediaElement | |||
Wird ausgelöst, wenn ein Metadatenobjekt aus diesem Medienelement entfernt wurde. | MediaElement | |||
Wird ausgelöst, wenn dem Medienelement ein Merkmal hinzugefügt wird. | MediaElement | |||
Wird ausgelöst, wenn ein Merkmal aus dem Medienelement entfernt wird. | MediaElement |
container | Eigenschaft |
container:IMediaContainer
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der von diesem Element verwendete Mediencontainer.
Implementierung
public function get container():IMediaContainer
metadataNamespaceURLs | Eigenschaft |
resource | Eigenschaft |
resource:MediaResourceBase
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Medienressource, auf die sich dieses Medienelement auswirkt.
Implementierung
public function get resource():MediaResourceBase
public function set resource(value:MediaResourceBase):void
traitTypes | Eigenschaft |
traitTypes:Vector.<String>
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Vektor von MediaTraitType-Werten, die die Merkmalstypen dieses Medienelements darstellen.
Implementierung
public function get traitTypes():Vector.<String>
MediaElement | () | Konstruktor |
public function MediaElement()
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
addMetadata | () | Methode |
public function addMetadata(namespaceURL:String, metadata:Metadata):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt diesem MediaElement unter der angegebenen Namespace-URL ein Metadatenobjekt hinzu.
Parameter
namespaceURL:String — Die für das Speichern der Metadaten verwendete Namespace-URL.
| |
metadata:Metadata — Die hinzuzufügenden Metadaten.
|
Auslöser
ArgumentError — wenn namespaceURL oder Metadaten null sind.
|
addTrait | () | Methode |
protected function addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt diesem Medienelement ein neues Medienmerkmal hinzu. Ist dies erfolgreich, wird ein MediaElementEvent ausgelöst.
Parameter
type:String — Der MediaTraitType des hinzuzufügenden Medienmerkmals.
| |
instance:org.osmf.traits:MediaTraitBase — Das hinzuzufügende Medienmerkmal.
|
Auslöser
ArgumentError — Wenn einer der Parameter null ist oder wenn der angegebene Typ und der Typ des Medienmerkmals nicht übereinstimmen oder wenn eine andere Instanz einer bestimmten Merkmalsklasse bereits hinzugefügt wurde.
|
getMetadata | () | Methode |
public function getMetadata(namespaceURL:String):Metadata
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt das Metadatenobjekt zurück, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert ist.
Parameter
namespaceURL:String — Die Namespace-URL des abzurufenden Metadatenobjekts.
|
Metadata |
Auslöser
ArgumentError — Wenn die namespaceURL den Wert null hat.
|
getTrait | () | Methode |
public function getTrait(type:String):org.osmf.traits:MediaTraitBase
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt das Medienmerkmal des angegebenen Typs zurück.
Parameter
type:String — Der MediaTraitType des zurückzugebenden Mediums.
|
org.osmf.traits:MediaTraitBase — Das abgerufene Merkmal oder null , wenn dieses Medienelement nicht über dieses Merkmal verfügt.
|
Auslöser
ArgumentError — Wenn der Parameter den Wert null hat
|
hasTrait | () | Methode |
public function hasTrait(type:String):Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Bestimmt, ob dieses Medienelement ein Medienmerkmal des angegebenen Typs hat.
Parameter
type:String — Der MediaTraitType des Medienmerkmals, nach dem gesucht wird.
|
Boolean — true , wenn dieses Medienelement ein Medienmerkmal der angegebenen Klasse hat, andernfalls false .
|
Auslöser
ArgumentError — Wenn der Parameter den Wert null hat
|
removeMetadata | () | Methode |
public function removeMetadata(namespaceURL:String):Metadata
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt das Metadatenobjekt, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert wurde.
Parameter
namespaceURL:String — Die Namespace-URL der zu entfernenden Metadaten.
|
Metadata |
Auslöser
ArgumentError — Wenn die namespaceURL den Wert null hat.
|
removeTrait | () | Methode |
protected function removeTrait(type:String):org.osmf.traits:MediaTraitBase
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt ein Medienmerkmal von diesem Medienelement. Ist dies erfolgreich, wird ein MediaElementEvent ausgelöst.
Parameter
type:String — Der MediaTraitType des zu entfernenden Medienmerkmals.
|
org.osmf.traits:MediaTraitBase — Das entfernte Merkmal oder null , wenn kein Merkmal entfernt wurde.
|
Auslöser
ArgumentError — Wenn der Parameter den Wert null hat
|
setupTraits | () | Methode |
protected function setupTraits():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Richtet die Merkmale dieses Medienelements ein. Tritt während des Erstellens ein. Unterklassen müssen diese Methode überschreiben und für jedes eigene Merkmal addTrait aufrufen.
containerChange | Ereignis |
org.osmf.events.ContainerChangeEvent
Eigenschaft ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent.CONTAINER_CHANGE
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird nach einer Änderung der container-Eigenschaft des Elements ausgelöst.
Die ContainerChangeEvent.CONTAINER_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein containerChange-Ereignis.mediaError | Ereignis |
org.osmf.events.MediaErrorEvent
Eigenschaft MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn ein Fehler auftritt, der sich auf den Betrieb des Medienelements auswirkt.
Die MediaErrorEvent.MEDIA_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein mediaError-Ereignis.mediaInfo | Ereignis |
org.osmf.events.MediaErrorEvent
Eigenschaft MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_INFO
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 2.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird abgesetzt, wenn Informationen verfügbar sind, die sich auf den Betrieb des Medienelements auswirken. MEDIA_INFO-Ereignisse sind nicht schwerwiegend.
metadataAdd | Ereignis |
org.osmf.events.MediaElementEvent
Eigenschaft MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_ADD
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn diesem Medienelement ein Metadatenobjekt hinzugefügt wurde.
Die MediaElementEvent.METADATA_ADD-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein metadataAdd-Ereignis.metadataRemove | Ereignis |
org.osmf.events.MediaElementEvent
Eigenschaft MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_REMOVE
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn ein Metadatenobjekt aus diesem Medienelement entfernt wurde.
Die MediaElementEvent.METADATA_REMOVE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein metadataRemove-Ereignis.traitAdd | Ereignis |
org.osmf.events.MediaElementEvent
Eigenschaft MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_ADD
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn dem Medienelement ein Merkmal hinzugefügt wird.
Die MediaElementEvent.TRAIT_ADD-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein traitAdd-Ereignis.traitRemove | Ereignis |
org.osmf.events.MediaElementEvent
Eigenschaft MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_REMOVE
Sprachversion: | ActionScript 3.0 |
Produktversion: | OSMF 1.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn ein Merkmal aus dem Medienelement entfernt wird.
Die MediaElementEvent.TRAIT_REMOVE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein traitRemove-Ereignis.Tue Jun 12 2018, 10:04 AM Z