Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
flash.media 

Camera  - AS3

Packagesx

Niveau supérieur
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques
Packageflash.media
Classepublic final class Camera
HéritageCamera Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Utilisez la classe Camera pour capturer une vidéo à partir de la caméra du système client ou du périphérique. Servez-vous de la classe Video pour contrôler la vidéo localement. Utilisez les classes NetConnection et NetStream pour transmettre la vidéo au Flash Media Server. Flash Media Server peut envoyer le flux vidéo à d’autres serveurs et le diffuser à d’autres clients exécutant Flash Player ou AIR.

Une occurrence de Camera permet ce capturer de la vidéo au format paysage. Sur les périphériques prenant en charge le changement d’orientation de l’écran, tels que les téléphones portables, un objet Video joint à la caméra affiche uniquement la vidéo filmée verticalement en orientation paysage. Par conséquent, les applications mobiles doivent utiliser l’orientation paysage lors de l’affichage vidéo et ne doivent pivoter automatiquement.

Sur iOS, la vidéo de la caméra avant est mise en miroir. Elle ne l’est pas sur Android.

Sur les périphériques mobiles munis d’une caméra autofocus, l’autofocus est automatiquement activé. Si l’appareil photo ne prend pas en charge l’autofocus continu (ce qui est le cas pour de nombreux périphériques mobiles), l’appareil photo est mis au point lorsque l’objet Camera est associé à un flux vidéo et chaque fois que la méthode setMode() est appelée. Sur les ordinateurs de bureau, le comportement de l’autofocus dépend du pilote et des paramètres de la caméra.

Dans le cas d’une application AIR sur Android et iOS, la caméra ne capture pas les vidéos si l’application AIR n’est pas l’application active au premier plan. Il est en outre possible que les connexions de flux soient perdues lorsque l’application se trouve dans l’arrière-plan. Sur iOS, il est impossible d’afficher la caméra vidéo lorsqu’une application utilise le mode de rendu sur GPU. Il est toutefois possible de diffuser en continu la caméra vidéo sur un serveur.

Prise en charge du profil AIR : cette fonctionnalité n’est pas prise en charge sur les périphériques AIR pour TV. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils. Notez que pour les périphériques AIR pour TV, Camera.isSupported est true, mais Camera.getCamera() renvoie toujours null. L’accès à la caméra n’est pas pris en charge dans les navigateurs mobiles.

Pour plus d’informations sur la capture audio, voir la classe Microphone.

Important : le moteur d’exécution affiche une boîte de dialogue de confidentialité qui permet à l’utilisateur d’autoriser ou de refuser l’accès à la caméra. Assurez-vous que la taille de la fenêtre de votre application soit d’au moins 215 x 138 pixels, taille minimale requise par Flash pour afficher cette boîte de dialogue.

Pour créer ou référencer un objet Camera, utilisez la méthode getCamera().

Consulter les exemples

Plus d’exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  activityLevel : Number
[lecture seule] Quantité de mouvement détecté par la caméra.
Camera
  bandwidth : int
[lecture seule] Quantité maximale de bande passante pouvant être utilisée par la source vidéo sortante actuelle, en octets.
Camera
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  currentFPS : Number
[lecture seule] Cadence à laquelle la caméra capture des données, en images par seconde.
Camera
  fps : Number
[lecture seule] Fréquence maximale à laquelle la caméra peut capturer des données, en images par seconde.
Camera
  height : int
[lecture seule] Hauteur de capture actuelle, en pixels.
Camera
  index : int
[lecture seule] Index de base zéro qui spécifie la position de la caméra dans le tableau Camera.names, qui répertorie toutes les caméras disponibles.
Camera
  isSupported : Boolean
[statique] [lecture seule] La propriété isSupported est définie sur true si la classe Camera est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false.
Camera
  keyFrameInterval : int
[lecture seule] Nombre d’images (appelées images-clés) qui sont transmises intégralement sans être interpolées par l’algorithme de compression vidéo.
Camera
  loopback : Boolean
[lecture seule] 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).
Camera
  motionLevel : int
[lecture seule] Quantité de mouvement requis pour invoquer l’événement activity.
Camera
  motionTimeout : int
