Microphone  - AS3

Mängden ljud som mikrofonen känner av. Värdena kan vara från 0 (inget ljud identifieras) till 100 (mycket högt ljud identifieras). Värdet för den här egenskapen kan hjälpa dig att fastställa ett bra värdet att skicka till Microphone.setSilenceLevel()-metoden.

Om mikrofonegenskapen muted är true, är värdet för den här egenskapen alltid -1.

Relaterade API-element

Den kodek som ska användas för att komprimera ljud. Tillgängliga kodekenheter är Nellymoser (standard) och Speex. Uppräkningsklassen SoundCodec innehåller de olika värden som är giltiga för egenskapen codec.

Om du använder Nellymoser-kodeken kan du ange samplingsfrekvensen med Microphone.rate(). Om du använder Speex-kodeken är samplingsfrekvensen inställd på 16 kHz.

Speex har även röstidentifiering och minskar automatiskt bandbredden när ingen röst hörs. Adobe rekommenderar att du ställer in tystnadsnivån på 0 när du använder Speex-kodeken. Använd metoden Microphone.setSilenceLevel() för att ställa in tystnadsnivån.

Relaterade API-element

Aktivera Speex-röstidentifiering.

Kodad talkvalitet när Speex-kodeken används. Möjliga värden är från 0 till 10. Standardvärdet är 6. Högre nummer representerar högre kvalitet men kräver högre bandbredd. Se följande tabell. Överföringshastigheten som listas representerar nettoöverföringshastigheter och inkluderar inte tid för paketering.

Relaterade API-element

Kontrollerar alternativ för förbättrad mikrofon. Mer information finns i MicrophoneEnhancedOptions-klassen. Den här egenskapen ignoreras för icke-förbättrade Microphone-instanser.

Relaterade API-element

Antal Speex-talrutor som överförs i ett paket (meddelande). Varje ram är 20 ms lång. Standardvärdet är två ramar per paket.

Fler Speex-rutor i ett meddelande gör att lägre bandbredd krävs men fördröjningen blir längre när meddelandet skickas. Färre Speex-rutor gör att större bandbredd krävs, men minskar fördröjningen.

Den mängd med vilken mikrofonen förstärker signalen. Giltiga värden är från 0 till 100. Standardvärdet är 50.

Relaterade API-element

Mikrofonens indexvärde, som reflekteras av arrayen som returneras av Microphone.names.

Relaterade API-element

Egenskapen isSupported är true om klassen Microphone stöds på den aktuella plattformen, och i annat fall är värdet false.

Anger om användaren har nekat åtkomst till mikrofonen (true) eller tillåtit åtkomst (false). Om det här värdet ändras skickas en status-händelse. Mer information finns i Microphone.getMicrophone().

Relaterade API-element

Namnet på den nuvarande ljudinspelningsenheten, som returneras av maskinvaran för ljudinspelning.

Relaterade API-element

En array med strängar som innehåller namnen på alla tillgängliga ljudinspelningsenheter. Namnen returneras utan att panelen Sekretessinställningar i Flash Player behöver visas för användaren. Arrayen ger information om det nollbaserade indexvärdet för varje ljudinspelningsenhet och antalet ljudinspelningsenheter i systemet via egenskapen Microphone.names.length. Mer information finns under Array-klassen.

Anrop till Microphone.names kräver en omfattande genomgång av maskinvaran. Det kan ta flera sekunder att skapa arrayen. I de flesta fall är det enklast att använda standardmikrofonen.

Obs! Om du vill bestämma namnet på den aktuella mikrofonen använder du egenskapen name.

Relaterade API-element

Maximal dämpning av brus i dB (negativt tal) som används för Speex-kodaren. Om brusdämpning är aktiverat används det på ljud som spelas in från mikrofonen före Speex-komprimering. Ställ in det på 0 om du vill inaktivera brusdämpning. Brusdämpning är som standard aktiverat med en maximal dämpning på -30 dB. Ignoreras när Nellymoser-kodek har valts.

Avgör om programmet har beviljats behörighet att använda mikrofonen.

Relaterade API-element

Den frekvens (i kHz) med vilken mikrofonen spelar in ljud. Giltiga värden är 5, 8, 11, 22 och 44. Standardvärdet är 8 kHz om ljudinspelningsenheten stöder det värdet. Annars är standardvärdet nästa tillgängliga inspelningsnivå över 8 kHz som stöds av ljudinspelningsenheten, vanligen 11 kHz.

