User Guide

462 Chapter 2: ActionScript Language Reference
Microphone.setRate()
Availability
Flash Player 6.
Usage
active_mic.setRate(kHz:Number) : Void
Parameters
kHz
The rate at which the microphone should capture sound, in kHz. Acceptable values are 5,
8, 11, 22, and 44. The default value is 8 kHz if your sound capture device supports this value.
Otherwise, the default value is the next available capture level above 8 kHz that your sound
capture device supports, usually 11 kHz.
Returns
Nothing.
Description
Method; sets the rate, in kHz, at which the microphone should capture sound.
Example
The following example sets the microphone rate to the user’s preference (which you have assigned
to the
userRate variable) if it is one of the following values: 5, 8, 11, 22, or 44. If it is not, the
value is rounded to the nearest acceptable value that the sound capture device supports.
active_mic.setRate(userRate);
The following example lets you use a ComboBox instance, called rate_cb, to change the rate at
which your microphone captures sound. The current rate displays in a Label instance called
rate_lbl.
this.createEmptyMovieClip("sound_mc", this.getNextHighestDepth());
var active_mic:Microphone = Microphone.get();
sound_mc.attachAudio(active_mic);
var rate_array:Array = new Array(5, 8, 11, 22, 44);
rate_cb.dataProvider = rate_array;
rate_cb.labelFunction = function(item:Object) {
return (item+" kHz");
};
for (var i = 0; i<rate_array.length; i++) {
if (rate_cb.getItemAt(i) == active_mic.rate) {
rate_cb.selectedIndex = i;
break;
}
}
function changeRate() {
active_mic.setRate(rate_cb.selectedItem);
rate_lbl.text = "Current rate: "+active_mic.rate+" kHz";
}
rate_cb.addEventListener("change", changeRate);
rate_lbl.text = "Current rate: "+active_mic.rate+" kHz";