La cantidad de sonido detectada por el micrófono. El rango de valores válidos es de 0 (no se detecta sonido) a 100 (se detecta un sonido alto). El valor de esta propiedad permite determinar un valor adecuado para el método Microphone.setSilenceLevel().

Si el micrófono está disponible pero no se está utilizando todavía porque no se ha llamado a Microphone.getMicrophone(), esta propiedad se establece con el valor -1.

Véase también

La ganancia del micrófono (es decir, el valor por el que el micrófono debe multiplicar la señal antes de transmitirla). El valor 0 indica a Flash Player que multiplique por 0, lo que hace que el micrófono no transmita ningún sonido.

Esta configuración puede concebirse como el control de volumen de un equipo de música: 0 significa que no hay volumen y 50 representa un volumen normal. Los números por debajo de 50 indican un volumen más bajo de lo normal, mientras que los números por encima de 50 especifican un volumen más alto de lo normal. Los valores válidos están entre 0 y 100, y 50 es el valor predeterminado. El usuario también puede cambiar este valor en el panel de configuración del micrófono de Flash Player.

Véase también

El índice del micrófono, tal como se refleja en la matriz devuelta por Microphone.names.

Véase también

Especifica si el usuario ha denegado el acceso al micrófono (true) o lo ha autorizado (false). Cuando cambia este valor, se distribuye un evento status. Para más información, consulte Microphone.getMicrophone().

Véase también

El nombre del dispositivo de captura de sonido, tal y como lo ha devuelto el hardware de captura de sonido.

Véase también

Una matriz de cadenas que incluye los nombres de todos los dispositivos de captura de sonido disponibles. Los nombres se devuelven sin necesidad de mostrar al usuario el panel Configuración de privacidad de Flash Player. Esta matriz proporciona el índice basado en cero de cada dispositivo de captura de sonido y el número de dispositivos de captura de sonido del sistema; lo hace gracias a la propiedad Microphone.names.length. Para más información, consulte la entrada de la clase Array.

La llamada a Microphone.names exige un examen amplio del hardware y puede tardar varios segundos en crear la matriz. En la mayoría de los casos, podrá utilizar simplemente el micrófono predeterminado.

Nota: para determinar el nombre del micrófono actual, utilice la propiedad name.

Véase también

La frecuencia a la que el micrófono captura el sonido, expresada en kHz. Los valores permitidos son todos los que admita su dispositivo de sonido: 5, 8, 11, 22 o 44.

El valor predeterminado es 8 kHz si su dispositivo de captura de sonido admite este valor. En caso contrario, el valor predeterminado será el siguiente nivel de captura disponible por encima de 8 kHz que admita su dispositivo de captura de sonido, generalmente 11 kHz.

La cantidad de sonido necesaria para activar el micrófono y distribuir el evento activity. El valor predeterminado es 10.

Véase también

Número de milisegundos que transcurren entre el momento en que el micrófono deja de detectar sonido y la distribución del evento activity. El valor predeterminado es 2000 (2 segundos).

Para definir este valor, utilice el método Microphone.setSilenceLevel().

Véase también

Controla el sonido de este objeto de micrófono cuando se encuentra en modo de bucle.

Se establece en true si está activada la supresión de eco; en caso contrario, devuelve false. El valor predeterminado es false a no ser que el usuario haya seleccionado la reducción de eco en el panel Configuración del micrófono de Flash Player.

Véase también

