Clase Sound

Disponibilidad

Flash Player 5.

Descripción

La clase Sound permite controlar el sonido de una película. Puede agregar sonidos a un clip de película desde la biblioteca mientras se reproduce la película y controlar estos sonidos. Si no especifica un destino al crear un nuevo objeto Sound, puede utilizar los métodos para controlar el sonido de toda la película.

Antes de llamar a los métodos de la clase Sound, debe utilizar el constructor new Sound para crear un objeto Sound.

Resumen de métodos para la clase Sound

Método	Descripción
`Sound.attachSound()`	Asocia el sonido especificado en el parámetro.
`Sound.getBytesLoaded()`	Devuelve el número de bytes cargados para el sonido especificado.
`Sound.getBytesTotal()`	Devuelve el tamaño del sonido en bytes.
`Sound.getPan()`	Devuelve el valor de la llamada `setPan()` anterior.
`Sound.getTransform()`	Devuelve el valor de la llamada `setTransform()` anterior.
`Sound.getVolume()`	Devuelve el valor de la llamada `setVolume()` anterior.
`Sound.loadSound()`	Carga un archivo MP3 en Flash Player.
`Sound.setPan()`	Establece el balance izquierda/derecha del sonido.
`Sound.setTransform()`	Establece el valor de cada canal, izquierdo y derecho, que debe reproducirse en cada altavoz.
`Sound.setVolume()`	Establece el nivel de volumen de un sonido.
`Sound.start()`	Comienza a reproducir un sonido desde el principio u opcionalmente desde un punto de desplazamiento establecido en el parámetro.
`Sound.stop()`	Detiene el sonido especificado o todos los sonidos que se están reproduciendo actualmente.

Resumen de propiedades para la clase Sound

Propiedad	Descripción
`Sound.duration`	Duración de un sonido, expresada en milisegundos.
`Sound.ID3`	Proporciona acceso a los metadatos que forman parte de un archivo MP3.
`Sound.position`	Número de milisegundos durante los que se ha reproducido el sonido.

Resumen de controladores de eventos para la clase Sound

Controlador de eventos	Descripción
`Sound.onID3`	Se invoca cada vez que existen nuevos datos ID3 disponibles.
`Sound.onLoad`	Se invoca cuando se carga un sonido.
`Sound.onSoundComplete`	Se invoca cuando se detiene la reproducción de un sonido.

Constructor para la clase Sound

Disponibilidad

Flash Player 5.

Sintaxis

new Sound([target])

Parámetros

target Instancia de clip de película en la que opera el objeto Sound. Este parámetro es opcional.

Valor devuelto

Ninguno.

Descripción

Constructor; crea un nuevo objeto Sound para un clip de película especificado. Si no se especifica una instancia de destino, el objeto Sound controla todos los sonidos de la película.

Ejemplo

En el ejemplo siguiente se crea un nuevo objeto Sound denominado global_sound. La segunda línea llama al método setVolume() y ajusta el volumen de todos los sonidos de la película a un 50%.

global_sound = new Sound();
global_sound.setVolume(50);

En el ejemplo siguiente se crea un nuevo objeto Sound, se le pasa el clip de película de destino my_mc y se llama al método start, que inicia cualquier sonido en my_mc.

movie_sound = new Sound(my_mc);
movie_sound.start();