[lecture seule] 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é.
Camera
  muted : Boolean
[lecture seule] 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.
Camera
  name : String
[lecture seule] Nom de la caméra en cours, tel que renvoyé par le matériel de la caméra.
Camera
  names : Array
[statique] [lecture seule] Tableau de chaînes contenant les noms de toutes les caméras disponibles.
Camera
      permissionStatus : String
[statique] [lecture seule] Déterminez si l’application a été autorisée à utiliser la caméra.
Camera
      position : String
[lecture seule] Spécifie le côté d’un périphérique sur lequel la caméra se trouve.
Camera
  quality : int
[lecture seule] Niveau de qualité d’image requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo.
Camera
  width : int
[lecture seule] Largeur de capture actuelle, en pixels.
Camera
Méthodes publiques
 MéthodeDéfini par
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
  
Remplit un tableau d’octets à partir d’une zone rectangulaire de données de pixels. Ecrit un entier non signé (une valeur de pixel non multipliée de 32 bits) pour chaque pixel dans le tableau d’octets.
Camera
  
copyToVector(rect:Rectangle, destination:Vector.<uint>):void
Remplit un vecteur à partir d’une zone rectangulaire de données de pixels.
Camera
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
  
Copie la dernière image sur une image bitmap.
Camera
  
getCamera(name:String = null):Camera
[statique] Renvoie une référence à un objet Camera pour capturer de la vidéo.
Camera
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
  
Demande l’autorisation d’accès à la caméra pour l’application.
Camera
  
setKeyFrameInterval(keyFrameInterval:int):void
Spécifie les images qui sont transmises intégralement (images-clés) sans être interpolées par l’algorithme de compression vidéo.
Camera
  
setLoopback(compress:Boolean = false):void
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.
Camera
  
setMode(width:int, height:int, fps:Number, favorArea:Boolean = true):void
Définit le mode de capture de la caméra sur le mode natif qui remplit le mieux les conditions requises.
Camera
  
setMotionLevel(motionLevel:int, timeout:int = 2000):void
Spécifie la quantité (intensité) de mouvement requise pour distribuer l’événement activity.
Camera
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
setQuality(bandwidth:int, quality:int):void
Définit la quantité maximale de bande passante par seconde ou la qualité d’image requise pour les données vidéo sortantes actuelles.
Camera
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
  Distribué lorsqu’une caméra commence ou termine une session.Camera
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
  Distribué lorsque l’application demande l’autorisation d’utiliser la caméra sur le périphérique.Camera
  Distribué lorsqu’une caméra publie son état.Camera
  Envoyé après qu’un nouveau cadre de caméra a été traité par le moteur d’exécution et est disponible pour la copie.Camera
Détails de la propriété

activityLevel

propriété
activityLevel:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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énement. Dans le cas contraire, elle n’est pas définie.



Implémentation
    public function get activityLevel():Number

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

bandwidth

propriété 
bandwidth:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get bandwidth():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

currentFPS

propriété 
currentFPS:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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.



Implémentation
    public function get currentFPS():Number

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

fps

propriété 
fps:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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.



Implémentation
    public function get fps():Number

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

height

propriété 
height:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get height():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

index

propriété 
index:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Index de base zéro qui spécifie la position de la caméra dans le tableau Camera.names, qui répertorie toutes les caméras disponibles.



Implémentation
    public function get index():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

isSupported

propriété 
isSupported:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10.1, AIR 2

La propriété isSupported est définie sur true si la classe Camera est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false.



Implémentation
    public static function get isSupported():Boolean

keyFrameInterval

propriété 
keyFrameInterval:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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 à 300.



Implémentation
    public function get keyFrameInterval():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

loopback

propriété 
loopback:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get loopback():Boolean

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

motionLevel

propriété 
motionLevel:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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, voir l’entrée setMotionLevel().



Implémentation
    public function get motionLevel():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

motionTimeout

propriété 
motionTimeout:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get motionTimeout():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

muted

propriété 
muted:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get muted():Boolean

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

name

propriété 
name:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get name():String

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

names

