Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flash.media 

SoundTransform  - AS3

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La classe SoundTransform contiene proprietà relative al volume e alla panoramica.

Vedere gli esempi

Elementi API correlati



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
  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 di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
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à

leftToLeft

proprietà
leftToLeft:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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

leftToRight

proprietà 
leftToRight:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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

pan

proprietà 
pan:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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

rightToLeft

proprietà 
rightToLeft:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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

rightToRight

proprietà 
rightToRight:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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

volume

proprietà 
volume:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

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  ( Come utilizzare questo esempio )

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

Nella funzione di costruzione, l'audio viene caricato e assegnato a un canale audio (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. In questo esempio, il movimento panoramico è impostato su 1.0, a significare che l'audio proviene solo dall'altoparlante destro. Per rendere operativa queste impostazioni, l'oggetto SoundTranform transform viene assegnato alla proprietà souundTransform del canale audio.

Nota: 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);
        }
    }
}
SoundTransformExample.as

Nell'esempio seguente viene caricato e riprodotto un file MP3. Mentre il file MP3 viene riprodotto, spostate il mouse o un altro dispositivo di input dell'utente; il volume e la panoramica cambiano mentre si sposta il dispositivo di input dell'utente sullo stage. Per provare l'esempio, collocate 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;
            }

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

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




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.