Microphone  - AS3

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 la propiedad muted del micrófono es true, el valor de esta propiedad siempre es -1.

Elementos de API relacionados

El códec utilizado para comprimir audio. Hay códecs disponibles de Nellymoser (predeterminado) y de Speex. La clase de enumeración SoundCodec contiene los distintos valores válidos para la propiedad codec.

Si utiliza el códec de Nellymoser, puede establecer la frecuencia de muestreo utilizando Microphone.rate(). Si se utiliza el códec de Speex, la frecuencia de muestreo se establece en 16 kHz.

Speex incluye detección de actividad de voz (VAD) y reduce automáticamente el ancho de banda cuando se detecta ninguna voz. Si se utiliza el códec de Speex, Adobe recomienda establecer el nivel de silencio en 0. Para definir el nivel de silencio, utilice el método Microphone.setSilenceLevel().

Elementos de API relacionados

Activa la detección de actividad de voz Speex.

La calidad de la voz codificada cuando se utiliza el códec Speex. Los valores posibles van de 0 a 10. El valor predeterminado es 6. Si se utiliza un número más elevado, la calidad será más alta, pero se necesitará una ancho de banda mayor, como se muestra en la siguiente tabla. Los valores de velocidad de transferencia enumerados representan las velocidades de transferencia netas y no incluyen la sobrecarga correspondiente a la creación de paquetes.

Elementos de API relacionados

Controla las opciones mejoradas de micrófono. Para obtener más información, consulte la clase MicrophoneEnhancedOptions. Esta propiedad se omitirá para instancias de Microphone no mejoradas.

Elementos de API relacionados

Número de fotogramas de voz de Speex transmitidos en un paquete (mensaje). Cada fotograma tiene una duración de 20 ms. El valor predeterminado es de dos fotogramas por paquete.

Cuando mayor sea el número de fotogramas Speex en un mensaje, menor será el ancho de banda requerido, aunque aumentará el retraso al enviar el mensaje. A menor número de fotogramas Speex, mayor será el ancho de banda requerido, pero se reducirá el retraso.

Cantidad que el micrófono aumenta la señal. Los valores válidos van de 0 a 100. El valor predeterminado es 50.

Elementos de API relacionados

El índice del micrófono, tal como se refleja en el conjunto devuelto por Microphone.names.

Elementos de API relacionados

La propiedad isSupported se establece en true si la clase Microphone se admite en la plataforma actual; en caso contrario, se establece en false.

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().

Elementos de API relacionados

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

Elementos de API relacionados

Un conjunto 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. Este conjunto 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 el conjunto. 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.

Elementos de API relacionados

Atenuación máxima del ruido en dB (número negativo) que se utiliza en el codificador Speex. Si está activado, se aplicar supresión de ruido al sonido capturado por el micrófono antes de la compresión de Speex. Establezca el valor en 0 para desactivar supresión de sonido. La supresión de ruido se activa de forma predeterminada con la máxima atenuación de -30 dB. Omitir si el códec de Nellymoser está seleccionado.

Determine si se le ha concedido a la aplicación el permiso para usar el micrófono.

Elementos de API relacionados

La frecuencia a la que el micrófono captura el sonido, expresada en kHz. Los valores aceptables son 5, 8, 11, 22 y 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.

Nota: la frecuencia real difiere ligeramente del valor de rate, como se indica en la siguiente tabla:

Elementos de API relacionados

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

Elementos de API relacionados

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().

Elementos de API relacionados

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.

Elementos de API relacionados

Devuelve una referencia a un objeto Microphone mejorado que puede realizar cancelación de eco acústico. Utilice cancelación de eco acústico para crear aplicaciones de chat de vídeo/audio que no requieren auriculares.

El parámetro index para el método Microphone.getEnhancedMicrophone() y Microphone.getMicrophone() funcionan de la misma manera.

Para utilizar este método en Android, agregue el permiso MODIFY_AUDIO_SETTINGS en la sección de los complementos del manifiesto de Android, en el descriptor de la aplicación.