propriété 
names:Array  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Tableau de chaînes contenant les noms de toutes les caméras disponibles. L’accès à ce tableau n’affiche pas la boîte de dialogue de confidentialité de Flash Player. Ce tableau indique l’index de base zéro de chaque caméra et le nombre de caméras présentes sur le système (via names.length).

L’appel de la propriété names implique un examen minutieux du matériel. Dans la plupart des cas, vous pouvez utiliser la caméra par défaut.



Implémentation
    public static function get names():Array

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

    

permissionStatus

propriété 
permissionStatus:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 24.0

Déterminez si l’application a été autorisée à utiliser la caméra.



Implémentation
    public static function get permissionStatus():String

Eléments de l’API associés

    

position

propriété 
position:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 3.0

Spécifie le côté d’un périphérique sur lequel la caméra se trouve.

Utilisez la propriété position pour déterminer si la caméra sur un périphérique mobile se trouve à l’avant ou à l’arrière du périphérique. La fonction suivante vérifie chaque caméra disponible jusqu’à ce qu’il détecte une caméra avec la position souhaitée. Si aucune caméra ne possède la position souhaitée, la caméra par défaut est renvoyée.

     function getCamera( position:String ):Camera
     {
       var camera:Camera;
       var cameraCount:uint = Camera.names.length;
      for ( var i:uint = 0; i < cameraCount; ++i )
      {
        camera = Camera.getCamera( String(i) );
        if ( camera.position == position ) return camera;
      }
      return Camera.getCamera();
     
     

Sur les périphériques mobiles, la position de la caméra est soit CameraPosition.FRONT soit CameraPosition.BACK. S’il s’avère impossible de déterminer la position de la caméra, la position est signalée comme suit : CameraPosition.UNKNOWN. Sur les plates-formes de bureau, la position est toujours CameraPosition.UNKNOWN.

Les constantes pour les valeurs valides de cette propriété sont définies dans la classe CameraPosition.



Implémentation
    public function get position():String

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

quality

propriété 
quality:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get quality():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

width

propriété 
width:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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



Implémentation
    public function get width():int

Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

Détails de la méthode

copyToByteArray

()méthode
public function copyToByteArray(rect:Rectangle, destination:ByteArray):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.4, AIR 3.4

Remplit un tableau d’octets à partir d’une zone rectangulaire de données de pixels

Écrit un entier non signé (valeur de pixel non multipliée 32 bits) pour chaque pixel dans le tableau d’octets. Le tableau est redimensionné selon le nombre d’octets nécessaire pour contenir tous les pixels.

Paramètres

rect:Rectangle — Zone rectangulaire de l’objet BitmapData en cours.
 
destination:ByteArray — ByteArray représentant les pixels dans le rectangle spécifié.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.
 
TypeError — Le paramètre rect est défini sur null.
 
TypeError — La destination est nulle.

Eléments de l’API associés

copyToVector

()méthode 
public function copyToVector(rect:Rectangle, destination:Vector.<uint>):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.4, AIR 3.4

Remplit un vecteur à partir d’une zone rectangulaire de données de pixels.

Ecrit un entier non signé (valeur de pixel non multipliée de 32 bits) pour chaque pixel dans le vecteur. Le vecteur est redimensionné selon le nombre d’entrées nécessaire pour contenir tous les pixels.

Paramètres

rect:Rectangle — Zone rectangulaire de l’objet BitmapData en cours.
 
destination:Vector.<uint> — Un vecteur.<uint> représentant les pixels dans le rectangle spécifié.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.
 
TypeError — Le paramètre rect est défini sur null.
 
TypeError — La destination est nulle.

Eléments de l’API associés

drawToBitmapData

()méthode 
public function drawToBitmapData(destination:BitmapData):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.4, AIR 3.4

Copie la dernière image sur une image bitmap.

Cette méthode copie le contenu de la dernière image sur une occurrence de BitmapData.

Paramètres

destination:BitmapData — Occurrence de l’objet BitmapData devant contenir la dernière image.


Valeur émise
ArgumentError — kInvalidBitmapDataError si la destination est trop petite

Eléments de l’API associés

getCamera

()méthode 
public static function getCamera(name:String = null):Camera

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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.

Sur les périphériques mobiles munis d’une caméra arrière et frontale, il est uniquement possible de capturer des vidéos à partir d’une seule caméra à la fois.

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. L’utilisateur peut spécifier la caméra par défaut devant être utilisée via le panneau Paramètres de la caméra (comme indiqué plus bas dans cette section).

Vous ne pouvez pas utiliser ActionScript pour définir un paramètre d’autorisation ou de refus pour l’accès à la caméra, mais vous pouvez afficher la boîte de dialogue de configuration de la caméra des paramètres d’Adobe Flash Player dans laquelle l’utilisateur peut définir l’autorisation de la caméra. Lorsqu’un fichier SWF utilisant la méthode attachCamera() tente d’associer la caméra renvoyée par la méthode getCamera() à un objet Video ou NetStream, Flash Player affiche une boîte de dialogue qui permet à 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 à la boîte de dialogue de configuration de la caméra, Flash Player renvoie un objet 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.

Dans Flash Player, l’utilisateur peut spécifier des paramètres de confidentialité permanents pour un domaine spécifique. Pour ce faire, il lui suffit de cliquer sur le bouton droit de la souris (Windows et Linux) ou de cliquer sur le bouton droit de la souris tout en maintenant la touche Contrôle enfoncée (Macintosh) sur un fichier SWF en cours de lecture, de sélectionner Paramètres, d’ouvrir la boîte de dialogue Confidentialité, puis de sélectionner Mémoriser. 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.

Remarque : la méthode attachCamera() n’invoque pas la boîte de dialogue permettant d’autoriser ou de refuser l’accès à la caméra si l’utilisateur a refusé l’accès en sélectionnant Mémoriser dans la boîte de dialogue Paramètres de Flash Player. Dans ce cas, vous pouvez demander à l’utilisateur de modifier le paramètre d’autorisation ou de refus en affichant le panneau de confidentialité de Flash Player pour l’utilisateur à l’aide de Security.showSettings(SecurityPanel.PRIVACY).

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 Security.showSettings(SecurityPanel.CAMERA).

L’analyse du matériel à la recherche de caméras exige un certain temps. Lorsque le moteur d’exécution 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 le moteur d’exécution ne détecte pas de caméra, il effectue une analyse à chaque appel de getCamera. Cela est particulièrement pratique si la caméra est désactivée. 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

name:String (default = null) — Spécifie la caméra à sélectionner, telle qu’elle est désignée à partir du tableau renvoyé par la propriété names. Dans la plupart des cas, omettez ce paramètre pour sélectionner la caméra par défaut. Pour spécifier une valeur pour ce paramètre, utilisez la représentation de chaîne de la position d’index de base zéro dans le tableau Camera.names. Par exemple, pour désigner la troisième caméra du tableau, utilisez Camera.getCamera("2").

Valeur renvoyée
Camera — Si le paramètre name n’est pas spécifié, cette méthode renvoie une référence à la caméra par défaut ou, si elle est utilisée par une autre application, à la première caméra disponible (Si plusieurs caméras sont installées, l’utilisateur peut spécifier la caméra par défaut dans le panneau Paramètres de la caméra de Flash Player.) Si aucune caméra n’est disponible ou installée, la méthode renvoie null.

Evénements
status:StatusEvent — Distribué lorsqu’une caméra publie son état. Avant d’accéder à une caméra, Flash Player affiche une boîte de dialogue de confidentialité pour permettre aux utilisateurs d’autoriser ou de refuser l’accès à leur caméra. Si la propriété code est définie 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.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Dans l’exemple suivant, une fois que l’utilisateur a autorisé l’accès la caméra, la caméra associée est utilisée pour capturer des images vidéo. Les informations concernant le flux vidéo, telles que les images en cours par seconde, sont affichées également.

La méthode Camera.getCamera() renvoie une référence à un objet camera, ou renvoie null si aucune caméra n’est disponible ni installée. L’instruction if vérifie si la caméra a été trouvée et si l’utilisateur a autorisé l’accès à la caméra. Si l’utilisateur a refusé l’accès, la propriété muted est définie sur true.

Généralement, lorsque la méthode attachCamera() est appelée, une boîte de dialogue apparaît et invite l’utilisateur à autoriser ou à refuser l’accès Flash Player à la caméra. Néanmoins, si l’utilisateur a refusé l’accès et a sélectionné l’option Mémoriser, la boîte de dialogue n’apparaît pas et rien ne s’affiche. Pour vérifier que l’utilisateur a la possibilité d’autoriser l’accès à la caméra, le champ de texte myTextField demande à l’utilisateur de cliquer sur le champ de texte afin d’appeler la boîte de dialogue Paramètres de Flash Player.

La méthode clickHandler() appelle la méthode Security.showSettings(), qui affiche le panneau PRIVACY de la boîte de dialogue Paramètres. Si l’utilisateur autorise l’accès, l’événement StatusEvent.STATUS est distribué et la valeur de la propriété code de l’événement est définie sur Camera.Unmuted (la propriété mute de l’objet de la caméra est définie sur false également).

La méthode statusHandler(), ajoutée pour écouter le changement d’état du paramètre de l’utilisateur, appelle la méthode connectCamera(), si l’utilisateur autorise l’accès. La méthode connectCamera() instancie un objet video avec la hauteur et la largeur du flux capturé. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à l’objet video, et ce dernier est ajouté à la liste d’affichage.

Un objet Timer est démarré également. Chaque seconde, un événement timer de l’objet Timer est distribué et la méthode timerHandler() est appelée. La méthode timerHandler() est affichée et met à jour plusieurs propriétés de l’objet Camera.

Remarque : pour cet exemple, la seule propriété qui change est la propriété currentFPS.

package {
    import flash.display.Sprite;
    import flash.media.Camera;
    import flash.media.Video;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.utils.Timer;
    import flash.events.TimerEvent;
    import flash.events.StatusEvent;
    import flash.events.MouseEvent;
    import flash.system.SecurityPanel;
    import flash.system.Security;

    public class Camera_getCameraExample extends Sprite {
        private var myTextField:TextField;
        private var cam:Camera;
        private var t:Timer = new Timer(1000);
        
        public function Camera_getCameraExample() {
            myTextField = new TextField();
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.selectable = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;    
        
            if (Camera.isSupported)
            {
                cam = Camera.getCamera();
                
                 if (!cam) {
                    myTextField.text = "No camera is installed.";
                    
                } else if (cam.muted) {
                    myTextField.text = "To enable the use of the camera,\n"
                                     + "please click on this text field.\n" 
                                     + "When the Flash Player Settings dialog appears,\n"
                                     + "make sure to select the Allow radio button\n" 
                                     + "to grant access to your camera.";
    
                    myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
    
                }else {
                    myTextField.text = "Connecting";
                    connectCamera(); 
                }
       
                addChild(myTextField);
    
                t.addEventListener(TimerEvent.TIMER, timerHandler);
            }else {
                myTextField.text = "The Camera class is not supported on this device.";
            }
        }

        private function clickHandler(e:MouseEvent):void {
            Security.showSettings(SecurityPanel.PRIVACY);

            cam.addEventListener(StatusEvent.STATUS, statusHandler);

            myTextField.removeEventListener(MouseEvent.CLICK, clickHandler);
        }

        private function statusHandler(event:StatusEvent):void {

            if (event.code == "Camera.Unmuted") {
                connectCamera(); 
                cam.removeEventListener(StatusEvent.STATUS, statusHandler);
            }
        }

        private function connectCamera():void {
                var vid:Video = new Video(cam.width, cam.height);
                vid.x = 10;
                vid.y = 10;
                vid.attachCamera(cam);
                addChild(vid);    

                t.start();
        }

        private function timerHandler(event:TimerEvent):void {
            myTextField.y = cam.height + 20;
            myTextField.text = "";
            myTextField.appendText("bandwidth: " + cam.bandwidth + "\n");
            myTextField.appendText("currentFPS: " + Math.round(cam.currentFPS) + "\n");
            myTextField.appendText("fps: " + cam.fps + "\n");
            myTextField.appendText("keyFrameInterval: " + cam.keyFrameInterval + "\n");
        }
    }
}

    requestPermission

()méthode 
public function requestPermission():void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 24.0

Demande l’autorisation d’accès à la caméra pour l’application.


Evénements
PermissionStatus:PermissionEvent — distribué lorsque l’autorisation demandée est accordée/refusée par l’utilisateur.

setKeyFrameInterval

()méthode 
public function setKeyFrameInterval(keyFrameInterval:int):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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

keyFrameInterval:int — Valeur spécifiant les images qui sont transmises intégralement (images-clés) sans être interpolées par l’algorithme de compression vidéo. La valeur 1 signifie que chaque image est une image-clé, 3 qu’une image sur trois est une image-clé, etc. Les valeurs gérées sont comprises entre 1 et 48.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

setLoopback

()méthode 
public function setLoopback(compress:Boolean = false):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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

compress:Boolean (default = false) — Indique s’il est nécessaire d’utiliser un flux vidéo compressé (true) ou non (false) pour un visionnage local des données reçues par la caméra.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

setMode

()méthode 
public function setMode(width:int, height:int, fps:Number, favorArea:Boolean = true):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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, le moteur d’exécution 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, le moteur d’exécution 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, le moteur d’exécution tente de conserver le format demandé 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, le moteur d’exécution définit la largeur et la hauteur sur 288. Ce faisant, le moteur d’exécution conserve le format 1/1 que vous avez demandé.

Pour déterminer les valeurs affectées à ces propriétés une fois la sélection, par le moteur d’exécution, 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, voir la méthode NetStream.attachCamera().

Paramètres

width:int — Largeur de capture demandée, en pixels. La valeur par défaut est 160.
 
height:int — Hauteur de capture demandée, en pixels. La valeur par défaut est 120.
 
fps:Number — Cadence à laquelle la caméra doit capturer des données, en images par seconde. La valeur par défaut est 15.
 
favorArea:Boolean (default = true) — Indique comment manipuler la largeur, la hauteur et la cadence si la caméra n’est pas dotée d’un mode natif qui remplit les conditions requises. La valeur par défaut est true, ce qui signifie que le maintien de la taille de capture est favorisé ; l’utilisation de ce paramètre permet de sélectionner le mode qui correspond le mieux aux valeurs width et height, même si cela affecte les performances en réduisant la cadence. Pour optimiser la cadence au détriment de la hauteur et de la largeur de la caméra, définissez le paramètre false sur favorArea.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Dans l’exemple suivant, lorsqu’un utilisateur clique sur la Scène, la vidéo est redimensionnée et le taux de capture des images par seconde est défini sur une nouvelle valeur.

La Scène est définie de façon à ne pas être redimensionnée. La méthode Camera.getCamera() renvoie une référence à un objet camera, ou renvoie null si aucune caméra n’est disponible ni installée. Si une caméra existe, la méthode connectCamera() est appelée. La méthode connectCamera() instancie un objet video. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à l’objet video, et ce dernier est ajouté à la liste d’affichage. Un écouteur d’événement est défini également pour un événement MouseEvent.CLICK. Une fois que l’utilisateur a cliqué sur la Scène, la méthode clickHandler() est invoquée. La méthode vérifie la largeur de la vidéo capturée et définit la largeur, la hauteur, et le taux demandé d’images par seconde du mode de capture de la caméra. L’objet video doit être supprimé et recréé pour que ces paramètres soient appliqués. La hauteur et la largeur de la vidéo doivent également être définies sur la hauteur et la largeur de l’objet de la caméra.

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

    public class Camera_setModeExample extends Sprite {
        private var cam:Camera;
        private var vid:Video;

        public function Camera_setModeExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;

            cam = Camera.getCamera();
            
            if (!cam) {
                trace("No camera is installed.");
            }else {
                connectCamera();
            }
        }

        private function connectCamera():void {
            vid = new Video();
            vid.width = cam.width;
            vid.height = cam.height; 
            vid.attachCamera(cam);
            addChild(vid);    

            stage.addEventListener(MouseEvent.CLICK, clickHandler);
        }
    
        private function clickHandler(e:MouseEvent):void {

            switch (cam.width) {
                case 160:
                cam.setMode(320, 240, 10); 
                break;
                case 320:
                cam.setMode(640, 480, 5); 
                break;
                default:
                cam.setMode(160, 120, 15); 
                break;
            } 

            removeChild(vid);           
            connectCamera();
        }
    }
}

