MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY Spécifications télécharger pdf (Page 232)

Client-Side Communication ActionScript 41

Microphone.get

Availability

• Flash Player 6.

• Flash Communication Server MX (not required).

Usage

Microphone.get([index])

Note: The correct syntax is Microphone.get(). To assign the Microphone object to a variable, use syntax like

activeMicrophone = Microphone.get().

Parameters

index An optional zero-based integer that specifies which microphone to get, as determined

from the array returned by

Microphone.names. To get the default microphone (which is

recommended for most applications), omit this parameter.

Returns

• If index is not specified, this method returns a reference to the default microphone or, if it is

not available, to the first available microphone. If no microphones are available or installed, the

method returns

null.

• If index is specified, this method returns a reference to the requested microphone, or null if it

is not available.

Description

Method; returns a reference to a Microphone object for capturing audio. To actually begin

capturing the audio, you must attach the Microphone object either to a MovieClip object (see

MovieClip.attachAudio) or to a NetStream object (see NetStream.attachAudio). (The

NetStream object is available only with Flash Communication Server.)

Unlike objects that you create using the

new constructor, multiple calls to Microphone.get

reference the same microphone. Thus, if your script contains the lines

mic1 = Microphone.get() and mic2 = Microphone.get(), both mic1 and mic2 reference the

same (default) microphone.

In general, you shouldn’t pass a value for

index; simply use Microphone.get() to return a

reference to the default microphone. By means of the Microphone settings panel (discussed later

in this section), the user can specify the default microphone Flash should use. If you pass a value

for

index, you might be trying to reference a microphone other than the one the user prefers. You

might use

index in rare cases—for example, if your application is capturing audio from two

microphones at the same time.

1 2 ... 227 228 229 230 231 232 233 234 235 236 237 ... 368 369

Pas de commentaire

MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY Spécifications Page 232