Paketflash.media
Klassepublic final class SoundTransform
VererbungSoundTransform Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die SoundTransform-Klasse enthält Eigenschaften für die Lautstärke und Schwenkung. Die folgenden Objekte enthalten eine soundTransform-Eigenschaft, deren Wert ein SoundTransform-Objekt ist: Microphone, NetStream, SimpleButton, SoundChannel, SoundMixer und Sprite.

Beispiele anzeigen



Ö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
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  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 das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftsdetail
leftToLeftEigenschaft
leftToLeft:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
leftToRightEigenschaft 
leftToRight:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
panEigenschaft 
pan:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
rightToLeftEigenschaft 
rightToLeft:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
rightToRightEigenschaft 
rightToRight:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
volumeEigenschaft 
volume:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
Konstruktordetail
SoundTransform()Konstruktor
public function SoundTransform(vol:Number = 1, panning:Number = 0)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

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

Im Konstruktor wird der Sound geladen und einem Audiokanal zugewiesen (channel). 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. Hier wird die Richtungseinstellung auf 1.0 gesetzt, 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 Audiokanals zugewiesen. (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);
        }
    }
}
Beispiele Verwendung von Beispielen
SoundTransformExample.as

Mit dem folgenden Beispiel wird eine MP3-Datei geladen und abgespielt. Bewegen Sie die Maus, während die MP3-Datei wiedergegeben wird; die Lautstärke und Schwenkung werden mit der Bewegung der Maus über die Bühne geändert. 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;
            }
            if(pan > 1) pan = 0;

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

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




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/media/SoundTransform.html