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

Wenn das Mikrofon verfügbar aber noch nicht im Einsatz ist, weil Microphone.getMicrophone() noch nicht aufgerufen wurde, wird diese Eigenschaft auf -1 gesetzt.

Siehe auch

Die Mikrofonverstärkung, d. h. der Wert, um den das Signal des Mikrofons vor der Übertragung multipliziert werden soll. Bei einem Wert von 0 multipliziert Flash Player mit 0, d. h., das Mikrofon überträgt keine Töne.

Sie können sich diese Einstellung wie einen Lautstärkeregler an einer Stereoanlage vorstellen: wobei bei 0 kein Ton zu hören ist und es sich bei 50 um die normale Lautstärkeeinstellung handelt. Bei Werten unter 50 liegt die Lautstärke unter der normalen Einstellung, bei Werten über 50 wird dagegen eine höhere Lautstärke angegeben. Gültige Werte liegen zwischen 0 und 100. Der Standardwert lautet 50. Benutzer können diesen Wert auch im Flash Player-Bedienfeld für die Mikrofoneinstellungen anpassen.

Siehe auch

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

Siehe auch

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().

Siehe auch

Der Name des aktuellen Audioaufnahmegeräts, der von der Audioaufnahmehardware zurückgegeben wurde.

Siehe auch

Ein Array mit den Namen aller verfügbaren Audioaufnahmegerä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 Audioaufnahmegeräts sowie die Anzahl der Audioaufnahmegeräte im System angegeben. Weitere Informationen finden Sie im Abschnitt zur Array-Klasse.

Bei Aufruf von Microphone.names wird eine ausgiebige Untersuchung der Hardware erforderlich, und der Aufbau des Arrays kann einige Zeit in Anspruch nehmen. In den meisten Fällen können Sie das Standardmikrofon verwenden.

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

Siehe auch

Die Frequenz, bei der das Mikrofon Töne aufnehmen soll (in kHz). Die zulässigen Werte lauten wie folgt, sofern sie von Ihrem Audiogerät unterstützt werden: 5, 8, 11, 22 oder 44.

Der Standardwert ist 8 kHz, sofern das Audioaufnahmegerät diesen Wert unterstützt. Andernfalls gilt als Standardwert die nächste verfügbare Aufnahmestufe über 8 kHz, die auf dem Audioaufnahmegerät unterstützt wird, gewöhnlich 11 kHz.

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

Siehe auch

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

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

Siehe auch

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.

Siehe auch

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

Mehrere Aufrufe von Microphone.get() verweisen auf dasselbe Mikrofon. Falls ein Programmcode also die Zeilen mic1 = Microphone.get() und mic2 = Microphone.get() enthält, verweist sowohl mic1 als auch mic2 auf dasselbe (standardmäßige) Mikrofon.

Mit der index-Eigenschaft können Sie den Indexwert des aktuellen Microphone-Objekts abrufen. Sie können diesen Wert dann an andere Methoden der Microphone-Klasse übergeben.

Im Allgemeinen sollten Sie keinen Wert für index übergeben. Verwenden Sie einfach die Microphone.get()-Methode, um einen Verweis auf das Standardmikrofon zurückzugeben. Im Bedienfeld für die Mikrofoneinstellungen kann der Benutzer das Standardmikrofon für Flash Player festlegen. Wenn Sie einen Wert für index übergeben, verweisen Sie unter Umständen auf ein anderes als das vom Benutzer gewählte Mikrofon. In seltenen Fällen können Sie index verwenden, beispielsweise wenn Ihre Anwendung Audiodaten von zwei Mikrofonen gleichzeitig aufnimmt.

Wenn eine SWF-Datei versucht, auf das von Microphone.get() zurückgegebene Objekt zuzugreifen (wenn Sie beispielsweise NetStream.attachAudio() aufrufen), wird in Flash Player das Dialogfeld "Zugriffsschutz" 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.get() 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.get() verwiesen wird.

Parameter

Siehe auch

Leitet von einem Mikrofon aufgezeichnetes Audio an die lokalen Lautsprecher.

Parameter

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

• Wenn das Mikrofon überhaupt keinen Ton 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 Lautstärke ermitteln, die mit dem Mikrofon derzeit erkannt wird.

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 Audio-Stream 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 Ruhewert, wenn Sie nicht sprechen. Wenn Sie sprechen, ist der Aktivitätswert höher als der Ruhewert.

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 Video-Stream keine Bewegung feststellt, werden weiterhin Videodaten gesendet.
• Microphone.setSilenceLevel() dient zur Optimierung der Bandbreite. Wenn ein Audio-Stream als lautlos eingestuft wird, werden keine Audiodaten gesendet. Stattdessen wird eine Meldung gesendet, um den Beginn der Inaktivität (Stille) anzuzeigen.

Parameter

Siehe auch

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 am selben Computer empfangen werden. (Dies unterscheidet sich von der Echokompensation, bei der die Rückkopplungen vollständig entfernt werden.)

Generell empfiehlt sich die Echounterdrückung, wenn der Sound auf dem gleichen Computer über Lautsprecher und nicht über Kopfhörer wiedergegeben wird. Wenn Benutzer bei einer SWF-Datei das Tonausgabegerä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

Siehe auch

Wird ausgelöst, wenn eine Mikrofonsitzung gestartet oder beendet wird.

Um festzulegen, welche Audiomenge erforderlich ist, um dieses Ereignis mit einer activating-Eigenschaft mit dem Wert true auszulösen, oder welcher Zeitraum ohne Sound verstreichen muss, damit dieses Ereignis mit einer activating-Eigenschaft mit dem Wert false ausgelöst wird, verwenden Sie Microphone.setSilenceLevel().

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Siehe auch

Wird ausgelöst, wenn der Status eines Mikrofons gemeldet wird. Wenn der Wert der code-Eigenschaft auf "Microphone.Muted" gesetzt ist, hat der Benutzer den Zugriff der SWF-Datei auf das Mikrofon verweigert. Wenn der Wert der code-Eigenschaft auf "Microphone.Unmuted" gesetzt ist, hat der Benutzer den Zugriff der SWF-Datei auf das Mikrofon gewährt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Siehe auch

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