Pacchettoflash.media
Classepublic final class SoundTransform
EreditarietàSoundTransform Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe SoundTransform contiene proprietà relative al volume e alla panoramica. I seguenti oggetti contengono una proprietà soundTransform, il cui valore è un oggetto SoundTransform: Microphone, NetStream, SimpleButton, SoundChannel, SoundMixer e Sprite.

Vedere gli esempi



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  leftToLeft: Number
Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input sinistro da riprodurre nell'altoparlante sinistro.
SoundTransform
  leftToRight: Number
Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input sinistro da riprodurre nell'altoparlante destro.
SoundTransform
  pan: Number
Il movimento panoramico del suono da sinistra a destra, compreso tra -1 (tutto a sinistra) e 1 (tutto a destra).
SoundTransform
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  rightToLeft: Number
Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input destro da riprodurre nell'altoparlante sinistro.
SoundTransform
  rightToRight: Number
Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input destro da riprodurre nell'altoparlante destro.
SoundTransform
  volume: Number
Il volume, compreso tra 0 (disattivato) e 1 (massimo volume).
SoundTransform
Metodi pubblici
 MetodoDefinito da
  
SoundTransform(vol:Number = 1, panning:Number = 0)
Crea un oggetto SoundTransform.
SoundTransform
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
leftToLeftproprietà
leftToLeft:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input sinistro da riprodurre nell'altoparlante sinistro.


Implementazione
    public function get leftToLeft():Number
    public function set leftToLeft(value:Number):void
leftToRightproprietà 
leftToRight:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input sinistro da riprodurre nell'altoparlante destro.


Implementazione
    public function get leftToRight():Number
    public function set leftToRight(value:Number):void
panproprietà 
pan:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il movimento panoramico del suono da sinistra a destra, compreso tra -1 (tutto a sinistra) e 1 (tutto a destra). Il valore 0 rappresenta l'assenza di panoramica (centro bilanciato fra destra e sinistra).


Implementazione
    public function get pan():Number
    public function set pan(value:Number):void
rightToLeftproprietà 
rightToLeft:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input destro da riprodurre nell'altoparlante sinistro.


Implementazione
    public function get rightToLeft():Number
    public function set rightToLeft(value:Number):void
rightToRightproprietà 
rightToRight:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore da 0 (nessuno) a 1 (tutto) che specifica la quantità dell'input destro da riprodurre nell'altoparlante destro.


Implementazione
    public function get rightToRight():Number
    public function set rightToRight(value:Number):void
volumeproprietà 
volume:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il volume, compreso tra 0 (disattivato) e 1 (massimo volume).


Implementazione
    public function get volume():Number
    public function set volume(value:Number):void
Descrizione della funzione di costruzione
SoundTransform()Funzione di costruzione
public function SoundTransform(vol:Number = 1, panning:Number = 0)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto SoundTransform.

Parametri
vol:Number (default = 1) — Il volume, compreso tra 0 (disattivato) e 1 (massimo volume).
 
panning:Number (default = 0) — Il movimento panoramico del suono da sinistra a destra, compreso tra -1 (tutto a sinistra) e 1 (tutto a destra). Il valore 0 rappresenta l'assenza di panoramica (suono centrale).

Esempio

Nell'esempio seguente l'audio viene riprodotto dal canale destro e il volume è impostato su 50%.

In the constructor, the sound is loaded and assigned to a sound channel (channel). Viene creato anche un oggetto SoundTranform (transform). Il primo argomento imposta il volume sul 50% (l'intervallo va da 0,0 a 1,0). Il secondo argomento imposta il movimento panoramico. Il movimento panoramico è impostato su 1,0, il che significa che il suono uscirà solo dall'altoparlante di destra. Per rendere operativa questa impostazione, l'oggetto SoundTranform transform viene assegnato alla proprietà souundTransform del canale audio. (La gestione degli errori scritta per questo esempio è limitata.)

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);
        }
    }
}
Esempi Come utilizzare gli esempi
SoundTransformExample.as

Nell'esempio seguente viene caricato e riprodotto un file MP3. Durante la riproduzione del file MP3, spostare il mouse; il volume e la panoramica cambiano mentre si sposta il mouse sullo stage. Per provare l'esempio, collocare un file di nome MySound.mp3 nella stessa directory del file SWF.
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);
            
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/media/SoundTransform.html