setMotionLevel

()méthode 
public function setMotionLevel(motionLevel:int, timeout:int = 2000):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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 le moteur d’exécution 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

motionLevel:int — Spécifie la quantité (intensité) de mouvement requise pour distribuer l’événement activity. Les valeurs gérées sont comprises entre 0 et 100. La valeur par défaut est 50.
 
timeout:int (default = 2000) — Indique le nombre de millisecondes qui doit s’écouler sans activité avant que le moteur d’exécution ne considère que l’activité a cessé et distribue l’événement activity. La valeur par défaut est 2 000 millisecondes (2 secondes).


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Dans l’exemple suivant, la caméra de l’utilisateur est utilisée comme moniteur ou caméra de surveillance. La caméra détecte le mouvement et un champ de texte affiche le niveau d’activité (l’exemple peut être étendu pour émettre une alarme ou envoyer un message via un service Web à d’autres applications).

La méthode Camera.getCamera() renvoie une référence à un objet camera, ou renvoie null si aucune caméra n’est disponible ni installée. L’instruction if vérifie si une caméra est disponible, et appelle la méthode connectCamera() lorsqu’elle est disponible. La méthode connectCamera() instancie un objet video avec la hauteur et la largeur du flux capturé. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à l’objet video, et ce dernier est ajouté à la liste d’affichage. Généralement, lorsque la méthode attachCamera() est appelée, une boîte de dialogue apparaît et invite l’utilisateur à autoriser ou à refuser l’accès Flash Player à la caméra. Néanmoins, si l’utilisateur a refusé l’accès et a sélectionné l’option Mémoriser, la boîte de dialogue n’apparaît pas et rien n’est affiché. Pour vérifier que l’utilisateur a la possibilité d’autoriser l’accès à la caméra, utilisez la méthode system.Security.showSettings() pour appeler la boîte de dialogue Paramètres de Flash Player.

