Microphone  - AS3

A quantidade de som que o microfone está detectando. Os valores variam de 0 (não é detectado som) a 100 (é detectado um som muito alto). O valor dessa propriedade pode ajudá-lo a determinar um bom valor para transmitir para o método Microphone.setSilenceLevel().

Se a propriedade de microfone mute for true, o valor dessa propriedade será sempre -1.

Elementos da API relacionados

O codec a ser usado para compactar o áudio. Os codecs disponíveis são Nellymoser (o padrão) e Speex. A classe de enumeração SoundCodec contém os vários valores que são válidos para a propriedade codec.

Se você usar o codec Nellymoser, poderá estabelecer a utilização de taxa de amostra Microphone.rate(). Se você usar o codec Speex, a taxa de amostra será definida como 16 kHz.

Speex inclui a detecção de atividade de voz (VAD) e automaticamente reduz a largura de banda quando nenhuma voz é descoberta. Ao usar o codec Speex, a Adobe recomenda que você estabeleça o nível de silêncio como 0. Para definir o nível de silêncio, use o método Microphone.setSilenceLevel().

Elementos da API relacionados

Habilitar a detecção de atividade de voz Speex.

A qualidade de fala codificada ao usar o codec Speex. Os possíveis valores são de 0 a 10. O valor padrão é 6. Números maiores representam maior qualidade, mas requerem mais largura de banda, como mostra a tabela a seguir. Os valores de taxa de bits relacionados representam as taxas de bits líquidas e não incluem sobrecarga de empacotamento.

Elementos da API relacionados

Controla as opções do microfone avançado. Para obter mais informações, consulte a classe MicrophoneEnhancedOptions. Esta propriedade é ignorada para instâncias de Microfone não realçadas.

Elementos da API relacionados

Número de quadros de fala Speex transmitidos em um pacote (mensagem). Cada quadro tem 20 ms. O valor padrão são dois quadros por pacote.

Quanto mais quadros de Speex houver em uma mensagem, menor será a largura de banda exigida e maior será a demora no envio da mensagem. Quanto menos quadros de Speex houver, maior será a largura de banda exigida, mas reduzirá a demora.

O valor pelo qual o microfone emite o sinal. Os valores válidos são 0 a 100. O valor padrão é 50.

Elementos da API relacionados

O índice do microfone, refletido na matriz retornada por Microphone.names.

Elementos da API relacionados

A propriedade isSupported será definida como true se a classe Camera for suportada na plataforma atual; de outra maneira, ela será definida como false.

Especifica se o usuário tem acesso negado ao microfone (true) ou acesso permitido (false). Quando esse valor for alterado, é despachado um evento status. Para obter mais informações, consulte Microphone.getMicrophone().

Elementos da API relacionados

O nome do dispositivo atual de captura de som, retornado pelo hardware de captura de som.

Elementos da API relacionados

Uma matriz de strings contendo os nomes de todos os dispositivos de captura de som disponíveis. Os nomes são retornados sem precisar exibir o painel Configurações de Privacidade do Flash Player ao usuário. Essa matriz fornece o índice baseado em zero de cada dispositivo de captura de som e o número de dispositivos no sistema, através da propriedade Microphone.names.length. Para obter mais informações, consulte a entrada da classe Array.

A chamada a Microphone.names exige um exame extensivo do hardware, e pode levar vários segundos para construir a matriz. Na maioria dos casos, você pode apenas usar o microfone padrão.

Observação: para determinar o nome do microfone atual, use a propriedade name.

Elementos da API relacionados

A atenuação máxima do ruído em dB (número negativo) usada para o codificador Speex. Se ativada, a supressão de barulho será aplicada ao som capturado do Microfone antes da compactação de Speex. Define como 0 para inutilizar a supressão de barulho. A supressão de barulho é ativada por padrão com a atenuação máxima de -30 dB. Ignorado quando o codec Nellymoser for selecionado.

Determina se o aplicativo recebeu permissão para acessar o microfone.

Elementos da API relacionados

A taxa na qual o microfone captura som, em kHz. Os valores aceitáveis são 5, 8, 11, 22 e 44. O valor padrão é 8 kHz se o seu dispositivo de captura de som oferece esse valor. Do contrário, o valor padrão é o próximo nível de captura disponível acima de 8 kHz que o seu dispositivo de captura de som suporta, em geral 11 kHz.

Observação: A taxa real diferencia-se ligeiramente do valor taxa, como observado na seguinte tabela:

