Volume sonore détecté par le microphone. Les valeurs gérées sont comprises entre 0 (aucun son n'est détecté) et 100 (un son de grande intensité est détecté). La valeur de cette propriété peut vous aider à déterminer la valeur qu'il convient de transmettre à la méthode Microphone.setSilenceLevel().

Si le microphone est disponible, mais n'est pas encore utilisé car la méthode Microphone.getMicrophone() n'a pas été appelée, cette propriété est définie sur -1.

Voir aussi

Codec à utiliser pour la compression audio. Le codec utilisé par défaut est Nellymoser. La classe d'énumération SoundCodec contient les différentes valeurs valides pour la propriété codec.

Voir aussi

Qualité du discours codé lorsque le codec Speex est utilisé. Les valeurs possibles sont comprises entre 0 et 10. La valeur par défaut est 6. Les nombres les plus élevés offrent une plus grande qualité mais consomment davantage de bande passante, comme le montre le tableau suivant. Les valeurs de débits énumérées représentent les débits nets sans la surcharge de la mise en paquets.

Voir aussi

Nombre d'images de discours Speex transmises dans un paquet (message). La longueur de chaque image est 20 ms. La valeur par défaut est deux images par paquet.

Plus un message comporte d'images Speex, moins la bande passante requise est élevée, mais plus l'envoi du message est retardé. Moins d'images Speex augmente la bande passante, mais réduit le retard.

Gain du microphone, c'est-à-dire la valeur par laquelle le microphone multiplie le signal avant de le transmettre. Une valeur 0 indique à Flash Player de multiplier par 0 ; autrement dit, le microphone ne transmet aucun son.

Considérez ce paramètre comme le bouton du volume sur une chaîne stéréo : 0 correspond au volume minimum, et 50 au volume normal. Les nombres inférieurs à 50 indiquent un volume inférieur au volume normal, tandis que les nombres supérieurs à 50 indiquent un volume supérieur au volume normal. Les valeurs valides vont de 0 à 100, 50 étant la valeur par défaut. L'utilisateur peut modifier cette valeur dans le panneau Paramètres du microphone de Flash Player.

Voir aussi

Index du microphone, tel qu'indiqué dans le tableau renvoyé par Microphone.names.

Voir aussi

Spécifie si l'utilisateur a refusé (true) ou autorisé (false) l'accès au microphone. Lorsque cette valeur change, un événement status est distribué. Pour plus d'informations, voir Microphone.getMicrophone().

Voir aussi

Nom du périphérique de capture audio actuel, tel que renvoyé par le matériel de capture audio.

Voir aussi

Tableau de chaînes contenant les noms de tous les périphériques de capture audio disponibles. Les noms sont renvoyés sans qu'il soit nécessaire d'afficher le panneau des paramètres de confidentialité de Flash Player à l'intention de l'utilisateur. Ce tableau indique l'index (commençant à zéro) de chaque périphérique de capture audio, ainsi que le nombre de ces périphériques présents dans le système, par le biais de la propriété Microphone.names.length. Pour plus d'informations, consultez l'entrée de la classe Array.

L'appel de la propriété Microphone.names exige un examen minutieux du matériel et plusieurs secondes peuvent être nécessaires pour composer le tableau. Dans la plupart des cas, vous pouvez utiliser le microphone par défaut.

Remarque : pour connaître le nom du microphone actif, utilisez la propriété name.

Voir aussi

Fréquence à laquelle le microphone capture le son, en kHz. Les valeurs autorisées sont celles que votre périphérique audio prend en charge parmi les suivantes : 5, 8, 11, 22 ou 44.

La valeur par défaut est 8 kHz si votre périphérique de capture audio prend en charge cette valeur. Dans le cas contraire, la valeur par défaut est le niveau de capture supérieur à 8 kHz immédiatement disponible et pouvant être pris en charge par votre périphérique de capture audio, généralement 11 kHz.

Volume sonore requis pour activer le microphone et distribuer l'événement activity. La valeur par défaut est 10.

Voir aussi

Nombre de millisecondes qui s'écoule entre le moment où le microphone arrête la détection du son et le moment où l'événement activity est distribué. La valeur par défaut est 2 000 (2 secondes).

Pour définir cette valeur, utilisez la méthode Microphone.setSilenceLevel().

Voir aussi

Contrôle le son de cet objet Microphone lorsque le mode loopback est activé.

Définit true si la fonctionnalité de suppression de l'écho est activée ; false dans le cas contraire. La valeur par défaut est false sauf si l'utilisateur sélectionne l'option Réduire l'écho dans le panneau Paramètres du microphone de Flash Player.

Voir aussi

Renvoie une référence à un objet Microphone pour capturer des données audio. Pour commencer la capture du flux audio, vous devez relier l'objet Microphone à un objet NetStream (voir NetStream.attachAudio() ).

Plusieurs appels à Microphone.get() font référence au même microphone. Ainsi, si votre code contient les lignes mic1 = Microphone.get() et mic2 = Microphone.get(), les lignes mic1 et mic2 font référence au même microphone (par défaut).

Si vous souhaitez utiliser le microphone par défaut, vous devez appeler getMicrophone() avec -1. Si vous l'appelez sans paramètres, il renvoie le premier microphone dans la liste.

Utilisez la propriété index pour obtenir la valeur d'index de l'objet Microphone actif. Vous pouvez ensuite transmettre cette valeur aux autres méthodes de la classe Microphone.

En général, il est préférable de ne pas transmettre de valeur pour index. Utilisez simplement la méthode Microphone.getMicrophone() pour renvoyer une référence au microphone par défaut. Dans le panneau Paramètres du microphone, l'utilisateur peut spécifier le microphone par défaut que l'application doit utiliser. Si vous transmettez une valeur pour index, vous pouvez référencer un microphone différent de celui que l'utilisateur a choisi. Vous pouvez utiliser index en de rares occasions, par exemple si votre application capture un flux audio à partir de deux microphones simultanément.

Lorsqu'un fichier SWF tente d'accéder à l'objet renvoyé par la méthode Microphone.getMicrophone(), par exemple lorsque vous appelez NetStream.attachAudio(), Flash Player affiche une boîte de dialogue Confidentialité qui permet à l'utilisateur d'autoriser ou de refuser l'accès au microphone. (Assurez-vous que la taille de votre scène est d'au moins 215 x 138 pixels ; il s'agit de la taille minimale requise par Flash Player pour afficher cette boîte de dialogue.)

Lorsque l'utilisateur répond à cette boîte de dialogue, un événement status indiquant la réponse de l'utilisateur est distribué. Vous pouvez également vérifier la propriété Microphone.muted pour déterminer si l'utilisateur a autorisé ou interdit l'accès au microphone.

Si Microphone.getMicrophone() renvoie la valeur null, cela signifie que le microphone est utilisé par une autre application ou qu'aucun microphone n'est installé sur le système. Pour déterminer si un microphone est installé, utilisez Microphones.names.length. Pour afficher le panneau Paramètres du microphone de Flash Player, qui permet à l'utilisateur de choisir le microphone référencé par Microphone.getMicrophone(), utilisez Security.showSettings().

Paramètres

Voir aussi

Dirige le flux audio capturé par un microphone vers les haut-parleurs locaux.

Paramètres

Définit le niveau d'entrée minimal devant être considéré comme du son et (éventuellement) la durée de silence indiquant le début du silence.

• Pour empêcher le microphone de détecter le son, attribuez la valeur 100 au paramètre silenceLevel ; dans ce cas, l'événement activity n'est jamais distribué.
• Pour déterminer le volume sonore actuellement détecté par le microphone, utilisez Microphone.activityLevel.

La détection de l'activité est la capacité à détecter les niveaux audio indiquant qu'une personne est en train de parler. Lorsqu'une personne ne parle pas, il est possible d'économiser de la bande passante car il n'est pas nécessaire d'envoyer le flux audio correspondant. Ces informations peuvent également être utilisées à des fins de réponse visuelle afin que les utilisateurs (ou d'autres personnes) sachent qu'ils sont silencieux.

Les valeurs de silence correspondent directement aux valeurs d'activité. La valeur d'activité 0 est associée au silence total. La valeur d'activité 100 est associée à un bruit fort constant (maximum enregistrable selon le paramètre de gain actuel). Une fois le gain ajusté convenablement, votre valeur d'activité est inférieure à votre valeur de silence lorsque vous ne parlez pas. Inversement, lorsque vous parlez, la valeur d'activité dépasse celle du silence.

Cette méthode est similaire à la méthode Camera.setMotionLevel() ; ces deux méthodes sont utilisées pour spécifier à quel moment il convient de distribuer l'événement activity. Toutefois, leur impact sur la publication des flux diffère de manière significative :

• Camera.setMotionLevel() est conçu pour détecter le mouvement et n'a aucune incidence sur l'utilisation de la bande passante. La vidéo est envoyée peu importe qu'un flux vidéo détecte du mouvement ou non.
• Microphone.setSilenceLevel() est conçu pour optimiser la bande passante. Lorsqu'un flux audio est considéré comme étant silencieux, aucune donnée audio n'est envoyée. En revanche, un message unique indiquant le début du silence est envoyé.

Paramètres

Voir aussi

Spécifie s'il convient d'utiliser la fonctionnalité de suppression de l'écho du codec audio. La valeur par défaut est false sauf si l'utilisateur sélectionne l'option Réduire l'écho dans le panneau Paramètres du microphone de Flash Player.

La suppression de l'écho vise à réduire les effets de la réaction acoustique créée lorsque le son qui sort du haut-parleur est capté par le microphone sur un même ordinateur. (Elle diffère de l'annulation de l'écho qui supprime entièrement la réaction acoustique.)

En général, il est recommandé de supprimer l'écho lorsque le son capturé est lu via les haut-parleurs, et non par le casque, sur un même ordinateur. Si votre fichier SWF autorise les utilisateurs à spécifier le périphérique de sortie audio, il peut être souhaitable d'appeler Microphone.setUseEchoSuppression(true) s'ils précisent qu'ils utilisent les haut-parleurs et qu'ils ont également l'intention d'utiliser le microphone.

Les utilisateurs peuvent également ajuster ces paramètres dans le panneau Paramètres du microphone de Flash Player.

Paramètres

Voir aussi

Distribué lorsqu'un microphone commence ou termine une session.

Pour spécifier la quantité de son requise pour déclencher cet événement avec une propriété activating true, ou le délai devant s'écouler sans son pour déclencher cet événement avec une propriété activating false, utilisez Microphone.setSilenceLevel().

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué lorsqu'un microphone publie son état. Si la valeur de la propriété code est réglée sur "Microphone.Muted", l'utilisateur a interdit au fichier SWF d'accéder au microphone. Si la valeur de la propriété code est réglée sur "Microphone.Unmuted", l'utilisateur a autorisé le fichier SWF à accéder au microphone.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Deux écouteurs surveillent les événements activity et status. L'événement activity est distribué au début et à la fin (si elle existe) de la session, et il est capturé par la méthode activityHandler() qui assure le suivi des informations sur l'événement. L'événement status est distribué si l'objet microphone joint signale des informations d'état ; sa capture et son suivi sont assurés par le biais de la méthode statusHandler().

Remarque : un microphone doit être branché sur votre ordinateur pour le bon déroulement de cet exemple.

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