MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference, Page: 456 / 1104

456 Chapter 2: ActionScript Language Reference
Microphone.names
Availability
Flash Player 6.
Usage
Microphone.names :Array
Note: The correct syntax is
Microphone.names
. To assign the return value to a variable, use syntax like
mic_array = Microphone.names
. To determine the name of the current microphone, use
active_mic .name
.
Description
Read-only class property; retrieves an array of strings reflecting the names of all available sound
capture devices without displaying the Flash Player Privacy Settings panel. This array behaves the
same as any other ActionScript array, implicitly providing the zero-based index of each sound
capture device and the number of sound capture devices on the system (by means of
Microphone.names.length
). For more information, see the Array class entry.
Calling
Microphone.names
requires an extensive examination of the hardware, and it may take
several seconds to build the array. In most cases, you can just use the default microphone.
Example
The following example displays information about the sound capturing device(s) on your
computer system, including an array of names and the default device.
var status_ta:mx.controls.TextArea;
status_ta.html = false;
status_ta.setStyle("fontSize", 9);
var microphone_array:Array = Microphone.names;
var active_mic:Microphone = Microphone.get();
status_ta.text = "The default device is: "+active_mic.name+newline;
status_ta.text += "You have "+microphone_array." device(s)
installed."+newline;
for (var i = 0; i<microphone_array.length; i++) {
status_ta.text += "["+i+"] "+microphone_array[i]+newline;
}
For example, the following information could be displayed:
The default device is: Logitech USB Headset
You have 2 device(s) installed.
[0] Logitech USB Headset
[1] YAMAHA AC-XG WDM Audio
See also
Array class , Microphone.name