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+newline;
status_ta.text += "You have "+microphone_array.length+" device(s) installed."+newline+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

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001463.html