SoundAsset

Paket	mx.core
Klasse	public class SoundAsset
Vererbung	SoundAsset Sound EventDispatcher Object
Implementiert	IFlexAsset

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

SoundAsset ist eine Unterklasse der flash.media.Sound-Klasse, die Sounds repräsentiert, die Sie in eine Flex-Anwendung einbetten.

Der eingebettete Sound kann das Format einer MP3-Datei haben. Sie können auch ein Soundsymbol einbetten, das sich in einer von Flash erzeugten SWF-Datei befindet. In beiden Fällen generiert der MXML-Compiler automatisch eine die die SoundAsset-Klasse erweiternde Klasse zur Repräsentation der eingebetteten Sounddaten.

Sie brauchen beim Schreiben einer Flex-Anwendung die SoundAsset-Klasse normalerweise nicht direkt zu verwenden. Beispiel: Sie können eine MP3-Datei einbetten und in einem SoundEffect verwenden, indem Sie einfach Folgendes schreiben:

  <mx:SoundEffect id="beep" source="@Embed(source='Beep.mp3')"/>

Sie brauchen die Tatsache, dass der MXML-Compiler für Sie eine Unterklasse der SoundAsset-Klasse erstellt hat, nicht weiter zur verstehen.

Es kann jedoch nützlich sein, dass Sie verstehen, was auf der ActionScript-Ebene abläuft. Zum Einbetten einer Bitmap in ActionScript deklarieren Sie eine Variable des Class-Typs und versehen sie mit [Embed]-Metadaten. Eine MP3-Datei betten Sie beispielsweise wie folgt ein:

  [Bindable]
  [Embed(source="Beep.mp3")]
  private var beepClass:Class;

Der MXML-Compiler erkennt die MP3-Erweiterung, transkodiert die MP3-Daten in das vom Player verwendete Soundformat, generiert automatisch eine Unterklasse der SoundAsset-Klasse und stellt Ihre Variable so ein, dass sie einen Verweis auf diese automatisch generierte Klasse darstellt. Sie können diesen Klassenverweis zum Erstellen von Instanzen der SoundAsset-Klasse mit dem new-Operator verwenden, und Sie können in Verbindung mit diesen Instanzen die APIs der Sound-Klasse verwenden:

    var beepSound:SoundAsset = SoundAsset(new beepClass());
    beepSound.play();

Es ist jedoch selten erforderlich, dass Sie SoundAsset-Instanzen selbst erstellen, da soundbezogene Eigenschaften und Stile einfach auf eine sounderzeugende Klasse eingestellt werden können und die Komponenten Sound-Instanzen nach Bedarf erstellen. Beispiel: Zur Wiedergabe dieses Sounds mit einem SoundEffect können Sie die source-Eigenschaft des SoundEffect auf beepClass einstellen. In MXML gehen Sie dazu wie folgt vor:

  <mx:SoundEffect id="beepEffect" source="{beepClass}"/>

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bytesLoaded : uint [schreibgeschützt] Gibt die derzeit verfügbare Anzahl der Byte in diesem Soundobjekt zurück.	Sound
		bytesTotal : int [schreibgeschützt] Gibt die Gesamtanzahl der Byte in diesem Soundobjekt zurück.	Sound
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		id3 : ID3Info [schreibgeschützt] Bietet Zugriff auf die Metadaten, die in MP3-Dateien enthalten sind.	Sound
		isBuffering : Boolean [schreibgeschützt] Gibt den Zwischenspeicherstatus externer MP3-Dateien zurück.	Sound
		isURLInaccessible : Boolean [schreibgeschützt] Gibt an, ob die Sound.url-Eigenschaft gekürzt wurde.	Sound
		length : Number [schreibgeschützt] Die Länge des aktuellen Sounds in Millisekunden.	Sound
		url : String [schreibgeschützt] Die URL, von der der Sound geladen wurde.	Sound

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		SoundAsset() Konstruktor.	SoundAsset
		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
		close():void Schließt den Stream. Dadurch werden eventuelle Downloads von Daten beendet.	Sound
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		extract(target:ByteArray, length:Number, startPosition:Number = -1):Number Extrahiert unformatierte Sounddaten aus einem Soundobjekt.	Sound
		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
		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
		load(stream:URLRequest, context:SoundLoaderContext = null):void Initiiert den Ladevorgang einer externen MP3-Datei von der angegebenen URL.	Sound
		loadCompressedDataFromByteArray(bytes:ByteArray, bytesLength:uint):void lädt MP3-Sounddaten aus einem ByteArray-Objekt in ein Sound-Objekt.	Sound
		loadPCMFromByteArray(bytes:ByteArray, samples:uint, format:String = "float", stereo:Boolean = true, sampleRate:Number = 44100.0):void Lädt PCM 32-Bit-Gleitkomma-Sounddaten aus einem ByteArray-Objekt in ein Sound-Objekt.	Sound
		play(startTime:Number = 0, loops:int = 0, sndTransform:flash.media:SoundTransform = null):SoundChannel Erstellt ein neues SoundChannel-Objekt zur Wiedergabe von Sound.	Sound
		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
		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

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
complete	Wird nach dem erfolgreichen Laden von Daten ausgelöst.	Sound
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
id3	Wird durch ein Soundobjekt ausgelöst, wenn ID3-Daten für MP3-Sound verfügbar sind.	Sound
ioError	Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den der Ladevorgang fehlschlägt.	Sound
open	Wird beim Start eines Ladevorgangs ausgelöst.	Sound
progress	Wird ausgelöst, wenn während eines Ladevorgangs Daten empfangen werden.	Sound
sampleData	Wird abgesetzt, wenn die Laufzeitumgebung neue Audiodaten anfordert.	Sound

Konstruktordetails

()

Konstruktor

public function SoundAsset()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Rechtliche Hinweise | Onlinedatenschutzerklärung

SoundAsset - AS3 Flex

Klassen x

SoundAsset