La méthode setMotionLevel() définit le niveau d’activité (quantité de mouvement) avant que l’événement activity soit appelé, sur cinq, pour un mouvement minimal. Le délai qui s’écoule entre le moment où la caméra arrête de détecter le mouvement et le moment où l’événement activity est appelé, est défini sur 1 seconde (1 000 millisecondes). Après 1 seconde d’inactivité ou si le niveau d’activité atteint cinq, l’événement ActivityEvent.ACTIVITY est distribué et la méthode activityHandler() est invoquée. Si l’événement a été déclenché par le niveau d’activité, la propriété activating est définie sur true et un objet Timer est démarré. Chaque seconde, un événement timer de l’objet Timer est distribué et la méthode timerHandler() est invoquée, ce qui affiche le niveau d’activité en cours (même si un niveau de cinq ou supérieur déclenche la minuterie, le niveau d’activité en cours affiché peut être une valeur inférieure).

package {
    import flash.display.Sprite;
    import flash.media.Camera;
    import flash.media.Video;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.utils.Timer;
    import flash.events.TimerEvent;
    import flash.events.ActivityEvent;

    public class Camera_setMotionLevelExample extends Sprite {
        private var myTextField:TextField;
        private var cam:Camera;
        private var t:Timer = new Timer(1000);

        public function Camera_setMotionLevelExample() {
            myTextField = new TextField();
            myTextField.background = true;
            myTextField.selectable = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;    
        
            cam = Camera.getCamera();
            
            if (!cam) {
                myTextField.text = "No camera is installed.";

            }else {
                myTextField.text = "Waiting to connect.";
                connectCamera(); 
            }

            addChild(myTextField);

            t.addEventListener(TimerEvent.TIMER, timerHandler);
        }

        private function connectCamera():void {
                var vid:Video = new Video(cam.width, cam.height);
                vid.x = 10;
                vid.y = 10;
                vid.attachCamera(cam);
                addChild(vid);    

                cam.setMotionLevel(5, 1000);
                cam.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
        }

        private function activityHandler(e:ActivityEvent):void {
            if (e.activating == true) {
                t.start();    
            } else {
                myTextField.text = "Everything is quiet.";
                t.stop();
            }    
        }

        private function timerHandler(event:TimerEvent):void {
             myTextField.x = 10;
             myTextField.y = cam.height + 20;
             myTextField.text = "There is some activity. Level: " + cam.activityLevel;
        }
    }
}

