Microphone  - AS3

Die über das Mikrofon ermittelte Soundmenge. Die Werte liegen zwischen 0 (kein Sound) und 100 (sehr lauter Sound). Mithilfe des Werts dieser Eigenschaft können Sie einen geeigneten Wert zum Übergeben für die Methode Microphone.setSilenceLevel() ermitteln.

Wenn die muted-Eigenschaft des Mikrofons den Wert true hat, ist der Wert dieser Eigenschaft immer -1.

Verwandte API-Elemente

Der für die Audiokomprimierung zu verwendende Codec. Verfügbare Codecs sind Nellymoser (Standardeinstellung) und Speex. Die Enum-Klasse SoundCodec enthält die verschiedenen Werte, die für die codec-Eigenschaft gültig sind.

Wenn Sie den Nellymoser-Codec verwenden, können Sie die Samplerate über Microphone.rate() festlegen. Wenn Sie den Speex-Codec verwenden, ist die Samplerate auf 16 kHz eingestellt.

Speex enthält eine Sprachaktivitätserkennung (VAD) und reduziert die Bandbreite automatisch, wenn keine Sprache erkannt wird. Wenn Sie den Speex-Codec verwenden, empfiehlt Adobe, die Abschaltschwelle (Silence-Level) auf 0 zu setzen. Verwenden Sie zum Einstellen der Abschaltschwelle die Microphone.setSilenceLevel()-Methode.

Verwandte API-Elemente

Aktiviert die Speex-Sprechpausenerkennung.

Die kodierte Sprachqualität, wenn der Speex-Codec verwendet wird. Mögliche Werte sind 0 bis 10. Der Standardwert ist 6. Höhere Werte bedeuten eine höhere Qualität, erfordern aber auch mehr Bandbreite (wie in der folgenden Tabelle gezeigt). Die aufgelisteten Bitratenwerte sind Nettobitraten und enthalten keinen Paketierungsaufwand.

Verwandte API-Elemente

Steuert erweiterte Mikrofonoptionen. Weitere Informationen finden Sie in der Beschreibung der MicrophoneEnhancedOptions-Klasse. Diese Eigenschaft wird für nicht erweiterte Microphone-Instanzen ignoriert.

Verwandte API-Elemente

Anzahl der Speex-Sprachframes, die in einem Paket (Meldung) übertragen werden. Jeder Frame hat eine Länge von 20 ms. Der Standardwert ist zwei Frames pro Paket.

Je mehr Speex-Frames in einer Meldung enthalten sind, desto niedriger ist die erforderliche Bandbreite, aber desto länger ist die Verzögerung beim Senden der Meldung. Weniger Speex-Frames erhöhen die erforderliche Bandbreite, reduzieren aber Verzögerungen.

Betrag, um den das Mikrofon das Signal verstärkt. Die zulässigen Werte liegen zwischen 0 und 100. Der Standardwert ist 50.

Verwandte API-Elemente

Der Index des Mikrofons, der in dem durch Microphone.names zurückgegebenen Array angegeben ist.

Verwandte API-Elemente

Die isSupported-Eigenschaft hat den Wert true, wenn die Microphone-Klasse von der aktuellen Plattform unterstützt wird, andernfalls hat sie den Wert false.

Gibt an, ob der Benutzer den Zugriff auf das Mikrofon verweigert (true) oder gewährt hat (false). Wenn sich dieser Wert ändert, wird ein status-Ereignis ausgelöst. Weitere Informationen finden Sie unter Microphone.getMicrophone().

Verwandte API-Elemente

Der Name des aktuellen Soundaufnahmegeräts, der von der Soundaufnahmehardware zurückgegeben wurde.

Verwandte API-Elemente

Ein Array mit den Namen aller verfügbaren Soundaufnahmegeräte. Die Namen werden zurückgegeben, ohne dass das Flash Player-Bedienfeld für die Zugriffsschutzeinstellungen für Benutzer angezeigt werden muss. Mit diesem Array wird über die Microphone.names.length-Eigenschaft der auf null basierende Index jedes Soundaufnahmegeräts sowie die Anzahl der Soundaufnahmegeräte im System angegeben. Weitere Informationen finden Sie im Abschnitt zur Array-Klasse.

Zum Aufrufen der Microphone.names-Eigenschaft ist eine genaue Überprüfung der Hardware erforderlich; daher kann das Erstellen des Arrays einige Sekunden dauern. In den meisten Fällen können Sie das Standardmikrofon verwenden.