Obs! Den faktiska frekvensen skiljer sig något från värdet för rate, enligt följande tabell:

Relaterade API-element

Hur mycket ljud som ska behövas för att mikrofonen ska aktiveras och skicka activity-händelsen. Standardvärdet är 10.

Relaterade API-element

Antalet millisekunder mellan den tidpunkt mikrofonen slutar identifiera ljud och den tidpunkt activity-händelsen skickas. Standardvärdet är 2000 (2 sekunder).

Om du vill ställa in det här värdet använder du metoden Microphone.setSilenceLevel().

Relaterade API-element

Styr mikrofonobjektets ljud när objektet är i en slinga.

Värdet är true om ekodämpning är aktiverad, annars false. Standardvärdet är false om inte användaren har valt Minska eko på panelen Mikrofoninställningar i Flash Player.

Relaterade API-element

Returnerar en referens till ett utökat Microphone-objekt som ska utföra akustisk ekoreducering. Använd akustisk ekoeliminering för att skapa chatt-program med realtidsljud/-video som inte kräver headset.

Parametern index fungerar på samma sätt för metoderna Microphone.getEnhancedMicrophone() och Microphone.getMicrophone().

Lägg till tillståndet MODIFY_AUDIO_SETTINGSunder Android-manifesttilläggen i programbeskrivningsfilen när du vill använda metoden på Android-enheter.

Viktigt: Vid en given tid kan du endast ha en instans av en förbättrad mikrofonenhet. Alla andra Microphone-instanser kommer att sluta leverera ljuddata och de kommer att erhålla ett StatusEvent med kodegenskapen Microphone.Unavailable. När förbättrat ljud inte initieras innebär anrop av den här metoden att null returneras. Att ange ett värde för Microphone.enhancedOptions har ingen effekt och alla befintliga Microphone-instanser fungerar som tidigare.

Om du vill konfigurera ett förbättrat Microphone-objekt, ska du ställa in egenskapen Microphone.enhancedOptions. I följande kod används ett förbättrat Microphone-objekt och akustisk ekoeliminering med full-duplex i en lokal test:

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

Metoden setUseEchoSuppression() ignoreras när akustisk ekoreducering används.

När en SWF-fil försöker nå objektet som returneras av metoden Microphone.getEnhancedMicrophone(), till exempel när NetStream.attachAudio() anropas, visas dialogrutan Sekretess som ger användaren möjlighet att tillåta eller neka åtkomst till mikrofonen. (Kontrollera att scenstorleken är minst 215 x 138 pixlar. Detta är minimistorleken för att dialogrutan ska kunna visas.)

Parametrar

Relaterade API-element

Returnerar en referens till ett Microphone-objekt för ljudinspelning. För att kunna börja spela in ljudet måste du koppla Microphone-objektet till ett NetStream-objekt (se NetStream.attachAudio()).

Flera anrop till Microphone.getMicrophone() hänvisar till samma mikrofon. Om din kod alltså innehåller raderna mic1 = Microphone.getMicrophone() och mic2 = Microphone.getMicrophone() refererar både mic1 och mic2 till samma mikrofon (standard).

För det mesta bör du inte skicka ett värde för index. Anropa helt enkelt air.Microphone.getMicrophone() för att returnera en referens till standardmikrofonen. Användaren kan ange den standardmikrofon som programmet ska använda med mikrofoninställningarna i Flash Player-inställningarna. (Användaren öppnar Flash Player-inställningarna genom att högerklicka på det Flash Player-innehåll som spelas upp i webbläsaren.) Om du skickar ett värde för index kan du referera till en annan mikrofon än den som användaren väljer. I sällsynta fall kan du också använda index, till exempel om ditt program spelar in ljud från två mikrofoner samtidigt. Innehåll som körs i Adobe AIR använder också Flash Player-inställningarna för standardmikrofonen.

Använd egenskapen Microphone.index för att hämta indexvärdet för det aktuella Microphone-objektet. Sedan kan du skicka det här värdet till andra metoder i klassen Microphone.

När en SWF-fil försöker nå mikrofonen som returneras av metoden Microphone.getMicrophone() – till exempel när du anropar NetStream.attachAudio() – visas dialogrutan Sekretess som ger användaren möjlighet att tillåta eller neka åtkomst till mikrofonen. (Kontrollera att scenstorleken är minst 215 x 138 pixlar. Detta är minimistorleken för att dialogrutan ska kunna visas.)

