User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

451

452

453

454

455

456

457

458

459

460

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+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