Microphone  - AS3

La quantità di suono rilevata dal microfono. I valori accettabili sono compresi tra 0 (non viene rilevato alcun suono) e 100 (viene rilevato un suono molto forte). Il valore di questa proprietà può contribuire a determinare un valore appropriato per il metodo Microphone.setSilenceLevel().

Se la proprietà muted del microfono è true, il valore di questa proprietà è sempre -1.

Elementi API correlati

Il codec da utilizzare per la compressione audio. I codec disponibili sono Nellymoser (predefinito) e Speex. La classe di enumerazione SoundCodec contiene i diversi valori validi per la proprietà codec.

Se usate il codec Nellymoser, potete impostare la frequenza di campionamento utilizzando Microphone.rate(). Se usate il codec Speex, la frequenza di campionamento è impostata a 16 kHz.

Speex include il rilevamento dell'attività vocale (VAD) e riduce automaticamente la larghezza di banda quando non viene rilevata alcuna voce. Se usate il codec Speex, Adobe consiglia di impostare il livello di silenzio su 0. Per impostare il livello di silenzio, utilizzate il metodo Microphone.setSilenceLevel().

Elementi API correlati

Attiva il rilevamento dell'attività vocale Speex.

La qualità della voce codificata quando si utilizza il codec Speex. I valori possibili sono quelli compresi tra 0 e 10. Il valore predefinito è 6. I numeri più elevati rappresentano una migliore qualità, ma richiedono maggiore larghezza di banda, come illustrato nella seguente tabella. I valori relativi alla velocità di trasmissione elencati rappresentano la pura velocità e non includono il carico relativo alla pacchettizzazione.

Elementi API correlati

Controlla le opzioni di microfono ottimizzato. Per ulteriori informazioni, vedete la classe MicrophoneEnhancedOptions. Questa proprietà viene ignorata per le istanze Microphone non di tipo avanzato.

Elementi API correlati

Numero di fotogrammi audio Speex trasmessi in un pacchetto (messaggio). Ogni frame è lungo 20 ms. Il valore predefinito è due frame per pacchetto.

Più fotogrammi Speex sono presenti in un messaggio, meno larghezza di banda è necessaria, anche se aumenta il ritardo nell'invio del messaggio. Meno fotogrammi Speex comportano un aumento della larghezza di banda necessaria, ma riducono il ritardo.

L'entità del potenziamento del segnale eseguito dal microfono. I valori validi sono compresi tra 0 e 100. Il valore predefinito è 50.

Elementi API correlati

L'indice del microfono, rispecchiato nell'array restituito da Microphone.names.

Elementi API correlati

La proprietà isSupported è impostata su true se la classe Microphone è supportata nella piattaforma corrente, altrimenti è impostata su false.

Specifica se l'utente ha negato (true) o consentito (false) l'accesso al microfono. Quando questo valore cambia viene inviato un evento status. Per ulteriori informazioni, vedete Microphone.getMicrophone().

Elementi API correlati

Il nome del dispositivo di cattura audio corrente, restituito dall'hardware di cattura audio.

Elementi API correlati

Serie di stringhe contenente i nomi di tutti i dispositivi di cattura audio disponibili. I nomi vengono restituiti senza che sia necessario visualizzare il pannello delle impostazioni della privacy di Flash Player. Questo array fornisce l'indice a base zero di ogni dispositivo di cattura audio e il numero dei dispositivi di questo tipo presenti nel sistema tramite la proprietà Microphone.names.length. Per ulteriori informazioni, vedete la voce relativa alla classe Array.

Una chiamata alla proprietà Microphone.names richiede un esame esteso dell'hardware e la creazione dell'array può richiedere diversi secondi. Nella maggior parte dei casi è possibile utilizzare semplicemente il microfono predefinito.

Nota: per determinare il nome del microfono corrente, utilizzate la proprietà name.

Elementi API correlati

Attenuazione massima del rumore in dB (numero negativo) utilizzata per l'encoder Speex. Se attivata, la soppressione del rumore viene applicata all'audio acquisito da Microphone prima della compressione Speex. Impostate questo valore su 0 per disattivare la soppressione del rumore. La soppressione del rumore è attivata per impostazione predefinita con un'attenuazione massima di -30 dB. Ignorata quando è selezionato il codec Nellymoser.

Consente di determinare se l’applicazione ha ottenuto l’autorizzazione per l’uso del microfono.

Elementi API correlati

Frequenza con cui il microfono cattura l’audio, espressa in kHz. I valori accettabili sono 5, 8, 11, 22 e 44. Il valore predefinito è 8 kHz, se supportato dal dispositivo di cattura audio in uso. In caso contrario, il valore predefinito è il primo livello di cattura disponibile sopra 8 kHz supportato dal dispositivo di cattura audio (di solito 11 kHz).