Hinweis: Um den Namen des aktuellen Mikrofons festzustellen, verwenden Sie die name-Eigenschaft.

Verwandte API-Elemente

Maximale Dämpfung des Rauschens in dB (negative Zahl), die für den Speex-Encoder verwendet wird. Wenn aktiviert, wird Rauschunterdrückung auf den durch das Mikrofon erfassten Ton angewendet, bevor die Speex-Komprimierung erfolgt. Mit der Einstellung 0 wird die Rauschunterdrückung deaktiviert. Rauschunterdrückung ist standardmäßig mit einer maximalen Dämpfung von -30 dB aktiviert. Wird bei Auswahl des Nellymoser-Codecs ignoriert.

Bestimmen Sie, ob der Anwendung die Berechtigung zur Verwendung des Mikrofons erteilt wurde.

Verwandte API-Elemente

Die Abtastrate (in kHz), mit der das Mikrofon Sound aufnimmt. Akzeptable Werte sind 5, 8, 11, 22 und 44. Der Standardwert ist 8 kHz, sofern das Soundaufnahmegerät diesen Wert unterstützt. Andernfalls gilt als Standardwert die nächste verfügbare Aufnahmestufe über 8 kHz, die auf dem Soundaufnahmegerät unterstützt wird, gewöhnlich 11 kHz.

Hinweis: Die tatsächliche Rate unterscheidet sich etwas vom rate-Wert, wie in der folgenden Tabelle zu sehen ist:

Verwandte API-Elemente

Die erforderliche Soundmenge zum Aktivieren des Mikrofons und zum Auslösen des activity-Ereignisses. Der Standardwert ist 10.

Verwandte API-Elemente

Die Zeit in Millisekunden zwischen dem Zeitpunkt, zu dem mit dem Mikrofon kein Sound mehr erfasst wird, und dem Zeitpunkt, zu dem das activity-Ereignis ausgelöst wird. Der Standardwert ist 2000 (2 Sekunden).

Um diesen Wert einzustellen, verwenden Sie die Microphone.setSilenceLevel()-Methode.

Verwandte API-Elemente

Steuert den Sound dieses Microphone-Objekts im Loopback-Modus.

Weist den Wert true auf, wenn die Echounterdrückung aktiviert ist, andernfalls false. Der Standardwert ist false, es sei denn, der Benutzer hat im Flash Player-Bedienfeld für die Mikrofoneinstellungen die Option „Echo reduzieren“ gewählt.

Verwandte API-Elemente

Gibt einen Verweis auf ein erweitertes Microphone-Objekt zurück, das akustische Echokompensation ausführen kann. Verwenden Sie die akustische Echokompensation, um Audio/Video-Chat-Anwendungen zu erstellen, für die keine Headsets erforderlich sind.

Der index-Parameter für die Microphone.getEnhancedMicrophone()-Methode und die Microphone.getMicrophone()-Methode arbeitet auf identische Weise.

Um diese Methode unter Android zu verwenden, fügen Sie im Andwendungsdeskriptür unter „Android-Manifestzusätze“ die Berechtigung MODIFY_AUDIO_SETTINGS hinzu.

Wichtig: Zu jedem beliebigen Zeitpunkt haben Sie immer nur eine einzelne Instanz eines erweiterten Mikrofongeräts. Alle anderen Microphone-Instanzen beenden die Bereitstellung von Audiodaten und erhalten ein StatusEvent-Objekt mit der code-Eigenschaft Microphone.Unavailable. Wenn das erweiterte Audio nicht initialisiert werden kann, geben Aufrufe dieser Methode null zurück, das Festlegen eines Werts für Microphone.enhancedOptions hat keine Auswirkungen und alle vorhandenen Microphone-Instanzen funktionieren wie zuvor.

Um ein erweitertes Microphone-Objekt zu konfigurieren, legen Sie die Microphone.enhancedOptions-Eigenschaft fest. Der folgende Code verwendet ein erweitertes Microphone-Objekt und Vollduplex-Echokompensation in einem lokalen Test:

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

Die setUseEchoSuppression()-Methode wird ignoriert, wenn die akustische Echokompensation verwendet wird.

