Paqueteflash.media
Clasepublic final class SoundTransform
HerenciaSoundTransform Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase SoundTransform contiene propiedades de volumen y desplazamiento lateral. Los siguientes objetos contienen una propiedad soundTransform cuyo valor es un objeto SoundTransform: Microphone, NetStream, SimpleButton, SoundChannel, SoundMixer o Sprite.

Ver los ejemplos



Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  leftToLeft : Number
Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la izquierda se reproducen en el altavoz izquierdo.
SoundTransform
  leftToRight : Number
Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la izquierda se reproducen en el altavoz derecho.
SoundTransform
  pan : Number
El desplazamiento lateral del sonido, de izquierda a derecha, con valores comprendidos entre -1 (desplazamiento lateral total hacia la izquierda) y 1 (desplazamiento lateral total hacia la derecha).
SoundTransform
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  rightToLeft : Number
Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la derecha se reproducen en el altavoz izquierdo.
SoundTransform
  rightToRight : Number
Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la derecha se reproducen en el altavoz derecho.
SoundTransform
  volume : Number
El volumen, con valores comprendidos entre 0 (silencio) y 1 (máximo volumen).
SoundTransform
Métodos públicos
 MétodoDefinido por
  
SoundTransform(vol:Number = 1, panning:Number = 0)
Crea un objeto SoundTransform.
SoundTransform
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
leftToLeftpropiedad
leftToLeft:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la izquierda se reproducen en el altavoz izquierdo.


Implementación
    public function get leftToLeft():Number
    public function set leftToLeft(value:Number):void
leftToRightpropiedad 
leftToRight:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la izquierda se reproducen en el altavoz derecho.


Implementación
    public function get leftToRight():Number
    public function set leftToRight(value:Number):void
panpropiedad 
pan:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El desplazamiento lateral del sonido, de izquierda a derecha, con valores comprendidos entre -1 (desplazamiento lateral total hacia la izquierda) y 1 (desplazamiento lateral total hacia la derecha). Un valor de 0 indica que no hay desplazamiento lateral (existe equilibrio entre la derecha y la izquierda).


Implementación
    public function get pan():Number
    public function set pan(value:Number):void
rightToLeftpropiedad 
rightToLeft:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la derecha se reproducen en el altavoz izquierdo.


Implementación
    public function get rightToLeft():Number
    public function set rightToLeft(value:Number):void
rightToRightpropiedad 
rightToRight:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor, entre 0 (ninguno) y 1 (todo), que especifica qué cantidad de datos de la derecha se reproducen en el altavoz derecho.


Implementación
    public function get rightToRight():Number
    public function set rightToRight(value:Number):void
volumepropiedad 
volume:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El volumen, con valores comprendidos entre 0 (silencio) y 1 (máximo volumen).


Implementación
    public function get volume():Number
    public function set volume(value:Number):void
Información sobre constructores
SoundTransform()constructor
public function SoundTransform(vol:Number = 1, panning:Number = 0)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto SoundTransform.

Parámetros
vol:Number (default = 1) — El volumen, con valores comprendidos entre 0 (silencio) y 1 (máximo volumen).
 
panning:Number (default = 0) — El desplazamiento lateral del sonido, de izquierda a derecha, con valores comprendidos entre -1 (desplazamiento lateral total hacia la izquierda) y 1 (desplazamiento lateral total hacia la derecha). Un valor de 0 indica que no hay desplazamiento lateral (centro).

Ejemplo

En el ejemplo siguiente, el sonido sólo se reproducirá desde el canal derecho y el volumen está definido en 50 por ciento.

En el constructor, se carga el sonido y se asigna a un canal de sonido (channel). También se crea un objeto SoundTranform (transform). Su primer argumento establece el volumen en el 50 por ciento (el rango está entre 0.0 y 1.0). Su segundo argumento establece el desplazamiento lateral. En este caso, el desplazamiento lateral se establece en 1.0, lo que significa que el sonido sólo vendrá del altavoz derecho. Para que esta configuración tenga efecto, se asigna el objeto transform SoundTranform a la propiedad souundTransform del canal de sonido. (Hay una gestión de errores limitada escrita para este ejemplo.)

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);
        }
    }
}
Ejemplos Cómo utilizar los ejemplos
SoundTransformExample.as

En el ejemplo siguiente, se carga y reproduce un archivo MP3. Durante la reproducción del archivo MP3, mueva el ratón; el volumen y el desplazamiento cambiarán a medida que lo mueva por el escenario. Para ejecutar el ejemplo, coloque un archivo llamado MySound.mp3 en el mismo directorio que el archivo 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);

        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/media/SoundTransform.html