Nota: la frequenza effettiva è leggermente diversa dal valore rate, come riportato nella tabella seguente:

Elementi API correlati

La quantità di suono necessaria per attivare il microfono e inviare l'evento activity. Il valore predefinito è 10.

Elementi API correlati

Il numero di millisecondi che trascorrono tra il momento in cui il microfono interrompe il rilevamento del suono e quello in cui viene inviato l'evento activity. Il valore predefinito è 2000 (2 secondi).

Per impostare questo valore, utilizzate il metodo Microphone.setSilenceLevel().

Elementi API correlati

Controlla l'audio dell'oggetto Microphone quando questo è in modalità loopback.

Se la soppressione dell'eco è attivata, restituisce true, altrimenti restituisce false. Il valore predefinito è false a meno che l'utente non abbia selezionato Riduci eco nel pannello delle impostazioni del microfono di Flash Player.

Elementi API correlati

Restituisce un riferimento a un oggetto Microphone avanzato che è in grado di eseguire la soppressione dell'eco acustica. Utilizzate la soppressione dell'eco acustica per creare applicazioni chat audio/video che non necessitano di cuffie.

Il parametro index del metodo Microphone.getEnhancedMicrophone() e del metodo Microphone.getMicrophone() funziona nello stesso modo.

Per utilizzare questo metodo su Android, aggiungete l'autorizzazione MODIFY_AUDIO_SETTINGS sotto le aggiunte manifest di Android nel descrittore dell'applicazione.

Importante: in qualunque momento è possibile avere una sola istanza di dispositivo microfono avanzato. Tutte le altre istanze Microphone cessano di fornire dati audio e ricevono uno StatusEvent con la proprietà code Microphone.Unavailable. Quando l'audio avanzato non viene inizializzato, le chiamate a questo metodo restituiscono null, l'impostazione di un valore per Microphone.enhancedOptions non ha effetto e tutte le istanze Microphone esistenti funzionano come prima.

Per configurare un oggetto Microphone avanzato, impostate la proprietà Microphone.enhancedOptions. Il codice seguente utilizza un oggetto Microphone avanzato e la soppressione dell'eco acustica full-duplex in un test locale:

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

Il metodo setUseEchoSuppression() viene ignorato quando si usa la soppressione dell'eco acustica.

Quando un file SWF tenta di accedere all'oggetto restituito da Microphone.getEnhancedMicrophone(), ad esempio quando chiamate NetStream.attachAudio(), viene visualizzata una finestra di dialogo relativa alla privacy che consente all'utente di scegliere se consentire o negare l'accesso al microfono. (Assicuratevi che le dimensioni dello stage siano almeno di 215x138 pixel, ovvero le dimensioni minime richieste da Flash Player per visualizzare la finestra di dialogo.)

Parametri

Elementi API correlati

Restituisce un riferimento a un oggetto Microphone per la cattura dell’audio. Per iniziare la cattura dell'audio, associare l'oggetto Microphone a un oggetto NetStream (vedete NetStream.attachAudio()).

Chiamate multiple a Microphone.getMicrophone() fanno riferimento allo stesso microfono. Pertanto, se lo script contiene le righe mic1 = Microphone.getMicrophone() e mic2 = Microphone.getMicrophone(), sia mic1 che mic2 fanno riferimento allo stesso microfono (predefinito).