När användaren svarar på den här dialogrutan skickas enstatus-händelse med användarens svar. Du kan också avläsa egenskapen Microphone.muted för att se om användaren tillåter eller nekar åtkomst till mikrofonen.

Om Microphone.getMicrophone() returnerar null används antingen mikrofonen av ett annat program eller så finns det ingen mikrofon installerad. Du kan avgöra om det finns några installerade mikrofoner med Microphones.names.length. Om du vill visa panelen Mikrofoninställningar i Flash Player så att användaren kan välja vilken mikrofon som Microphone.getMicrophone ska referera till använder du Security.showSettings().

Parametrar

Relaterade API-element

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

Begär mikrofonbehörighet för programmet.

Kopplar ljud som spelats in av en mikrofon till de lokala högtalarna.

Parametrar

Anger den lägsta indatanivå som ska anses vara ljud och (eventuellt) hur lång tystnad som innebär att tystnad faktiskt har börjat.

• Om du vill att mikrofonen inte ska känna av ljud alls skickar du värdet 100 för silenceLevel. Då skickas aldrig activity-händelsen.
• Ta reda på mängden ljud som mikrofonen känner av just nu med Microphone.activityLevel.

Speex har även röstidentifiering och minskar automatiskt bandbredden när ingen röst hörs. Adobe rekommenderar att du ställer in tystnadsnivån på 0 när du använder Speex-kodeken.

Aktivitetsidentifiering är förmågan att identifiera när ljudnivån kan innebära att någon pratar. När användaren inte pratar kan bandbredden sparas eftersom inget associerat ljudflöde behöver skickas. Informationen kan också användas för visuell återkoppling så att användarna vet att de (eller andra) är tysta.

Tystnadsvärden motsvarar aktivitetsvärden direkt. Total tystnad motsvarar aktivitetsvärdet 0. Konstant högt ljud (det högsta som kan registreras med den aktuella förstärkningsinställningen) motsvarar aktivitetsvärdet 100. När förstärkningen har justerats på lämpligt sätt är aktivitetsvärdet lägre än tystnadsvärdet när du inte pratar. När du pratar är aktivitetsvärdet högre än tystnadsvärdet.

Den här metoden liknar Camera.setMotionLevel(). Båda metoderna används för att ange när activity-händelsen ska skickas. Metoderna påverkar dock publiceringsflöden på helt olika sätt:

• Camera.setMotionLevel() är utformat för att känna av rörelse och påverkar inte bandbreddsanvändning. Även om ett videoflöde inte känner av rörelse skickas fortfarande video.
• Microphone.setSilenceLevel() är utformad för att optimera bandbredd. När ett ljudflöde anses tyst, skickas inga ljuddata. I stället skickas ett enda meddelande som indikerar att tystnad har påbörjats.

Parametrar

Relaterade API-element

Anger om ljudkodekens ekodämpningsfunktion ska användas. Standardvärdet är false om inte användaren har valt Minska eko på panelen Mikrofoninställningar i Flash Player.

Ekodämpning används för att reducera effekten av rundgång, som orsakas av att mikrofonen fångar upp ljudet från högtalaren i samma system. (Detta är inte detsamma som akustisk ekoreducering som tar bort all ljudåterkoppling.) Metoden setUseEchoSuppression() ignoreras när du anropar getEnhancedMicrophone()-metoden för att använda akustisk ekoreducering.)

I allmänhet är det bra att använda ekodämpning om ljudet som spelas in ska spelas upp i högtalare (i stället för i ett headset). Om användaren tillåts ange ljuduppspelningsenhet i SWF-filen kan det vara bra att anropa Microphone.setUseEchoSuppression(true) om användaren anger att högtalare ska användas och han eller hon dessutom kommer att använda mikrofonen.

Användaren kan också ändra dessa inställningar på panelen Mikrofoninställningar i Flash Player.

Parametrar

Relaterade API-element

Två lyssnare lyssnar efter activity- och status-händelser. Händelsen activity skickas i början och slutet (om det finns något) på sessionen och hämtas av metoden activityHandler(), som spårar information om händelsen. Händelsen status skickas om det anslutna mikrofonobjektet rapporterar om statusinformation. Den läses in och spåras med metoden statusHandler().

Obs! En mikrofon måste vara ansluten till datorn för att det här ska fungera.

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