Importante: en cada momento sólo se puede tener una instancia de dispositivo de micrófono mejorado. Todas las demás instancias de Microphone dejan de suministrar datos de audio y reciben un evento StatusEvent con la propiedad code Microphone.Unavailable. Cuando el audio mejorado falla al inicializar, las llamadas a este método devuelven null. Establecer un valor para Microphone.enhancedOptions no produce ningún efecto y todas las instancias de micrófono funcionan como antes.

Para configurar un objeto Microphone mejorado, establezca la propiedad Microphone.enhancedOptions. El siguiente código utiliza un objeto Microphone mejorado y cancelación de eco acústico full-duplex en una prueba local:

	     var mic:Microphone = Microphone.getEnhancedMicrophone();
	     var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions();
	     options.mode = MicrophoneEnhancedMode.FULL_DUPLEX;
	     mic.enhancedOptions = options;
	     mic.setLoopBack(true);
	 

El método setUseEchoSuppression() se omite cuando se utiliza cancelación de eco acústico.

Cuando un archivo SWF intenta acceder al objeto devuelto por Microphone.getEnhancedMicrophone(), 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; este es el tamaño mínimo que exige Flash Player para mostrar el cuadro de diálogo).

Parámetros

Elementos de API relacionados

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.getMicrophone() hacen referencia al mismo micrófono. Por consiguiente, si el código contiene las líneas mic1 = Microphone.getMicrophone() y mic2 = Microphone.getMicrophone(), tanto mic1 como mic2 harán referencia al mismo micrófono (predeterminado).

Por lo general, no se debe transferir un valor para index. Simplemente utilice el método air.Microphone.getMicrophone() para devolver una referencia al micrófono predeterminado. Desde la sección Configuración del micrófono del panel Configuración de Flash Player, el usuario puede especificar el micrófono predeterminado que debe utilizar la aplicación. (El usuario puede acceder al panel Configuración de Flash Player haciendo clic con el botón derecho en el contenido de Flash Player que se ejecuta en un navegador web.) Si transfiere un valor para index, puede hacer 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. El contenido ejecutado en Adobe AIR también utiliza la configuración de Flash Player para el micrófono predeterminado.

Utilice la propiedad Microphone.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.

Cuando un archivo SWF intenta acceder al objeto devuelto por Microphone.getMicrophone(), 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; este 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.getMicrophone() 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.getMicrophone(), utilice Security.showSettings().

Parámetros

Elementos de API relacionados

var mic:Microphone = Microphone.getMicrophone();
mic.setLoopBack();
mic.addEventListener(StatusEvent.STATUS, mic_status);
 
var tf:TextField = new TextField();
tf.autoSize = TextFieldAutoSize.LEFT;
tf.text = "Detecting microphone...";
addChild(tf);
 
function mic_status(evt:StatusEvent):void {
    tf.text = "Microphone is muted?: " + mic.muted;
    switch (evt.code) {
        case "Microphone.Unmuted":
            tf.appendText("\n" + "Microphone access was allowed.");
            break;
        case "Microphone.Muted":
            tf.appendText("\n" + "Microphone access was denied.");
            break;
    }
}

Solicita el acceso de micrófono para la aplicació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.

Speex incluye detección de actividad de voz (VAD) y reduce automáticamente el ancho de banda cuando se detecta ninguna voz. Si se utiliza el códec de Speex, Adobe recomienda establecer el nivel de silencio en 0.

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

Elementos de API relacionados

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 sistema. (Esto es diferente a la cancelación del eco acústico, que elimina completamente el acoplamiento.) El método setUseEchoSuppression( se omite al llamar al método getEnhancedMicrophone() para utilizar cancelación de eco acústico.)

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). 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

Elementos de API relacionados

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;

    public class MicrophoneExample extends Sprite {
        public function MicrophoneExample() {
            var mic:Microphone = Microphone.getMicrophone();
            Security.showSettings("2");
            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);
        }
    }
}