In generale non si dovrebbe mai passare un valore corrispondente a index. È sufficiente utilizzare il metodo air.Microphone.getMicrophone() per restituire un riferimento al microfono predefinito. Tramite la sezione delle impostazioni del microfono nel pannello delle impostazioni di Flash Player, l'utente può specificare il microfono predefinito che dovrà essere utilizzato dall'applicazione. (Per accedere al pannello delle impostazioni di Flash Player, l'utente deve fare clic con il pulsante destro del mouse sul contenuto di Flash Player in esecuzione in un browser Web). Se passate un valore per index, è possibile fare riferimento a un microfono diverso da quello scelto dall'utente. index è utilizzabile in rari casi: ad esempio se l'applicazione acquisisce l'audio da due microfoni contemporaneamente. L'impostazione di Flash Player per il microfono predefinito viene utilizzata anche per il contenuto eseguito in Adobe AIR.

Utilizzate la proprietà Microphone.index per ottenere il valore di indice dell'oggetto Microphone corrente. Questo valore può in seguito essere passato ad altri metodi della classe Microphone.

Quando un file SWF tenta di accedere all'oggetto restituito da Microphone.getMicrophone(), ad esempio quando chiamate NetStream.attachAudio(), viene visualizzata una finestra di dialogo relativa alla privacy che consente all'utente di scegliere se consentire o negare l'accesso al microfono. (Assicuratevi che le dimensioni dello stage siano almeno di 215x138 pixel, ovvero le dimensioni minime richieste da Flash Player per visualizzare la finestra di dialogo.)

Quando l'utente risponde a quanto richiesto da questa finestra di dialogo, viene inviato un evento status che indica la risposta dell'utente. Potete anche verificare la proprietà Microphone.muted per determinare se l'utente ha permesso o negato l'accesso al microfono.

Se Microphone.getMicrophone() restituisce il valore null, significa che il microfono è attualmente utilizzato da un'altra applicazione oppure che nel sistema non è installato alcun microfono. Per determinare se sono stati installati microfoni, utilizzate Microphones.names.length. Per visualizzare il pannello delle impostazioni Microfono di Flash Player che consente all'utente di scegliere il microfono a cui fa riferimento Microphone.getMicrophone() utilizzate Security.showSettings().

Parametri

Elementi API correlati

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

Richiede l’autorizzazione per l’uso del microfono da parte dell’applicazione.

Invia l’audio catturato da un microfono agli altoparlanti locali.

Parametri

Imposta il livello di input minimo che deve essere considerato suono e (facoltativamente) l'intervallo di silenzio che indica l'inizio del silenzio vero e proprio.

• Per impedire che il microfono rilevi qualunque suono, passate il valore 100 per silenceLevel; in questo modo l'evento activity non viene mai inviato.
• Per determinare la quantità di suono rilevata dal microfono, utilizzate la proprietà Microphone.activityLevel.

Speex include il rilevamento dell'attività vocale (VAD) e riduce automaticamente la larghezza di banda quando non viene rilevata alcuna voce. Se usate il codec Speex, Adobe consiglia di impostare il livello di silenzio su 0.

Il rilevamento dell'attività è la capacità di rilevare quando i livelli audio suggeriscono che una persona sta parlando. Se nessuno sta parlando, è possibile risparmiare ampiezza di banda poiché non è necessario inviare lo streaming audio associato. Questa informazione può essere utilizzata anche come feedback visivo per segnalare agli utenti che essi (o altri) non stanno producendo suoni.

I valori del silenzio corrispondono direttamente ai valori dell'attività. Il silenzio totale corrisponde a un valore di attività pari a 0. Il rumore costante (nella misura in cui può essere registrato in base all'impostazione corrente del guadagno) corrisponde a un valore di attività pari a 100. Una volta regolato adeguatamente il guadagno, quando non si parla il valore dell'attività è inferiore al valore del silenzio; quando si parla, il valore dell'attività supera il valore del silenzio.

Questo metodo ha uno scopo simile a quello di Camera.setMotionLevel(); entrambi vengono utilizzati per specificare quando viene inviato l'evento activity. Tuttavia, questi metodi hanno un impatto decisamente diverso sulla pubblicazione dello streaming:

• Camera.setMotionLevel() è studiato per rilevare il movimento e non influisce sull'uso dell'ampiezza di banda. Anche se uno streaming video non rileva alcun movimento, viene comunque inviato il video.
• Microphone.setSilenceLevel() è studiato per ottimizzare l'ampiezza di banda. Quando uno streaming audio è considerato silenzioso, non viene inviato alcun dato audio. Viene invece inviato un unico messaggio per segnalare che il silenzio è cominciato.

Parametri

Elementi API correlati

Specifica se utilizzare la funzione di soppressione dell'eco del codec audio. Il valore predefinito è false a meno che l'utente non abbia selezionato Riduci eco nel pannello delle impostazioni del microfono di Flash Player.

La soppressione dell'eco è un sistema per ridurre gli effetti del feedback audio, che si verifica quando il suono riprodotto dall'altoparlante di un computer viene ripreso dal microfono collegato allo stesso sistema (Si tratta di un effetto diverso dalla soppressione dell'eco acustica, che rimuove completamente il feedback. Il metodo setUseEchoSuppression() viene ignorato quando si chiama il metodo getEnhancedMicrophone() per utilizzare la soppressione dell'eco acustica.)

Di solito, è consigliabile utilizzare la soppressione dell'eco quando viene acquisito il suono riprodotto dagli altoparlanti (anziché una cuffia). Se il file SWF consente di specificare il dispositivo di uscita audio, è possibile chiamare Microphone.setUseEchoSuppression(true) se l'utente indica che sta utilizzando sia gli altoparlanti che il microfono.

Queste impostazioni possono essere regolate anche nel pannello delle impostazioni del microfono di Flash Player.

Parametri

Elementi API correlati

Due listener rilevano gli eventi activity e status. L'evento activity viene inviato all'inizio ed eventualmente alla fine della sessione e viene catturato dal metodo activityHandler(), che traccia le informazioni sull'evento. L'evento status viene inviato se l'oggetto microphone associato segnala eventuali informazioni sullo stato; viene catturato e tracciato utilizzando il metodo statusHandler().

Nota: per il corretto funzionamento di questo esempio, deve essere collegato un microfono al computer.

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