MediaElement

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 MediaElement stellt eine einheitliche Mediendarstellung sicher. Es besteht z. B. aus einem einfachen Medienobjekt wie Video oder Sound. Verschiedene Instanzen (oder Unterklassen) können unterschiedliche Medientypen darstellen. Ein MediaElement ermöglicht auch komplexe Mediendarstellungen mit mehreren Objekten wie Videos, Werbebannern, SWF-Overlays, Branding des Seitenhintergrunds usw.

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

MediaTraitBase
MediaResourceBase

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MediaElement() 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
		addMetadata(namespaceURL:String, metadata:Metadata):void Fügt diesem MediaElement unter der angegebenen Namespace-URL ein Metadatenobjekt hinzu.	MediaElement
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getMetadata(namespaceURL:String):Metadata Gibt das Metadatenobjekt zurück, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert ist.	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase Gibt das Medienmerkmal des angegebenen Typs zurück.	MediaElement
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		hasTrait(type:String):Boolean Bestimmt, ob dieses Medienelement ein Medienmerkmal des angegebenen Typs hat.	MediaElement
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata Entfernt das Metadatenobjekt, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert wurde.	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

	Methode		Definiert von
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void Fügt diesem Medienelement ein neues Medienmerkmal hinzu.	MediaElement
		removeTrait(type:String):org.osmf.traits:MediaTraitBase Entfernt ein Medienmerkmal von diesem Medienelement.	MediaElement
		setupTraits():void Richtet die Merkmale dieses Medienelements ein.	MediaElement

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
containerChange	Wird nach einer Änderung der container-Eigenschaft des Elements ausgelöst.	MediaElement
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
mediaError	Wird ausgelöst, wenn ein Fehler auftritt, der sich auf den Betrieb des Medienelements auswirkt.	MediaElement
mediaInfo	Wird abgesetzt, wenn Informationen verfügbar sind, die sich auf den Betrieb des Medienelements auswirken.	MediaElement
metadataAdd	Wird ausgelöst, wenn diesem Medienelement ein Metadatenobjekt hinzugefügt wurde.	MediaElement
metadataRemove	Wird ausgelöst, wenn ein Metadatenobjekt aus diesem Medienelement entfernt wurde.	MediaElement
traitAdd	Wird ausgelöst, wenn dem Medienelement ein Merkmal hinzugefügt wird.	MediaElement
traitRemove	Wird ausgelöst, wenn ein Merkmal aus dem Medienelement entfernt wird.	MediaElement

Eigenschaftendetails

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

metadataNamespaceURLs:Vector.<String> [schreibgeschützt]

Ein Vektor, der die Namespace-URLs für alle in diesem Medienelement gespeicherten Metadatenobjekte enthält.

Implementierung
public function get metadataNamespaceURLs():Vector.<String>

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>

Konstruktordetails

()

Konstruktor

public function MediaElement()

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Methodendetails

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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.

Ereignisdetails

containerChange

Ereignis

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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

Ereignisobjekttyp: 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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

MediaElement - AS3 OSMF

Klassen x

container

metadataNamespaceURLs

resource

traitTypes

MediaElement

addMetadata

addTrait

getMetadata

getTrait

hasTrait

removeMetadata

removeTrait

setupTraits

containerChange

mediaError

mediaInfo

metadataAdd

metadataRemove

traitAdd

traitRemove