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 il microfono è disponibile ma non viene ancora utilizzato perché non è stata effettuata una chiamata a Microphone.getMicrophone(), questa proprietà viene impostata su -1.

Vedere anche

Il guadagno del microfono, ovvero il valore per cui il microfono deve moltiplicare il segnale prima di trasmetterlo. Il valore 0 comunica a Flash di moltiplicare per 0; in altre parole, il microfono non trasmette alcun suono.

Questa impostazione funziona come il potenziometro del volume di un impianto stereo: 0 corrisponde al volume spento e 50 al volume normale. I numeri inferiori a 50 indicano un volume più basso del normale, mentre quelli superiori a 50 indicano un volume più alto del normale. I valori validi sono quelli compresi tra 0 e 100; 50 è il valore predefinito. Questo valore può essere modificato nel pannello delle impostazioni del microfono di Flash Player.

Vedere anche

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

Vedere anche

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, vedere Microphone.getMicrophone().

Vedere anche

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

Vedere anche

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 riservatezza 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, vedere la voce relativa alla classe Array.

Quando si chiama la proprietà Microphone.names viene eseguito 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, utilizzare la proprietà name.

Vedere anche

La frequenza con cui il microfono cattura l'audio, espressa in kHz. I valori consentiti supportati dal dispositivo audio sono i seguenti: 5, 8, 11, 22 o 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).

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

Vedere anche

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, utilizzare il metodo Microphone.setSilenceLevel().

Vedere anche

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.

Vedere anche

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 (vedere NetStream.attachAudio()).

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

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

In generale non si dovrebbe mai passare un valore corrispondente a index. È sufficiente utilizzare il metodo Microphone.get() per restituire il microfono predefinito. Utilizzando il pannello delle impostazioni microfono l’utente può specificare quale deve essere il microfono predefinito utilizzato da Flash Player. Se si passa un valore per index, è possibile che si stia tentando di fare riferimento a un microfono diverso da quello specificato come dall'utente. index è utilizzabile in rari casi: ad esempio se l'applicazione cattura l'audio da due microfoni contemporaneamente.

Quando un file SWF tenta di accedere all’oggetto restituito da Microphone.get(), ad esempio, quando si richiama NetStream.attachAudio(), viene visualizzata una finestra di dialogo relativa alla riservatezza che consente all'utente di scegliere se consentire o negare l'accesso al microfono. (Assicurarsi che le dimensioni dello stage siano almeno di 215 x 138 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. È possibile anche controllare la proprietà Microphone.muted per determinare se l’utente ha permesso o negato l’accesso al microfono.

Se Microphone.get() 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, utilizzare 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.get utilizzare Security.showSettings().

Parametri

Vedere anche

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, passare il valore 100 per silenceLevel; in questo modo l'evento activity non viene mai inviato.
• Per determinare la quantità di suono rilevata dal microfono, utilizzare la proprietà Microphone.activityLevel.

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

Vedere anche

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 computer (si tratta di un effetto diverso dall'annullamento dell'eco, che rimuove completamente il feedback).

Di solito, è consigliabile utilizzare la soppressione dell'eco quando viene catturato il suono riprodotto dagli altoparlanti (anziché una cuffia) collegati allo stesso computer. 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

Vedere anche

Inviato quando un microfono inizia o termina una sessione.

Per specificare la quantità di suono richiesta per attivare questo evento tramite una proprietà activating impostata su true, o la quantità di tempo che deve passare senza che il suono attivi questo evento tramite una proprietà activating impostata su false, utilizzareMicrophone.setSilenceLevel().

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando un microfono segnala il proprio stato. Se il valore della proprietà code è "Microphone.muted" viene impedito al file SWF di accedere al microfono dell'utente. Se il valore della proprietà code è "Microphone.unmuted" viene consentito al file SWF di accedere al microfono dell'utente.

Questo evento ha le seguenti proprietà:

Vedere anche

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