Wenn eine SWF-Datei versucht, auf das von Microphone.getEnhancedMicrophone() zurückgegebene Objekt zuzugreifen – zum Beispiel, wenn Sie NetStream.attachAudio() aufrufen – zeigt Flash Player ein Dialogfeld zum Datenschutz an, in dem der Benutzer den Zugriff auf das Mikrofon zulassen oder verweigern kann. (Achten Sie darauf, dass die Bühnengröße mindestens 215 x 138 Pixel beträgt. Dies ist die Mindestgröße, die Flash Player für die Anzeige des Dialogfelds benötigt.)

Parameter

Verwandte API-Elemente

Gibt einen Verweis auf ein Mikrofon-Objekt zur Aufnahme von Audiodaten zurück. Um mit dem Aufzeichnen des Audios zu beginnen, müssen Sie das Microphone-Objekt mit einem NetStream-Objekt verknüpfen (siehe NetStream.attachAudio()).

Mehrere Aufrufe von Microphone.getMicrophone() verweisen auf dasselbe Mikrofon. Falls ein Programmcode also die Zeilen mic1 = Microphone.getMicrophone() und mic2 = Microphone.getMicrophone() enthält, verweisen mic1 und mic2 auf dasselbe (Standard-)Mikrofon.

Im Allgemeinen sollten Sie keinen Wert für index übergeben. Verwenden Sie einfach air.Microphone.getMicrophone(), um einen Verweis auf das Standardmikrofon zurückzugeben. Im Abschnitt „Mikrofoneinstellungen“ im Einstellungsbedienfeld von Flash Player kann der Benutzer das Standardmikrofon angeben, das die Anwendung verwenden soll. (Der Benutzer ruft die Einstellungen von Flash Player auf, indem er mit der rechten Maustaste auf den im Webbrowser ausgeführten Flash Player-Inhalt klickt.) Wenn Sie einen Wert für index übergeben, können Sie auf ein anderes als das vom Benutzer gewählte Mikrofon verweisen. In seltenen Fällen können Sie index verwenden, beispielsweise wenn Ihre Anwendung Audiodaten von zwei Mikrofonen gleichzeitig aufnimmt. Inhalt, der in Adobe AIR ausgeführt wird, verwendet ebenfalls die Flash Player-Einstellung für das Standardmikrofon.

Verwenden Sie die Microphone.index-Eigenschaft, um den Indexwert des aktuellen Microphone-Objekts abzurufen. Sie können diesen Wert dann an andere Methoden der Microphone-Klasse übergeben.

Wenn eine SWF-Datei versucht, auf das von Microphone.getMicrophone() zurückgegebene Objekt zuzugreifen (wenn Sie beispielsweise NetStream.attachAudio() aufrufen), wird in Flash Player ein Zugriffsschutz-Dialogfeld angezeigt, in dem der Benutzer den Zugriff auf das Mikrofon zulassen oder verweigern kann. (Achten Sie darauf, dass die Bühnengröße mindestens 215 x 138 Pixel beträgt. Dies ist die Mindestgröße, die Flash Player für die Anzeige des Dialogfelds benötigt.)

Wenn der Benutzer auf dieses Dialogfeld reagiert, wird ein status-Ereignis ausgelöst, das die Antwort des Benutzers anzeigt. Sie können auch die Microphone.muted-Eigenschaft überprüfen, um festzustellen, ob der Benutzer den Zugriff auf das Mikrofon zugelassen oder verweigert hat.

Wenn Microphone.getMicrophone() den Wert null zurückgibt, wird das Mikrofon entweder von einer anderen Anwendung genutzt oder im System sind keine Mikrofone installiert. Mit Microphones.names.length können Sie feststellen, ob Mikrofone installiert sind. Mit Security.showSettings() zeigen Sie das Flash Player-Bedienfeld für Mikrofoneinstellungen an, in dem der Benutzer das Mikrofon auswählen kann, auf das von Microphone.getMicrophone() verwiesen wird.

Parameter

Verwandte API-Elemente

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

Fordert Mikrofonberechtigung für die Anwendung an.

Leitet von einem Mikrofon aufgezeichnetes Audio an die lokalen Lautsprecher.

Parameter

Legt die minimale Eingangslautstärke fest, bei der Sound als solcher eingestuft wird und (optional) die Länge der lautlosen Zeit bis zum Erkennen von Stille.

