16
Client-Side ActionScript Language Reference
Unlike objects that you create using the
new
constructor, multiple calls to
Camera.get()
reference the same camera driver. Thus, if your script contains the lines
cam1 = Camera.get()
and
cam2 = Camera.get()
, both
cam1
and
cam2
reference the same
(default) camera driver.
In general, you shouldn’t pass a value for
index
; simply use
Camera.get()
to return a
reference to the default camera driver. By means of the Camera settings panel (discussed later
in this section), the user can specify the default camera driver Flash should use. If you pass a
value for
index
, you might be trying to reference a camera driver other than the one the user
prefers. You might use
index
in rare cases—for example, if your application is capturing video
from two cameras at the same time.
When a SWF file tries to access the camera returned by
Camera.get()
—for example, when
you issue
NetStream.attachVideo()
or
Video.attachVideo()
—Flash Player displays a
Privacy dialog box that lets the user choose whether to allow or deny access to the camera.
(Make sure your Stage size is at least 215 by 138 pixels; this is the minimum size Flash
requires to display the dialog box.)
When the user responds to this dialog box, the
Camera.onStatus
event handler returns an
information object that indicates the user’s response. To determine whether the user has
denied or allowed access to the camera without processing this event handler, use
Camera.muted
.
The user can also specify permanent privacy settings for a particular domain by right-clicking
(Windows) or Control-clicking (Macintosh) while a SWF file is playing and selecting
Settings. When the Privacy dialog box opens, the user selects Remember.
You can’t use ActionScript to set the Allow or Deny value for a user, but you can display the
Privacy dialog box for the user by using
System.showSettings(0)
. If the user selects
Remember, Flash Player no longer displays the Privacy dialog box for SWF files from this
domain.
If
Camera.get()
returns
null
, either the camera is in use by another application, or there are
no cameras installed on the system. To determine whether any cameras are installed, use
Camera.names.length
. To display the Flash Player Camera Settings panel, which lets the
user choose the camera driver to be referenced by
Camera.get()
, use
System.showSettings(3)
.