Elementos da API relacionados

A quantidade de som necessária para ativar o microfone e despachar o evento activity. O valor padrão é 10.

Elementos da API relacionados

O número de milésimos de segundo entre o momento em que o microfone para de detectar o som e o momento em que o evento activity é despachado. O valor padrão é de 2000 (2 segundos).

Para configurar esse valor, use o método Microphone.setSilenceLevel().

Elementos da API relacionados

Controla o som deste objeto de microfone quando no modo de loopback.

Defina como true se a supressão de eco estiver ativada; caso contrário, defina como false. O valor padrão é false, a menos que o usuário tenho selecionado Reduzir eco no painel de Configurações do Microsoft do Flash Player.

Elementos da API relacionados

Retorna uma referência a um objeto Microphone aprimorado que pode executar o cancelamento do eco acústico. Use o cancelamento do eco acústico para criar aplicativos de bate-papo de áudio/vídeo que não requeiram fones de ouvido.

O parâmetro index do método Microphone.getEnhancedMicrophone() e o método Microphone.getMicrophone() funcionam da mesma maneira.

Para usar esse método no Android, adicione a permissão MODIFY_AUDIO_SETTINGS de MODIFY_AUDIO_SETTINGS nas adições de manifesto do descritor do aplicativo.

Importante: A qualquer momento você pode ter dispositivo de microfone realçado de só uma ocorrência de única. Todas as outras ocorrências de Microphone deixarão de fornecer dados de áudio e receberão um StatusEvent com a propriedade code Microphone.Unavailable. Quando o áudio realçado falha inicializar, chamadas a deste retorno de método null, configuração de um valor para Microphone.enhancedOptions não tem nenhum efeito, e toda a função de instâncias de Microfone existente como antes.

Para configurar um objeto de Microfone realçado, estabeleça o Microphone.enhancedOptions propriedade. O seguinte código usa um objeto de Microfone realçado e cancelamento do eco acústico cheio e dúplex em um teste local:

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

O método setUseEchoSuppression() é ignorado quando o cancelamento do eco acústico é usado.

Quando um arquivo SWF tenta acessar o objeto retornado por Microphone.getEnhancedMicrophone() – por exemplo, ao chamar NetStream.attachAudio() – o Flash Player exibe uma caixa de diálogo Privacidade que permite que o usuário escolha entre permitir ou negar acesso ao microfone. (O tamanho do Palco tem, pelo menos, 215 x 138 pixels; este é o tamanho mínimo que o Flash Player exige para que a caixa de diálogo seja exibida.)

Parâmetros

Elementos da API relacionados

Retorna uma referência a um objeto Microphone para captura de áudio. Para iniciar a captura do áudio, você deve acoplar o objeto Microphone a um objeto NetStream (consulte NetStream.attachAudio()).

Chamadas múltiplas a Microphone.getMicrophone() fazem referência ao mesmo microfone. Se o seu código contiver as linhas mic1 = Microphone.getMicrophone() e mic2 = Microphone.getMicrophone(), tanto mic1 quanto mic2 farão referência ao mesmo microfone (padrão).

Em geral, você não deve um valor para index. Basta chamar air.Microphone.getMicrophone() para retornar uma referência ao microfone padrão. Ao usar a seção de Configurações de Microfone no painel de configurações do Flash Player, o usuário pode especificar o microfone padrão que o aplicativo deve usar. (O usuário acessa o painel de configurações de Flash Player clicando com o botão direito do mouse no conteúdo do Flash Playerexecutado em um navegador da web.) Se você passar um valor para index, pode fazer referência a um microfone diferente daquele que o usuário escolher. Você pode usar index em casos raros – por exemplo, se o seu aplicativo estiver capturando áudio de dois microfones ao mesmo tempo. O conteúdo executado no Adobe AIR também usa a configuração do Flash Player para o microfone padrão.

Use a propriedade Microphone.index para obter o valor de índice do objeto Microphone atual. Você pode passar esse valor para outros métodos da classe Microphone.

Quando um arquivo SWF tenta acessar o objeto retornado por Microphone.getMicrophone() – por exemplo, ao chamar NetStream.attachAudio() – o Flash Player exibe uma caixa de diálogo Privacidade que permite que o usuário escolha entre permitir ou negar acesso ao microfone. (O tamanho do Palco tem, pelo menos, 215 x 138 pixels; este é o tamanho mínimo que o Flash Player exige para que a caixa de diálogo seja exibida.)