Devuelve una referencia a un objeto Microphone para capturar sonido. Para comenzar a capturar audio, debe asociar el objeto Microphone a un objeto NetStream (consulte NetStream.attachAudio().

Varias llamadas a Microphone.get() hacen referencia al mismo micrófono. Por consiguiente, si el código contiene las líneas mic1 = Microphone.get() y mic2 = Microphone.get(), tanto mic1 como mic2 harán referencia al mismo micrófono (predeterminado).

Utilice la propiedad index para obtener el valor de índice del objeto Microphone actual. A continuación, puede transmitir este valor a los demás métodos de la clase Microphone.

Por lo general, no se debe transferir un valor para index. Simplemente utilice el método Microphone.get() para devolver una referencia al micrófono predeterminado. Mediante el panel de configuración del micrófono, el usuario puede especificar el micrófono predeterminado que debe utilizar Flash Player. Si transfiere un valor para index, es posible que esté haciendo referencia a un micrófono que no es el mismo que elige el usuario. Puede utilizar index en casos poco frecuentes, por ejemplo, si la aplicación está capturando audio de dos micrófonos a la vez.

Cuando un archivo SWF intenta acceder al objeto devuelto por Microphone.get(), por ejemplo, al llamar a NetStream.attachAudio(), Flash Player muestra un cuadro de diálogo Privacidad que permite al usuario autorizar o denegar el acceso al micrófono. (Asegúrese de que el tamaño del escenario sea de al menos 215 x 138 píxeles; éste es el tamaño mínimo que exige Flash Player para mostrar el cuadro de diálogo.)

Cuando el usuario responde a este cuadro de diálogo, se distribuye un evento status que indica la respuesta del usuario. También puede comprobar la propiedad Microphone.muted para determinar si el usuario ha permitido o denegado el acceso al micrófono.

Si Microphone.get() devuelve el valor null, ello indicará que otra aplicación utiliza el micrófono o que no hay micrófonos instalados en el sistema. Para comprobar si hay micrófonos instalados, utilice Microphones.names.length. Para ver el panel de configuración del micrófono de Flash Player, en el que el usuario puede elegir el micrófono al que hará referencia Microphone.get(), utilice Security.showSettings().

Parámetros

Véase también

Dirige el audio capturado por un micrófono a los altavoces locales.

Parámetros

Establece el nivel mínimo de la entrada que debe considerarse como sonido y (opcionalmente) el tiempo de silencio que indica que efectivamente ha comenzado el silencio.

• Para impedir que el micrófono detecte sonido, transfiera un valor de 100 para silenceLevel; el evento activity nunca se distribuirá.
• Para determinar la cantidad de sonido que está detectando actualmente el micrófono, utilice Microphone.activityLevel.

La detección de actividad es la capacidad de detectar cuándo los niveles de audio sugieren que una persona está hablando. Cuando no hay nadie hablando, puede ahorrarse ancho de banda porque no es necesario enviar el flujo de audio asociado. Esta información también se utiliza como información para que los usuarios sepan que ellos (u otras personas) están en silencio.

Los valores de silencio se corresponden directamente con los valores de actividad. El silencio total tiene un valor de actividad 0. El ruido alto y constante (el máximo que puede registrarse con la configuración de ganancia actual) tiene un valor de actividad 100. Una vez ajustada adecuadamente la ganancia, el valor de actividad es inferior al valor de silencio cuando no está hablando; cuando está hablando, el valor de actividad supera el valor de silencio.

Este método es similar a Camera.setMotionLevel(); ambos métodos se utilizan para especificar cuándo debe distribuirse el evento activity. No obstante, estos métodos tienen efectos muy distintos en la publicación de flujos:

• Camera.setMotionLevel() está diseñado para detectar movimiento y no afecta al uso del ancho de banda. Aunque un flujo de vídeo no detecte movimiento, el vídeo continúa enviándose.
• Microphone.setSilenceLevel() está diseñado para optimizar el ancho de banda. Cuando se considera que un flujo de audio está en silencio, no se envían datos de audio. Por el contrario, se envía un único mensaje que indica que el silencio ha comenzado.

Parámetros

Véase también

Especifica si debe utilizarse la función de supresión de eco del códec de audio. El valor predeterminado es false a no ser que el usuario haya seleccionado la reducción de eco en el panel Configuración del micrófono de Flash Player.

La supresión del eco es un intento de reducción de los efectos del acoplamiento acústico, que tiene lugar cuando el sonido que sale del altavoz es detectado por el micrófono del mismo equipo. (Esto es diferente a la cancelación del eco, que elimina completamente el acoplamiento.)

Por lo general, la supresión del eco es aconsejable cuando el sonido que se está capturando se reproduce a través de los altavoces (en lugar de a través de auriculares) del mismo equipo. Si el archivo SWF permite a los usuarios especificar el dispositivo de salida del sonido, puede que resulte conveniente llamar a Microphone.setUseEchoSuppression(true) si éstos indican que están utilizando altavoces y van a utilizar también el micrófono.

Los usuarios también pueden ajustar estos parámetros en el panel de configuración del micrófono de Flash Player.

Parámetros

Véase también

Se distribuye cuando un micrófono inicia o finaliza una sesión.

Para especificar la cantidad de sonido necesaria para activar este evento con una propiedad activating de true, o la cantidad de tiempo que debe transcurrir sin que el sonido active este evento con una propiedad activating de false, utilice Microphone.setSilenceLevel().

Este evento tiene las propiedades siguientes:

Véase también

Se distribuye cuando un micrófono informa sobre su estado. Si el valor de la propiedad code es "Microphone.Muted", el usuario ha denegado el acceso del archivo SWF al micrófono. Si el valor de la propiedad code es "Microphone.Unmuted", el usuario ha permitido el acceso del archivo SWF al micrófono.

Este evento tiene las propiedades siguientes:

Véase también

Dos detectores detectan eventos activity y status. El evento activity se distribuye al principio y al final (si procede) de la sesión y se captura con el método activityHandler(), que controla la información en el evento. El evento status se distribuye si el objeto Microphone asociado revela información de estado; se captura y se controla con el método statusHandler().

Nota: debe tener un micrófono conectado al ordenador para que este ejemplo funcione correctamente.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Microphone;
    import flash.system.Security;
    import flash.system.SecurityPanel;

    public class MicrophoneExample extends Sprite {
        public function MicrophoneExample() {
            var mic:Microphone = Microphone.getMicrophone();
            Security.showSettings(SecurityPanel.MICROPHONE);
            mic.setLoopBack(true);

            if (mic != null) {
                mic.setUseEchoSuppression(true);
                mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                mic.addEventListener(StatusEvent.STATUS, statusHandler);
            }
        }

        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }

        private function statusHandler(event:StatusEvent):void {
            trace("statusHandler: " + event);
        }
    }
}