• Wenn das Mikrofon überhaupt keinen Sound feststellen soll, legen Sie für silenceLevel einen Wert von 100 fest. Das activity-Ereignis wird nicht ausgelöst.
• Mithilfe von Microphone.activityLevel können Sie die Soundmenge ermitteln, die mit dem Mikrofon derzeit erkannt wird.

Speex enthält eine Sprachaktivitätserkennung (VAD) und reduziert die Bandbreite automatisch, wenn keine Sprache erkannt wird. Wenn Sie den Speex-Codec verwenden, empfiehlt Adobe, die Abschaltschwelle (Silence-Level) auf 0 zu setzen.

Aktivitätserkennung ist die Fähigkeit, anhand der Lautstärkepegel zu erkennen, dass jemand spricht. Wenn nicht gesprochen wird, kann Bandbreite gespart werden, da der zugehörige Audiostream nicht übertragen werden muss. Diese Daten können auch für visuelles Feedback verwendet werden, sodass Benutzer erkennen, dass sie (oder andere) derzeit stumm sind.

Stillewerte entsprechen unmittelbar den Aktivitätswerten. Völlige Stille entspricht dem Aktivitätswert 0. Konstante, laute Geräusche (so laut wie bei der momentanen Einstellung für die Lautstärke erfasst werden kann) entspricht einem Wert von 100. Wenn die Lautstärke genau angepasst ist, ist Ihr Aktivitätswert geringer als der Stillewert, wenn Sie nicht sprechen. Wenn Sie sprechen, ist der Aktivitätswert höher als der Stillewert.

Diese Methode ähnelt Camera.setMotionLevel(). Mit beiden Methoden wird angegeben, zu welchem Zeitpunkt das activity-Ereignis ausgelöst werden soll. Diese Methoden haben jedoch deutlich unterschiedliche Auswirkungen auf das Veröffentlichen von Streams:

• Camera.setMotionLevel() ist dazu bestimmt, Bewegung festzustellen und hat keinen Einfluss auf die Bandbreitenauslastung. Auch wenn ein Videostream keine Bewegung feststellt, werden weiterhin Videodaten gesendet.
• Microphone.setSilenceLevel() dient zur Optimierung der Bandbreite. Wenn ein Audiostream als lautlos eingestuft wird, werden keine Audiodaten gesendet. Stattdessen wird eine Meldung gesendet, um den Beginn der Inaktivität (Stille) anzuzeigen.

Parameter

Verwandte API-Elemente

Gibt an, ob die Audio-Codec-Funktion zur Echounterdrückung verwendet werden soll. Der Standardwert ist false, es sei denn, der Benutzer hat im Flash Player-Bedienfeld für die Mikrofoneinstellungen die Option „Echo reduzieren“ gewählt.

Durch die Echounterdrückung sollen die Auswirkungen von Rückkopplungen unterdrückt werden, die hervorgerufen werden, wenn Sounds aus dem Lautsprecher über das Mikrofon im selben System empfangen werden. (Dies unterscheidet sich von der akustischen Echokompensation, bei der die Rückkopplungen vollständig entfernt werden. Die setUseEchoSuppression()-Methode wird ignoriert, wenn Sie die getEnhancedMicrophone()-Methode aufrufen, um die akustische Echokompensation zu verwenden.)

Generell empfiehlt sich die Echounterdrückung, wenn der erfasste Sound über Lautsprecher und nicht über Kopfhörer wiedergegeben wird. Wenn Benutzer bei einer SWF-Datei das Soundausgabegerät angeben können, sollten Sie Microphone.setUseEchoSuppression(true) aufrufen, wenn angegeben wird, dass Lautsprecher und das Mikrofon verwendet werden sollen.

Benutzer können diese Einstellungen auch im Flash Player-Bedienfeld für die Mikrofoneinstellungen anpassen.

Parameter

Verwandte API-Elemente

Zwei Listener reagieren auf activity- und status-Ereignisse. Das activity-Ereignis wird am Anfang und Ende (falls vorhanden) der Sitzung ausgelöst und von der Methode activityHandler() erfasst, die Ereignisverarbeitungsinformationen verfolgt. Das Ereignis status wird ausgelöst, wenn Statusinformationen vom verknüpften Microphone-Objekt übermittelt werden; es wird mithilfe der statusHandler()-Methode erfasst und verfolgt.

Hinweis: Dieses Beispiel kann nur dann korrekt nachvollzogen werden, wenn ein Mikrofon mit dem Computer verbunden ist.

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