Quando o usuário responder a esta caixa de diálogo, é despachado um evento status que indica a resposta do usuário. Você também pode verificar a propriedade Microphone.muted para determinar se o usuário permitiu ou negou acesso ao microfone.

Se Microphone.getMicrophone() retornar null, o microfone está sendo usado por outro aplicativo, ou não há microfones instalados no sistema. Para determinar se há microfones instalados, use Microphones.names.length. Para exibir o painel Configurações do Microfone do Flash Player, que permite que o usuário escolha o microfone ao qual Microphone.getMicrophone faz referência, use Security.showSettings().

Parâmetros

Elementos da 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 a permissão do microfone para o aplicativo.

Direciona o áudio capturado por um microfone até os alto-falantes locais.

Parâmetros

Define o nível de entrada mínimo que deve ser considerado como som e (opcionalmente) o período de tempo em silêncio, significando que o silêncio realmente começou.

• Para impedir que o microfone detecte qualquer tipo de som, transmita o valor de 100 para silenceLevel; o evento activity nunca é despachado.
• Para determinar a quantidade de som que o microfone está detectando no momento, use a propriedade Microphone.activityLevel.

Speex inclui a detecção de atividade de voz (VAD) e automaticamente reduz a largura de banda quando nenhuma voz é descoberta. Ao usar o codec Speex, a Adobe recomenda que você estabeleça o nível de silêncio como 0.

A detecção de atividade é a capacidade de detectar quando os níveis de áudio sugerem que há uma pessoa falando. Quando não há ninguém falando, a largura de banda pode ser salva, já que não há necessidade de enviar o fluxo de áudio associado. Essas informações também podem ser usadas para obter um feedback visual de forma que os usuários saibam que eles (ou outras pessoas) estão em silêncio.

Os valores de silêncio correspondem diretamente aos valores de atividade. O silêncio completo é um valor de atividade 0. O ruído alto constante (tão altos quanto pode ser registrado com base na configuração atual de ganho) é um valor de atividade 100. Depois que o ganho é adequadamente ajustado, o valor da sua atividade é menor do que o valor de silêncio quando você não está falando; quando você está falando, o valor da atividade excede o valor de silêncio.

Esse método é semelhante ao Camera.setMotionLevel(); os dois são usados para especificar quando o evento activity for despachado. No entanto, esses métodos têm um impacto significativamente diferente nos fluxos de publicação:

• Camera.setMotionLevel() foi projetado para detectar movimento e não afeta a utilização da largura de banda. Mesmo que um fluxo de vídeo não detecte movimento, o vídeo ainda é enviado.
• Microphone.setSilenceLevel() foi projetado para otimizar a largura de banda. Quando um fluxo de áudio é considerado silencioso, não são enviados dados de áudio. Em vez disso, é enviada uma única mensagem, indicando que o silêncio iniciou.

Parâmetros

Elementos da API relacionados

Especifica se o recurso de supressão de eco do codec de áudio deve ou não ser usado. O valor padrão é false, a menos que o usuário tenho selecionado Reduzir eco no painel de Configurações do Microsoft do Flash Player.

A supressão de eco é um esforço para reduzir os efeitos do feedback de áudio, que é causado quando o som que sai do alto-falante é selecionado pelo microfone no mesmo sistema. (É diferente do cancelamento do eco acústico, que remove completamente o retorno. O método setUseEchoSuppression() é ignorado quando você chama o método getEnhancedMicrophone() para usar o cancelamento do eco acústico.)

Em geral, a supressão do eco é aconselhável quando o som que está sendo capturado é reproduzido pelos alto-falantes – em vez de um fone –. Se o arquivo SWF permite que os usuários especifiquem o dispositivo de saída do som, talvez você queira chamar Microphone.setUseEchoSuppression(true) se indicarem que estão usando alto-falantes e também vão usar o microfone.

Os usuários também podem ajustar essas configurações no painel Configurações do Microsoft do Flash Player.

Parâmetros

Elementos da API relacionados

Dois ouvintes ouvem os eventos activity e status. O evento activity foi despachado no início e no final (se houver) da sessão e foi capturado pelo método activityHandler(), que controla as informações sobre o evento. O evento status é despachado se o objeto Microphone anexado informa quaisquer informações de status; ele é capturado e controlado com o método statusHandler().

Observação: é necessário acoplar um microfone ao seu computador para que este exemplo funcione corretamente.

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);
        }
    }
}