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...
flash.media 

SoundTransform  - AS3

Paketflash.media
Klassepublic final class SoundTransform
VererbungSoundTransform Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die SoundTransform-Klasse enthält Eigenschaften für die Lautstärke und Schwenkung.

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
  leftToLeft : Number
Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des linken Eingangssignals über den linken Lautsprecher wiedergegeben wird.
SoundTransform
  leftToRight : Number
Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des linken Eingangssignals über den rechten Lautsprecher wiedergegeben wird.
SoundTransform
  pan : Number
Die Richtungseinstellung des Sounds von links nach rechts in einem Bereich zwischen -1 (vollständig links) und 1 (vollständig rechts).
SoundTransform
  rightToLeft : Number
Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des rechten Eingangssignals über den linken Lautsprecher wiedergegeben wird.
SoundTransform
  rightToRight : Number
Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des rechten Eingangssignals über den rechten Lautsprecher wiedergegeben wird.
SoundTransform
  volume : Number
Die Lautstärke im Bereich von 0 (stumm) bis 1 (volle Lautstärke).
SoundTransform
Öffentliche Methoden
 MethodeDefiniert von
  
SoundTransform(vol:Number = 1, panning:Number = 0)
Erstellt ein SoundTransform-Objekt.
SoundTransform
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 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
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
Eigenschaftendetails

leftToLeft

Eigenschaft
leftToLeft:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des linken Eingangssignals über den linken Lautsprecher wiedergegeben wird.



Implementierung
    public function get leftToLeft():Number
    public function set leftToLeft(value:Number):void

leftToRight

Eigenschaft 
leftToRight:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des linken Eingangssignals über den rechten Lautsprecher wiedergegeben wird.



Implementierung
    public function get leftToRight():Number
    public function set leftToRight(value:Number):void

pan

Eigenschaft 
pan:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Richtungseinstellung des Sounds von links nach rechts in einem Bereich zwischen -1 (vollständig links) und 1 (vollständig rechts). Beim Wert 0 erfolgt keine Richtungseinstellung (ausgeglichene Mitte zwischen rechts und links).



Implementierung
    public function get pan():Number
    public function set pan(value:Number):void

rightToLeft

Eigenschaft 
rightToLeft:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des rechten Eingangssignals über den linken Lautsprecher wiedergegeben wird.



Implementierung
    public function get rightToLeft():Number
    public function set rightToLeft(value:Number):void

rightToRight

Eigenschaft 
rightToRight:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Wert zwischen 0 (nicht) und 1 (vollständig), der angibt, welcher Anteil des rechten Eingangssignals über den rechten Lautsprecher wiedergegeben wird.



Implementierung
    public function get rightToRight():Number
    public function set rightToRight(value:Number):void

volume

Eigenschaft 
volume:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Lautstärke im Bereich von 0 (stumm) bis 1 (volle Lautstärke).



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

SoundTransform

()Konstruktor
public function SoundTransform(vol:Number = 1, panning:Number = 0)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein SoundTransform-Objekt.

Parameter
vol:Number (default = 1) — Die Lautstärke im Bereich von 0 (stumm) bis 1 (volle Lautstärke).
 
panning:Number (default = 0) — Die Richtungseinstellung des Sounds von links nach rechts in einem Bereich zwischen -1 (vollständig links) und 1 (vollständig rechts). Beim Wert 0 erfolgt keine Richtungseinstellung (Mitte).

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird Sound nur über den rechten Kanal wiedergegeben und die Lautstärke ist auf 50 Prozent eingestellt.

Der Sound wird im Konstruktor und einem zweiten Soundkanal (channel) zugewiesen. Außerdem wird ein SoundTransform-Objekt (transform) erstellt. Dessen erstes Argument legt die Lautstärke auf 50 Prozent fest (der Bereich liegt zwischen 0,0 und 1,0). Das zweite Argument legt die Richtungseinstellung fest. In diesem Beispiel ist die Richtung auf 1,0 eingestellt, was bedeutet, dass der Sound nur aus dem rechten Lautsprecher kommt. Damit diese Einstellungen wirksam werden, wird das SoundTransform-Objekt transform der Eigenschaft soundTransform des Soundkanals zugewiesen.

Hinweis: Für dieses Beispiel wurde nur eine sehr eingeschränkte Fehlerverarbeitung geschrieben.

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.media.SoundTransform;
    import flash.events.IOErrorEvent;

    public class SoundTransform_constructorExample extends Sprite
    {
        public function SoundTransform_constructorExample() {
            var mySound:Sound = new Sound();
            var url:URLRequest = new URLRequest("mySound.mp3");
            var channel:SoundChannel;
            var transform:SoundTransform = new SoundTransform(0.5, 1.0);

            mySound.load(url);    
            channel = mySound.play();
            channel.soundTransform = transform;

            mySound.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }

        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace("The sound could not be loaded: " + errorEvent.text);
        }
    }
}
SoundTransformExample.as

Mit dem folgenden Beispiel wird eine MP3-Datei geladen und abgespielt. Bewegen Sie die Maus oder das Benutzereingabegerät, während die MP3-Datei abgespielt wird; die Lautstärke und die Richtungseinstellung ändern sich, wenn Sie die Maus oder das Benutzereingabegerät über die Bühne bewegen. Legen Sie zur Ausführung dieses Beispiels eine Datei mit dem Namen „MySound.mp3“ in dem Verzeichnis ab, in dem sich die SWF-Datei befindet.
package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.*;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.media.SoundTransform;
    import flash.net.URLRequest;
    import flash.utils.Timer;

    public class SoundTransformExample extends Sprite {
        private var url:String = "MySound.mp3";
        private var soundFactory:Sound;
        private var channel:SoundChannel;
        private var positionTimer:Timer;

        public function SoundTransformExample() {
            stage.align = StageAlign.TOP_LEFT;
            stage.scaleMode = StageScaleMode.NO_SCALE;

            var request:URLRequest = new URLRequest(url);
            soundFactory = new Sound();
            soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            soundFactory.load(request);
            channel = soundFactory.play();
            stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function ioErrorHandler(event:Event):void {
            trace("ioErrorHandler: " + event);
        }

        private function setPan(pan:Number):void {
            trace("setPan: " + pan.toFixed(2));
            var transform:SoundTransform = channel.soundTransform;
            transform.pan = pan;
            channel.soundTransform = transform;
        }

        private function setVolume(volume:Number):void {
            trace("setVolume: " + volume.toFixed(2));
            var transform:SoundTransform = channel.soundTransform;
            transform.volume = volume;
            channel.soundTransform = transform;
        }

        private function mouseMoveHandler(event:MouseEvent):void {
            var halfStage:uint = Math.floor(stage.stageWidth / 2);
            var xPos:uint = event.stageX;
            var yPos:uint = event.stageY;
            var value:Number;
            var pan:Number;

            if (xPos > halfStage) {
                value = xPos / halfStage;
                pan = value - 1;
            } else if (xPos < halfStage) {
                value = (xPos - halfStage) / halfStage;
                pan = value;
            } else {
                pan = 0;
            }

            var volume:Number = 1 - (yPos / stage.stageHeight);

            setVolume(volume);
            setPan(pan);
            
        }
    }
}




[ 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.