ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with cameras
Displaying camera content on screen
Flash Player 9 and later, Adobe AIR 1.0 and later
Connecting to a camera can require less code than using the NetConnection and NetStream classes to load a video.
The camera class can also quickly become tricky because with Flash Player, you need a user’s permission to connect to
their camera before you can access it.
The following code demonstrates how you can use the Camera class to connect to a user’s local camera:
var cam:Camera = Camera.getCamera();
var vid:Video = new Video();
vid.attachCamera(cam);
addChild(vid);
Note: The Camera class does not have a constructor method. In order to create a new Camera instance you use the static
Camera.getCamera() method.
Designing your camera application
Flash Player 9 and later, Adobe AIR 1.0 and later
When writing an application that connects to a user’s camera, you need to account for the following in your code:
Check if the user has a camera currently installed. Handle the case where no camera is available.
For Flash Player only, check if the user has explicitly allowed access to the camera. For security reasons the player
displays the Flash Player Settings dialog which lets the user allow or deny access to their camera. This prevents Flash
Player from connecting to a user’s camera and broadcasting a video stream without their permission. If a user clicks
allow, your application can connect to the user’s camera. If the user clicks deny, your application will be unable to
access the user’s camera. Your applications should always handle both cases gracefully.
For AIR only, check whether the Camera class is supported for the device profiles supported by your application.
The Camera class is not supported in mobile browsers.
The Camera class is not supported in mobile AIR apps that use the GPU rendering mode.
On iOS, only one camera can be active at a time.
More Help topics
Christophe Coenraets: Multi-User Video Tic-Tac-Toe
Mark Doherty: Android Radar app (source)
Connecting to a user’s camera
Flash Player 9 and later, Adobe AIR 1.0 and later
The first step when connecting to a user’s camera is to create a new camera instance by creating a variable of type
Camera and initializing it to the return value of the static Camera.getCamera() method.
Last updated 6/6/2012
521