setQuality

()méthode 
public function setQuality(bandwidth:int, quality:int):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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. Le moteur d’exécution transmet une vidéo de qualité optimale dans la bande passante spécifiée. Si nécessaire, le moteur d’exécution 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. Le moteur d’exécution utilise autant de bande passante que nécessaire pour conserver la qualité spécifiée. Si nécessaire, le moteur d’exécution 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. Le moteur d’exécution 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, le moteur d’exécution réduit la fréquence pour conserver la qualité de l’image sans dépasser la bande passante spécifiée.

Paramètres

bandwidth:int — Spécifie la quantité maximale de bande passante pouvant être utilisée par la vidéo sortante actuelle, en octets par seconde. Pour spécifier que la vidéo peut utiliser autant de bande passante que nécessaire pour conserver la valeur de quality, attribuez la valeur 0 à bandwidth. La valeur par défaut est 16384.
 
quality:int — Entier spécifiant le niveau de qualité d’image requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo. Les valeurs acceptables sont comprises entre 1 (qualité la plus médiocre, compression maximale) et 100 (qualité optimale, pas de compression). Pour spécifier que la qualité d’image peut varier autant que nécessaire afin d’éviter un dépassement de la bande passante disponible, attribuez la valeur 0 à quality.


Valeur émise
PermissionError — L’application ne dispose pas de l’autorisation nécessaire pour utiliser la caméra.

