Quantité de mouvement détecté par la caméra. Les valeurs gérées sont comprises entre 0 (aucun mouvement n'est détecté) et 100 (une grande quantité de mouvement est détectée). La valeur de cette propriété peut vous aider à déterminer s'il est nécessaire de transmettre un paramètre à la méthode setMotionLevel().

Si la caméra est disponible mais qu'elle n'est pas encore utilisée parce que la méthode Video.attachCamera() n'a pas été appelée, cette propriété est définie sur -1.

Si vous diffusez en continu de la vidéo non compressée en local seulement, cette propriété n’est définie que si vous avez affecté une fonction au gestionnaire d'événements. Dans le cas contraire, elle n’est pas définie.

Voir aussi

Quantité maximale de bande passante pouvant être utilisée par la source vidéo sortante actuelle, en octets. Une valeur de 0 signifie que la source peut utiliser autant de bande passante que nécessaire pour conserver la qualité d'image voulue.

Pour définir cette propriété, utilisez la méthode setQuality().

Voir aussi

Cadence à laquelle la caméra capture des données, en images par seconde. Cette propriété ne peut pas être définie ; toutefois, vous pouvez utiliser la méthode setMode() pour définir une propriété connexe, fps, qui spécifie la cadence maximale à laquelle vous souhaitez que la caméra capture les données.

Voir aussi

Fréquence maximale à laquelle la caméra peut capturer des données, en images par seconde. La fréquence maximale possible dépend des capacités de la caméra ; cette fréquence peut ne pas être atteinte.

• Pour définir une valeur souhaitée pour cette propriété, utilisez la méthode setMode().
• Pour déterminer la cadence à laquelle la caméra capture actuellement les données, utilisez la propriété currentFPS.

Voir aussi

Hauteur de capture actuelle, en pixels. Pour définir une valeur à cette propriété, utilisez la méthode setMode().

Voir aussi

Entier (commençant à zéro) qui spécifie l'index de la caméra, tel qu'indiqué dans le tableau renvoyé par la propriété names.

Voir aussi

Nombre d'images vidéos (appelées images-clés) transmises intégralement sans être interpolées par l’algorithme de compression vidéo. La valeur par défaut, 15, indique que chaque quinzième image est une image-clé. Une valeur de 1 signifie que chaque image est une image clé. Les valeurs autorisées vont de 1 à 48.

Voir aussi

Indique si les données capturées par la caméra et visionnées localement sont compressées et décompressées (true), comme elles le seraient pour une transmission en directe par le biais de Flash Media Server, ou non compressées (false). La valeur par défaut est false.

Le flux compressé est utile pour les tests, par exemple pour obtenir un aperçu des paramètres de qualité vidéo, mais son coût de traitement est important. L'affichage local est compressé, modifié pour être transmis comme il le serait sur une connexion directe, puis décompressé pour l'affichage local.

Pour définir cette valeur, utilisez Camera.setLoopback(). Pour définir le taux de compression utilisé lorsque vous réglez cette propriété sur true, utilisez Camera.setQuality().

Voir aussi

Quantité de mouvement requis pour invoquer l’événement activity. Les valeurs gérées sont comprises entre 0 et 100. La valeur par défaut est 50.

La vidéo peut être affichée quelle que soit la valeur de la propriété motionLevel. Pour plus d'informations, consultez l’entrée setMotionLevel().

Voir aussi

Nombre de millisecondes qui s’écoule entre le moment où la caméra arrête la détection du mouvement et le moment où l’événement activity est appelé. La valeur par défaut est 2 000 (2 secondes).

Pour définir cette valeur, utilisez setMotionLevel().

Voir aussi

Valeur booléenne qui indique si l'utilisateur a refusé (true) ou autorisé (false) l'accès à la caméra dans la boîte de dialogue de confidentialité de Flash Player. Lorsque cette valeur change, l’événement status est distribué.

Voir aussi

Nom de la caméra en cours, tel que renvoyé par le matériel de la caméra.

Voir aussi

Tableau de chaînes qui indique les noms de toutes les caméras disponibles sans afficher la boîte de dialogue de confidentialité de Flash Player. Ce tableau se comporte de la même manière que tout autre tableau ActionScript : il fournit de façon implicite l'index, commençant à zéro, de chaque caméra et le nombre de caméras présentes sur le système (via names.length). Pour plus d'informations, consultez l’entrée names dans la section consacrée à la classe Array.

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

Voir aussi

Niveau de qualité d'image requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo. Les valeurs de qualité acceptables sont comprises entre 1 (qualité la plus médiocre, compression maximale) et 100 (qualité optimale, pas de compression). La valeur par défaut est 0, ce qui signifie que la qualité de l'image peut varier si nécessaire pour éviter de dépasser la bande passante disponible.

Pour définir cette propriété, utilisez la méthode setQuality().

Voir aussi

Largeur de capture actuelle, en pixels. Pour définir une valeur souhaitée pour cette propriété, utilisez la méthode setMode().

Voir aussi

Renvoie une référence à un objet Camera pour capturer de la vidéo. Pour commencer la capture de la vidéo, vous devez relier l'objet Camera à un objet vidéo (voir Video.attachCamera() ). Pour transmettre la vidéo à Flash Media Server, appelez NetStream.attachCamera() pour relier l'objet Camera à un objet NetStream.

Plusieurs appels de la méthode getCamera() référencent le même pilote de caméra. Ainsi, si votre script contient du code comme firstCam:Camera = getCamera() et secondCam:Camera = getCamera(), alors firstCam et secondCam font référence à une même caméra, qui est la caméra par défaut de l’utilisateur.

En général, évitez de transmettre la valeur du paramètre name ; contentez-vous d'utiliser getCamera() pour renvoyer une référence à la caméra par défaut. Via le panneau Paramètres de la caméra (comme indiqué plus bas dans cette section), l'utilisateur peut spécifier la caméra que Flash Player doit utiliser par défaut.

Lorsqu'un fichier SWF tente d'accéder à la caméra renvoyée par getCamera(), Flash Player affiche une boîte de dialogue permettant à l'utilisateur d'autoriser ou de refuser l'accès à la caméra. (Vérifiez la taille de la fenêtre de votre application qui doit être au moins de 215 x 138 pixels, taille minimale requise par Flash Player pour afficher la boîte de dialogue.) Lorsque l'utilisateur répond à cette boîte de dialogue, Flash Player renvoie un objet d'information dans l'événement status qui précise la réponse de l'utilisateur : Camera.muted indique que l'utilisateur a refusé l'accès à une caméra ; Camera.unmuted qu'il en a autorisé l'accès. Pour déterminer si l'utilisateur a refusé ou autorisé l'accès à la caméra sans traiter l'événement status, utilisez la propriété muted.

L'utilisateur peut également spécifier des paramètres de confidentialité permanents pour un domaine spécifique. Pour ce faire, il lui suffit de cliquer du bouton droit (Windows) ou de cliquer en maintenant la touche Contrôle enfoncée (Macintosh) lors de la lecture d'un fichier SWF, de sélectionner Paramètres, d'ouvrir la boîte de dialogue Confidentialité, puis de sélectionner Mémoriser.

Vous ne pouvez pas utiliser ActionScript pour définir la valeur Autoriser ou Refuser d'un utilisateur, mais vous pouvez afficher la boîte de dialogue de confidentialité pour l'utilisateur en appelant Security.showSettings(SecurityPanel.PRIVACY). Si l'utilisateur sélectionne Mémoriser, Flash Player ne l'invite plus à autoriser ou refuser l’accès à votre caméra des fichiers SWF de ce domaine.

Si getCamera() renvoie la valeur null, cela signifie que la caméra est utilisée par une autre application ou qu'aucune caméra n'est installée sur le système. Pour déterminer si une caméra est installée, utilisez la propriété names.length. Pour afficher le panneau Paramètres de la caméra de Flash Player qui permet à l'utilisateur de choisir la caméra à référencer par getCamera(), utilisez System.showSettings(SecurityPanel.CAMERA).

L'analyse du matériel à la recherche de caméras exige un certain temps. Lorsque Flash Player détecte au moins une caméra, le matériel n'est plus analysé pendant la durée de vie de l'occurrence du lecteur. Cependant, si Flash Player ne détecte pas de caméra, il effectue une analyse à chaque appel de getCamera. Cela est particulièrement pratique si un utilisateur a oublié de connecter sa caméra. Si votre fichier SWF contient un bouton Réessayer qui appelle getCamera, Flash Player peut localiser la caméra sans que l'utilisateur ne soit obligé de redémarrer le fichier SWF.

Paramètres

Voir aussi

Spécifie les images qui sont transmises intégralement (keyframes) sans être interpolées par l’algorithme de compression vidéo. Cette méthode ne fonctionne que si vous transmettez la vidéo via Flash Media Server.

L’algorithme de compression vidéo de Flash compresse la vidéo en transmettant uniquement les éléments modifiés à partir de la dernière image de la vidéo. Ces portions sont appelées images interpolées. Les images d’une vidéo peuvent être interpolées en fonction du contenu de l’image précédente. Une image-clé, en revanche, est une image vidéo complète. Elle n'est pas interpolée sur la base des images précédentes.

Pour déterminer la valeur du paramètre keyFrameInterval, tenez compte de la bande passante et de l’accessibilité de la lecture vidéo. Une valeur keyFrameInterval élevée (envoi moins fréquent des images-clés), par exemple, entraîne une consommation réduite de bande passante. En revanche, le temps nécessaire au positionnement de la tête de lecture à un point donné de la vidéo est susceptible d’augmenter, car il sera peut-être nécessaire d’interpoler un plus grand nombre d'images précédentes avant que la vidéo puisse reprendre.

Inversement, une valeur keyFrameInterval faible (envoi plus fréquent des images-clés) augmente la consommation de bande passante, car des images vidéo intégrales sont transmises plus souvent, mais elle peut réduire le temps nécessaire à la localisation d’une image spécifique dans une vidéo enregistrée.

Paramètres

Voir aussi

Indique s’il est nécessaire d’utiliser un flux vidéo compressé pour un visionnage local des données reçues par la caméra. Cette méthode n’est applicable que si vous transmettez du contenu vidéo à l’aide de Flash Media Server. Le réglage de compress sur true vous permet de déterminer plus précisément la façon dont la vidéo se présentera lorsque les utilisateurs la visionneront en temps réel.

Bien qu’un flux compressé soit utile à des fins de test, par exemple pour se faire une idée des paramètres de qualité vidéo, les coûts de traitement qu’il entraîne sont élevés car il implique plus qu’une simple compression. Le contenu vidéo est compressé, édité à des fins de transmission comme sur une connexion en direct, puis décompressé pour un visionnage local.

Pour définir le taux de compression utilisé lorsque vous réglez compress sur true, servez-vous de Camera.setQuality().

Paramètres

Voir aussi

Définit le mode de capture de la caméra sur le mode natif qui remplit le mieux les conditions requises. Si la caméra ne dispose pas d'un mode natif correspondant à tous les paramètres que vous transmettez, Flash Player sélectionne un mode de capture qui synthétise le mieux le mode demandé. Cette manipulation peut nécessiter le découpage de l'image et l'omission d'images.

Par défaut, Flash Player omet des images si nécessaire pour conserver la taille de l'image. Pour réduire le nombre d'images omises, même si cela passe par une réduction de la taille de l'image, définissez le paramètre favorArea sur false.

Lorsqu'il choisit un mode natif, Flash Player tente de conserver les proportions demandées dans la mesure du possible. Par exemple, si vous publiez la commande myCam.setMode(400, 400, 30) et que les valeurs de largeur et de hauteur maximales disponibles sur la caméra sont 320 et 288, Flash Player définit la largeur et la hauteur sur 288. Ce faisant, Flash Player conserve la proportion 1/1 que vous avez demandée.

Pour déterminer les valeurs affectées à ces propriétés une fois la sélection, par Flash Player, du mode qui correspond le mieux aux valeurs que vous avez demandées, utilisez les propriétés width, height et fps.

Si vous utilisez Flash Media Server, vous pouvez également capturer des images uniques ou créer une séquence en accéléré. Pour plus d'informations, consultez la méthode NetStream.attachCamera().

Paramètres

Voir aussi

Spécifie la quantité de mouvement requise pour distribuer l’événement activity. Peut éventuellement définir le nombre de millisecondes qui doit s'écouler sans activité avant que Flash Player ne considère que le mouvement a cessé et distribue l’événement.

Remarque : la vidéo peut être affichée quelle que soit la valeur du paramètre motionLevel. Ce paramètre détermine uniquement à quel moment et dans quelles circonstances l’événement est distribué, pas si du contenu vidéo est capturé ou affiché.

Pour empêcher la caméra de détecter le mouvement, attribuez la valeur 100 au paramètre motionLevel. Dans ce cas, l’événement activity n'est jamais distribué. (Vous utiliserez probablement cette valeur à des fins de tests uniquement, par exemple pour désactiver temporairement des gestionnaires qui seraient normalement déclenchés par la distribution de l’événement.)

Pour déterminer la quantité de mouvement actuellement détectée par la caméra, utilisez la propriété activityLevel. Les valeurs de sensibilité de mouvement correspondent directement aux valeurs d'activité. La valeur d’activité 0 est associée à l'absence totale de mouvement. La valeur d’activité 100 est associée au mouvement constant. Lorsque vous êtes immobile, votre valeur d’activité est inférieure à votre valeur de sensibilité de mouvement. Inversement, lorsque vous vous déplacez, vos valeurs d’activité sont fréquemment supérieures à votre valeur de sensibilité de mouvement.

L'objectif de cette méthode est similaire à celui de Microphone.setSilenceLevel(). Les 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 :

• 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é.
• 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.

Paramètres

Voir aussi

Définit la quantité maximale de bande passante par seconde ou la qualité d’image requise pour les données vidéo sortantes actuelles. Cette méthode ne peut généralement être appliquée que si vous transmettez la vidéo via Flash Media Server.

Utilisez-la pour spécifier l'élément de la vidéo sortante le plus important pour votre application, la bande passante ou la qualité de l'image.

• Pour indiquer que la bande passante est prioritaire, attribuez une valeur à bandwidth et la valeur 0 à quality. Flash Player transmet une vidéo de qualité optimale dans la bande passante spécifiée. Si nécessaire, Flash Player réduit la qualité de l'image afin d'éviter de dépasser la bande passante spécifiée. En général, plus le mouvement augmente, plus la qualité diminue.
• Pour indiquer que la qualité est prioritaire, transmettez la valeur 0 à bandwidth et une valeur numérique à quality. Flash Player utilise autant de bande passante que nécessaire pour conserver la qualité spécifiée. Si nécessaire, Flash Player réduit la fréquence pour conserver la qualité de l'image. En général, plus le mouvement augmente, plus la consommation de bande passante augmente également.
• Pour spécifier que la bande passante et la qualité sont aussi importantes l'une que l'autre, transmettez des valeurs numériques aux deux paramètres. Flash Player transmet alors de la vidéo permettant de respecter la qualité requise et ne dépassant pas la bande passante spécifiée. Si nécessaire, Flash Player réduit la fréquence pour conserver la qualité de l'image sans dépasser la bande passante spécifiée.

Paramètres

Voir aussi

Distribué lorsqu’une caméra commence ou termine une session. Appelez Camera.setMotionLevel() pour spécifier la quantité de mouvement requise pour déclencher un événement activity avec une valeur activating de true, ou le délai devant s'écouler sans activité avant le déclenchement d'un événement activity avec une valeur activating de false.

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

Distribué lorsqu’une caméra publie son état. Si la propriété code est réglée sur "Camera.muted", l’utilisateur a interdit au fichier SWF d’accéder à sa caméra. Si la propriété code est réglée sur "Camera.unmuted", l’utilisateur a autorisé le fichier SWF à accéder à sa caméra.

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

Voir aussi

Remarque : une caméra doit être reliée à votre ordinateur pour le bon déroulement de cet exemple.

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.*;
    import flash.media.Camera;
    import flash.media.Video;

    public class CameraExample extends Sprite {
        private var video:Video;
        
        public function CameraExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var camera:Camera = Camera.getCamera();
            
            if (camera != null) {
                camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                video = new Video(camera.width * 2, camera.height * 2);
                video.attachCamera(camera);
                addChild(video);
            } else {
                trace("You need a camera.");
            }
        }
        
        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }
    }
}