| Paket | mx.effects |
| Klasse | public class SoundEffect |
| Vererbung | SoundEffect  Effect EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sie geben die MP3-Datei mit der source-Eigenschaft an. Wenn Sie die MP3-Datei bereits eingebettet haben, können Sie mit dem Embed-Schlüsselwort das Class-Objekt der MP3-Datei an die source-Eigenschaft übergeben. Geben Sie andernfalls die vollständige URL der MP3-Datei an.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:SoundEffect> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:SoundEffect
Properties
id="ID"
autoLoad="true|false"
bufferTime="1000"
loops="0"
panEasingFunction=""
panFrom="0"
source=""
startTime="0"
useDuration="true|false"
volumeEasingFunction="true|false"
volumeTo="1"
Events
complete="No default"
id3="No default"
ioError="No default"
progress="No default"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| autoLoad : Boolean
Bei „true“ laden Sie die MP3-Datei, wenn die „Source“ angegeben wurde. | SoundEffect | ||
| bufferTime : Number = 1000
Die SoundEffect-Klasse verwendet ein internes Sound-Objekt zum Steuern der MP3-Datei. | SoundEffect | ||
 | className : String [schreibgeschützt]
Name der Effektklasse wie „Fade“. | Effect | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| customFilter : mx.effects:EffectTargetFilter
Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird. | Effect | |
| duration : Number
Dauer des Effekts in Millisekunden. | Effect | |
| effectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht. | Effect | |
| filter : String
Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an. | Effect | |
| hideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll. | Effect | |
| instanceClass : Class
Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt. | Effect | |
| isLoading : Boolean [schreibgeschützt]
Diese Eigenschaft hat den Wert „true“, wenn die MP3 geladen wurde. | SoundEffect | ||
| isPlaying : Boolean [schreibgeschützt]
Ein Flag für den Schreibschutz, das auf „true“ gesetzt ist, wenn Instanzen des Effekts aktuell wiedergegeben werden, und andernfalls auf „false“. | Effect | |
| loops : int = 0
Anzahl der Wiedergaben in einer Sound-Schleife. Beim Wert 0 wird der Effekt ein einziges Mal wiedergegeben, beim Wert 1 zwei Male usw. | SoundEffect | ||
| panEasingFunction : Function
Die Beschleunigungsfunktion für den Richtungseffekt. | SoundEffect | ||
| panFrom : Number
Richtungseinstellung des Sound-Objekts am Anfang. | SoundEffect | ||
| panTo : Number
Richtungseinstellung des Sound-Objekts am Ende. | SoundEffect | ||
| perElementOffset : Number
Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts. | Effect | |
| playheadTime : Number
Aktuelle Zeitposition des Effekts. | Effect | |
| relevantProperties : Array
Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern. | Effect | |
| relevantStyles : Array
Ein Array von Stilnamen zur Verwendung beim Filtern. | Effect | |
| repeatCount : int = 1
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll. | Effect | |
| repeatDelay : int = 0
Wartezeit in Millisekunden vor der Wiederholung des Effekts. | Effect | |
| sound : Sound [schreibgeschützt]
Das Sound-Objekt, in das die MP3-Datei geladen wurde. | SoundEffect | ||
| source : Object
Die URL oder Klasse der MP3-Datei, die wiedergegeben werden soll. | SoundEffect | ||
| startDelay : int = 0
Wartezeit in Millisekunden vor dem Starten des Effekts. | Effect | |
| startTime : Number = 0
Die Anfangsposition in der MP3-Datei in Millisekunden, an der die Wiedergabe beginnen soll. | SoundEffect | ||
| suspendBackgroundProcessing : Boolean = false
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird. | Effect | |
| target : Object
Das Objekt, auf das dieser Effekt angewendet wird. | Effect | |
| targets : Array
Ein Array von Objekten, die als Ziele des Effekts verwendet werden können. | Effect | |
| triggerEvent : Event
Der EffectManager übergibt diesem Effekt das Ereignisobjekt, wenn ein Effekt ausgelöst wird, oder null, wenn der Effekt nicht vom EffectManager wiedergegeben wird. | Effect | |
| useDuration : Boolean = true
Bei „true“ wird der Effekt nach der durch die duration-Eigenschaft angegebenen Zeit beendet. | SoundEffect | ||
| volumeEasingFunction : Function
Die Beschleunigungsfunktion für den Lautstärkeeffekt. | SoundEffect | ||
| volumeFrom : Number
Lautstärke des Sound-Objekts am Anfang. | SoundEffect | ||
| volumeTo : Number
Lautstärke des Sound-Objekts am Ende. | SoundEffect | ||
| Methode | Definiert von | ||
|---|---|---|---|
SoundEffect(target:Object = null)
Konstruktor. | SoundEffect | ||
| 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 | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte. | Effect | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.
| Effect | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts. | Effect | |
|
Erstellt eine einzelne Effektinstanz und initialisiert sie. | Effect | |
|
Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf. | Effect | |
|
Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen. | Effect | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts. | Effect | |
|
Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird. | Effect | |
|
Ü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 | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Lädt die MP3, wenn die Source-Eigenschaft auf eine URL verweist. | SoundEffect | ||
|
Hält den Effekt an, bis die resume()-Methode aufgerufen wird. | Effect | |
|
Startet die Wiedergabe des Effekts. | Effect | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde. | Effect | |
|
Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts. | Effect | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Hält den Effekt an und behält den aktuellen Status der Effektziele bei. | Effect | |
|
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 | |
| 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 ausgelöst, wenn das Laden der Sounddatei abgeschlossen ist. | SoundEffect | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn die Wiedergabe einer der Effektinstanzen beendet wurde, da die Instanz das Ende erreicht hatte oder da der Effekt durch den Aufruf der end()-Methode unterbrochen wurde. | Effect | ||
| Wird ausgelöst, wenn die Wiedergabe eines Effekts gestartet wird. | Effect | ||
| Wird ausgelöst, wenn der Effekt angehalten wurde. Dies geschieht nur, wenn der Effekt durch Aufrufen der stop()-Methode unterbrochen wird. | Effect | ||
| Wird ausgelöst, wenn für eine MP3-Sounddatei ID3-Daten zur Verfügung stehen. | SoundEffect | |||
| Wird ausgelöst, wenn ein Fehler während des Ladens der Sounddatei auftritt. | SoundEffect | |||
| Wird regelmäßig beim Laden der Sounddatei ausgelöst. | SoundEffect | |||
autoLoad | Eigenschaft |
autoLoad:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bei true wird die MP3-Datei geladen, wenn die Source angegeben wurde.
Der Standardwert ist true.
Implementierung
public function get autoLoad():Boolean public function set autoLoad(value:Boolean):voidbufferTime | Eigenschaft |
public var bufferTime:Number = 1000| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die SoundEffect-Klasse verwendt ein internes Sound-Objekt zum Steuern der MP3-Datei. Diese Eigenschaft gibt an, wie viele Millisekunden Sounddaten im Puffer des Sound-Objekts mindestens enthalten sein müssen. Beim Starten und Fortsetzen der Wiedergabe nach einem Netzwerkabsturz wartet das Sound-Objekt mit der Wiedergabe, bis es mindestens so viele Daten erhalten hat.
Der Standardwert ist 1000.
isLoading | Eigenschaft |
loops | Eigenschaft |
public var loops:int = 0| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Anzahl der Wiedergaben in einer Sound-Schleife. Beim Wert 0 wird der Effekt ein einziges Mal wiedergegeben, beim Wert 1 zwei Male usw. Soll die MP3-Datei wiederholt werden, dann wird die Wiedergabezeit durch die useDuration-Eigenschaft bestimmt.
Die duration-Eigenschaft hat Vorrang vor dieser Eigenschaft. Wenn die Effektdauer nicht lang genug ist, um den Sound mindestens ein Mal ganz wiederzugeben, durchläuft der Sound keine Schleife.
Der Standardwert ist 0.
panEasingFunction | Eigenschaft |
public var panEasingFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Beschleunigungsfunktion für den Richtungseffekt. Mit dieser Funktion können Sie zwischen den Werten von panFrom und panTo interpolieren.
panFrom | Eigenschaft |
public var panFrom:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Richtungseinstellung des Sound-Objekts am Anfang. Der Wert kann zwischen -1,0 und 1,0 liegen. Bei -1,0 wird nur der linke Kanal und bei 1,0 nur der rechte Kanal verwendet. Bei 0,0 wird der Sound gleichmäßig über beide Kanäle übertragen.
Der Standardwert ist 0.0.
panTo | Eigenschaft |
public var panTo:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Richtungseinstellung des Sound-Objekts am Ende. Der Wert kann zwischen -1,0 und 1,0 liegen. Bei -1,0 wird nur der linke Kanal und bei 1,0 nur der rechte Kanal verwendet. Bei 0,0 wird der Sound gleichmäßig über beide Kanäle übertragen.
Der Standardwert ist 0.0.
sound | Eigenschaft |
source | Eigenschaft |
source:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die URL oder Klasse der MP3-Datei, die wiedergegeben werden soll. Wenn Sie die MP3-Datei bereits eingebettet haben, können Sie mit dem Embed-Schlüsselwort das Class-Objekt der MP3-Datei an die source-Eigenschaft übergeben. Geben Sie andernfalls die vollständige URL der MP3-Datei an.
Implementierung
public function get source():Object public function set source(value:Object):voidstartTime | Eigenschaft |
public var startTime:Number = 0| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Anfangsposition in der MP3-Datei in Millisekunden, an der die Wiedergabe beginnen soll.
Der Standardwert ist 0.
useDuration | Eigenschaft |
public var useDuration:Boolean = true| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bei true wird der Effekt nach der durch die duration-Eigenschaft angegebenen Zeit beendet. Bei false endet der Effekt am Ende der MP3 oder der Schleife.
Der Standardwert ist true.
volumeEasingFunction | Eigenschaft |
public var volumeEasingFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Beschleunigungsfunktion für den Lautstärkeeffekt. Mit dieser Funktion können Sie zwischen den Werten von volumeFrom und volumeTo interpolieren.
volumeFrom | Eigenschaft |
public var volumeFrom:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Lautstärke des Sound-Objekts am Anfang. Die Werte können zwischen 0,0 und 1,0 liegen.
Der Standardwert ist 1.
volumeTo | Eigenschaft |
public var volumeTo:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Lautstärke des Sound-Objekts am Ende. Die Werte können zwischen 0,0 und 1,0 liegen.
Der Standardwert ist 1.
SoundEffect | () | Konstruktor |
load | () | Methode |
public function load():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Lädt die MP3, wenn die Source-Eigenschaft auf eine URL verweist.
complete | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.COMPLETE| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn das Laden der Sounddatei abgeschlossen ist.
DieEvent.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
id3 | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.ID3| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn für eine MP3-Sounddatei ID3-Daten zur Verfügung stehen.
DieEvent.ID3-Konstante definiert den Wert der type-Eigenschaft eines id3-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Sound-Objekt, über das die MP3-Datei geladen wird, für die nun ID3-Daten verfügbar sind. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
ioError | Ereignis |
flash.events.IOErrorEventEigenschaft IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn ein Fehler während des Ladens der Sounddatei auftritt.
Definiert den Wert der Eigenschafttype eines ioError-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
errorID | Die Referenznummer des spezifischen Fehlers (nur AIR). |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
progress | Ereignis |
flash.events.ProgressEventEigenschaft ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird regelmäßig beim Laden der Sounddatei ausgelöst.
Innerhalb des Ereignisobjekts können Sie auf die Anzahl der aktuell geladenen Bytes und die insgesamt zu ladende Anzahl von Bytes zugreifen. Das Ereignis wird nicht immer ausgelöst. In manchen Fällen tritt das complete-Ereignis ohne progress-Ereignisse auf.
type eines progress-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden. |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Fortschritt protokolliert wird. |
<?xml version="1.0"?>
<!-- Simple example to demonstrate the SoundEffect effect. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Declarations>
<mx:SoundEffect id="mySounds" source="@Embed(source='assets/jazz.mp3')"/>
</fx:Declarations>
<s:Panel title="Sound Effect Example" width="75%" height="75%" >
<s:VGroup left="20" right="20" top="20" bottom="20">
<s:Label width="100%" color="blue"
text="Click on the phone to hear the sound effect."/>
<mx:Image id="flex" source="@Embed(source='assets/Nokia_6630.png')"
mouseDownEffect="{mySounds}"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z