ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
org.osmf.elements 

AudioElement  - AS3 OSMF

Paketorg.osmf.elements
Klassepublic class AudioElement
VererbungAudioElement Inheritance LoadableElementBase Inheritance MediaElement Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: OSMF 1.0
Laufzeitversionen: Flash Player 10, AIR 1.5

AudioElement ist ein speziell für die Audiowiedergabe erstelltes Medienelement. Es unterstützt sowohl Streaming- als auch progressive Formate.

AudioElement kann alle MP3- und AAC-Dateien laden und präsentieren. Es unterstützt MP3-Dateien über HTTP sowie Nur-Audio-Streams vom Flash Media Server.

Dies sind die grundlegenden Schritte für das Erstellen und Verwenden von AudioElement:

  1. Neue URLResource erstellen, die auf die URL des Audiostreams oder der Datei mit dem zu ladenden Audio verweist.
  2. Neues AudioElement erstellen, das die URLResource als Parameter übergibt.
  3. Neuen MediaPlayer erstellen.
  4. Das AudioElement der media-Eigenschaft des MediaPlayer zuweisen.
  5. Die Medien mit den Methoden, Eigenschaften und Ereignissen des MediaPlayer steuern.
  6. Wenn Sie mit dem AudioElement fertig sind, setzen Sie die media-Eigenschaft des MediaPlayer auf null. Dadurch wird das AudioElement entladen.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedcontainer : IMediaContainer
[schreibgeschützt] Der von diesem Element verwendete Mediencontainer.
MediaElement
  defaultDuration : Number
Definiert die Dauer, für die das TimeTrait des Elements bis zum Laden des Elementinhalts dargestellt wird.
AudioElement
 InheritedmetadataNamespaceURLs : Vector.<String>
[schreibgeschützt] Ein Vektor, der die Namespace-URLs für alle in diesem Medienelement gespeicherten Metadatenobjekte enthält.
MediaElement
 Inheritedresource : MediaResourceBase
Die Medienressource, auf die sich dieses Medienelement auswirkt.
MediaElement
 InheritedtraitTypes : Vector.<String>
[schreibgeschützt] Ein Vektor von MediaTraitType-Werten, die die Merkmalstypen dieses Medienelements darstellen.
MediaElement
Geschützte Eigenschaften
 EigenschaftDefiniert von
 Inheritedloader : LoaderBase
Die von diesem Element zum Laden von Ressourcen verwendete LoaderBase.
LoadableElementBase
Öffentliche Methoden
 MethodeDefiniert von
  
AudioElement(resource:URLResource = null, loader:LoaderBase = null)
Konstruktor.
AudioElement
 Inherited
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
 Inherited
addMetadata(namespaceURL:String, metadata:Metadata):void
Fügt diesem MediaElement unter der angegebenen Namespace-URL ein Metadatenobjekt hinzu.
MediaElement
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Gibt das Metadatenobjekt zurück, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert ist.
MediaElement
 Inherited
Gibt das Medienmerkmal des angegebenen Typs zurück.
MediaElement
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Bestimmt, ob dieses Medienelement ein Medienmerkmal des angegebenen Typs hat.
MediaElement
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Entfernt das Metadatenobjekt, das unter diesem MediaElement mit der angegebenen Namespace-URL gespeichert wurde.
MediaElement
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 MethodeDefiniert von
 Inherited
Fügt diesem Medienelement ein neues Medienmerkmal hinzu.
MediaElement
 Inherited
Unterklassen können diese Methode überschreiben, um eine angepasste LoadTrait-Unterklasse zurückzugeben.
LoadableElementBase
 Inherited
Unterklassen können diese Methode überschreiben, um die Verarbeitung zu übernehmen, wenn das Medienelement in den LOADING-Status eintritt.
LoadableElementBase
 Inherited
Unterklassen können diese Methode überschreiben, um die Verarbeitung zu übernehmen, wenn das Medienelement in den READY-Status eintritt.
LoadableElementBase
 Inherited
Unterklassen können diese Methode überschreiben, um die Verarbeitung zu übernehmen, wenn das Medienelement in den UNLOADING-Status eintritt.
LoadableElementBase
 Inherited
Entfernt ein Medienmerkmal von diesem Medienelement.
MediaElement
 Inherited
Richtet die Merkmale dieses Medienelements ein.
MediaElement
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedWird nach einer Änderung der container-Eigenschaft des Elements ausgelöst.MediaElement
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn ein Fehler auftritt, der sich auf den Betrieb des Medienelements auswirkt.MediaElement
 InheritedWird abgesetzt, wenn Informationen verfügbar sind, die sich auf den Betrieb des Medienelements auswirken.MediaElement
 InheritedWird ausgelöst, wenn diesem Medienelement ein Metadatenobjekt hinzugefügt wurde.MediaElement
 InheritedWird ausgelöst, wenn ein Metadatenobjekt aus diesem Medienelement entfernt wurde.MediaElement
 InheritedWird ausgelöst, wenn dem Medienelement ein Merkmal hinzugefügt wird.MediaElement
 InheritedWird ausgelöst, wenn ein Merkmal aus dem Medienelement entfernt wird.MediaElement
Eigenschaftendetails

defaultDuration

Eigenschaft
defaultDuration:Number

Sprachversion: ActionScript 3.0
Produktversion: OSMF 1.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Definiert die Dauer, für die das TimeTrait des Elements bis zum Laden des Elementinhalts dargestellt wird. Wenn diese Eigenschaft auf einen positiven Wert eingestellt wird, führt dies dazu, dass das Element temporal wird, also über eine Zeitsteuerung verfügt. Jeder andere Wert entfernt das TimeTrait des Elements, es sei denn, der geladene Inhalt gibt eine Dauer an.



Implementierung
    public function get defaultDuration():Number
    public function set defaultDuration(value:Number):void
Konstruktordetails

AudioElement

()Konstruktor
public function AudioElement(resource:URLResource = null, loader:LoaderBase = null)

Sprachversion: ActionScript 3.0
Produktversion: OSMF 1.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor.

Parameter
resource:URLResource (default = null) — URLResource, die auf die Audioquelle verweist, die vom AudioElement verwendet wird.
 
loader:LoaderBase (default = null) — Für das Laden des Sounds verwendeter Loader. Dies muss entweder ein NetLoader (für Streamingaudio) oder ein SoundLoader (für progressives Audio) sein. Wenn null, wird der entsprechende Loader aufgrund des Ressourcentyps erstellt.

Auslöser
ArgumentError — Wenn der Loader weder ein NetLoader noch ein SoundLoader ist.

Verwandte API-Elemente

AudioElementExample.as

package
{
    import flash.display.Sprite;
    
    import org.osmf.elements.AudioElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.URLResource;
    
    public class AudioElementExample extends Sprite
    {
        public function AudioElementExample()
        {
            super();
            
            var mediaPlayer:MediaPlayer = new MediaPlayer();
            var audioElement:AudioElement = new AudioElement();
            audioElement.resource = new URLResource("http://mediapm.edgesuite.net/osmf/content/test/train_1500.mp3");
            
            mediaPlayer.media = audioElement;        
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.