Eléments de l’API associés

Détails de l’événement

activity

Evénement
Type d’objet d’événement: flash.events.ActivityEvent
propriété ActivityEvent.type = flash.events.ActivityEvent.ACTIVITY

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

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.

La constante ActivityEvent.ACTIVITY définit la valeur de la propriété type d’un objet événement activity.

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

PropriétéValeur
activatingtrue si le périphérique est activé ou false s’il est désactivé.
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet commençant ou terminant une session, tel qu’un objet Camera ou Microphone.
    

permissionStatus

Evénement  
Type d’objet d’événement: flash.events.PermissionEvent
propriété PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 24.0

Distribué lorsque l’application demande l’autorisation d’utiliser la caméra sur le périphérique. Vérifiez la valeur de la propriété status pour déterminer si l’autorisation a été accordée ou refusée.

Eléments de l’API associés

status

Evénement  
Type d’objet d’événement: flash.events.StatusEvent
propriété StatusEvent.type = flash.events.StatusEvent.STATUS

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 9, AIR (unsupported)

Distribué lorsqu’une caméra publie son état. Avant d’accéder à une caméra, le moteur d’exécution affiche une boîte de dialogue de confidentialité pour permettre aux utilisateurs d’autoriser ou de refuser l’accès à leur caméra. Si la propriété code est définie 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.

Remarque : cet événement n’est pas distribué sur la plate-forme AIR. Il est utilisé uniquement dans Flash Player.

Définit la valeur de la propriété type d’un objet événement status.

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

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
codeDescription de l’état de l’objet.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
levelCatégorie du message, telle que "status", "warning" ou "error".
targetObjet publiant son état.

Eléments de l’API associés

videoFrame

Evénement  
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.VIDEO_FRAME

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.4, AIR 3.4

Envoyé après qu’un nouveau cadre de caméra a été traité par le moteur d’exécution et est disponible pour la copie.

La constante Event.VIDEO_FRAME définit la valeur de la propriété type d’un objet d’événement videoFrame.

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

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
targetObjet Camera ayant distribué cet événement.

Eléments de l’API associés

CameraExample.as

L’exemple suivant montre l’image provenant d’une caméra après avoir pris connaissance de l’avertissement de sécurité. La scène est définie de telle sorte qu’il est impossible de la redimensionner, elle est alignée sur le coin supérieur gauche de la fenêtre du lecteur. L’événement activity est distribué au début et à la fin (si elle existe) de la session, et elle est capturée par la méthode activityHandler() qui imprime les informations concernant l’événement.

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




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.