麦克风正在检测的音量。值的范围为 0（未检测到声音）到 100（检测到非常大的声音）。此属性的值有助于确定向 Microphone.setSilenceLevel() 方法传递的适当值。

如果麦克风可用，但却因为尚未调用 Microphone.getMicrophone() 而未被使用，则此属性设置为 -1。

另请参见

要用于压缩音频的编解码器。使用的默认编解码器为 Nellymoser 编解码器。枚举类 SoundCodec 包含各种对 codec 属性有效的值。

另请参见

使用 Speex 编解码器时的编码语音品质。可能值为从 0 到 10 的值。默认值为 6。数字越大，表示品质越高，但需要更多的带宽，如下表所示。列出的比特率值表示净比特率，并不包括信息分包开销。

另请参见

在一个包（消息）中传输的 Speex 语音帧的数目。每帧长 20 ms。默认值为每个包两帧。

消息中包含的 Speex 帧越多，需要的带宽就越小，但发送消息延迟的时间就越长。Speex 帧越少，需要的带宽就越大，而延迟的时间就会越短。

麦克风增益，即麦克风在传送信号之前将信号放大的倍数。值为 0 指示 Flash Player 将其乘以 0；即麦克风不传送声音。

您可以将此设置想象为立体声音响上的音量旋钮：0 表示没有音量，50 表示正常音量。 小于 50 的数字表示低于正常音量，大于 50 的数字表示高于正常音量。有效值为 0 到 100，默认值为 50。用户可以在 Flash Player 的“麦克风设置”面板中更改此值。

另请参见

麦克风的索引，它反映在 Microphone.names 返回的数组中。

另请参见

指定用户是已经拒绝对麦克风的访问 (true) 还是已经允许对麦克风的访问 (false)。当该值发生变化时，将调度 status 事件。有关详细信息，请参阅 Microphone.getMicrophone()。

另请参见

当前声音捕获设备的名称，它由声音捕获硬件返回。

另请参见

包含所有可用声音捕获设备名称的字符串数组。返回名称，但不必向用户显示 Flash Player 的“专用设置”面板。此数组通过 Microphone.names.length 属性提供每个声音捕获设备的从零开始的索引和系统上声音捕获设备的数量。有关详细信息，请参阅 Array 类条目。

调用 Microphone.names 要求全面检查硬件，并可能需要几秒钟时间才能生成数组。大多数情况下，使用默认麦克风即可。

注意：若要确定当前麦克风的名称，请使用 name 属性。

另请参见

麦克风捕获声音时使用的频率，单位是 kHz。允许的值是声音设备支持的任何以下值：5、8、11、22 或 44。

如果您的声音捕获设备支持 8 kHz，则默认值为 8 kHz。否则，默认值为您的声音捕获设备支持且高于 8 kHz 的下一个可用捕获级别，通常为 11 kHz。

激活麦克风并调度 activity 事件所需的音量。默认值为 10。

另请参见

麦克风停止检测声音的时间和调度 activity 事件的时间之间相差的毫秒数。默认值为 2000（2 秒）。

若要设置此值，请使用 Microphone.setSilenceLevel() 方法。

另请参见

在此麦克风对象处于环回模式时，控制它的声音。

如果启用了回音抑制，则设置为 true；否则，设置为 false。除非用户已经在 Flash Player 的“麦克风设置”面板中选择了“降低回音”，否则默认值为 false。

另请参见

返回对用于捕获音频的 Microphone 对象的引用。若要开始捕获音频，您必须将 Microphone 对象附加到 NetStream 对象（请参阅 NetStream.attachAudio()）。

对 Microphone.get() 的多次调用会引用同一个麦克风。因此，如果代码包含 mic1 = Microphone.get() 和 mic2 = Microphone.get() 行，则 mic1 和 mic2 将引用同一个（默认）麦克风。

如果要获取默认的麦克风，则需要使用 -1 调用 getMicrophone()。如果调用此方法时不使用任何参数，则会返回列表中的第一个麦克风。

可以使用 index 属性来获取当前 Microphone 对象的索引值。然后，可以将该值传递给 Microphone 类的其它方法。

通常，不应传递 index 的值。只需使用 Microphone.getMicrophone() 方法即可返回对默认麦克风的引用。通过使用“麦克风设置”面板，用户可以指定应用程序应使用的默认麦克风。如果传递 index 的值，则可能会引用非用户选择的其它麦克风。在极少数情况下（例如，应用程序同时从两个麦克风捕获音频），您可能会使用 index。

当 SWF 文件尝试访问 Microphone.getMicrophone() 返回的对象时（例如，在调用 NetStream.attachAudio() 时），Flash Player 将显示“隐私”对话框，用户可从中选择是允许还是拒绝访问麦克风。（确保舞台大小至少为 215 x 138 个像素；这是 Flash Player 显示该对话框所需的最小大小。）

当用户对此对话框做出响应时，将调度 status 事件以指示用户的响应。还可以检查 Microphone.muted 属性以确定用户是允许还是拒绝访问麦克风。

如果 Microphone.getMicrophone() 返回 null，则表明麦克风正由其他应用程序使用，或者系统上没有安装任何麦克风。若要确定是否安装了任何麦克风，请使用 Microphones.names.length。若要显示 Flash Player 的“麦克风设置”面板（用户可从中选择 Microphone.getMicrophone 所引用的麦克风），请使用 Security.showSettings()。

参数

另请参见

将麦克风捕获的音频传送到本地扬声器。

参数

设置可认定为有声的最低音量输入水平，以及实际静音前需经历的无声时间长度(可选)。

• 若要完全禁止麦克风检测声音，请为 silenceLevel 传递值 100；这样就决不会再调度 activity 事件了。
• 若要确定麦克风当前所检测的音量，请使用 Microphone.activityLevel。

活动检测是检测声音级别在何时表示某人正在谈话的功能。当某人没有谈话时，由于不需要发送关联的音频流，因此可以节约带宽。此信息也可用于视频反馈，以便让用户知道他们（或其他人）没有谈话。

静音值与活动值直接对应。完全静音对应于活动值 0。持续噪音（根据当前增益设置可以检测到的噪音）对应于活动值 100。当增益得到适当调整之后，在您没有说话时，活动值将小于静音值；在您说话时，活动值将大于静音值。

此方法与 Camera.setMotionLevel() 类似；这两种方法都用于指定何时调度 activity 事件。不过，这两种方法在对发布流的影响上具有显著的差异：

• Camera.setMotionLevel() 设计用于检测运动，并且不影响带宽用量。即使视频流未检测到运动，仍将发送视频。
• Microphone.setSilenceLevel() 设计用于优化带宽。在认为音频流被静音时，不发送任何音频数据。而改为发送一条指示静音已启动的消息。

参数

另请参见

指定是否使用音频编解码器的回音抑制功能。除非用户已经在 Flash Player 的“麦克风设置”面板中选择了“降低回音”，否则默认值为 false。

回音抑制是指降低音频回馈效果，当扬声器发出的声音由同一台计算机上的麦克风拾取时，将导致音频回馈。（这不同于回音消除，后者完全消除回馈。）

通常情况下，当通过同一台计算机上的扬声器（而不是耳机）播放所捕获的声音时，建议使用回音抑制。如果您的 SWF 文件允许用户指定声音输出设备，则当他们指定使用扬声器并且还将使用麦克风时，您可能需要调用 Microphone.setUseEchoSuppression(true)。

用户也可以在 Flash Player 的“麦克风设置”面板中调整这些设置。

参数

另请参见

在麦克风开始或结束会话时调度。

若要指定触发 activating 属性值为 true 的此事件所需的音量，或者指定在没有声音的情况下经过多长时间才会触发 activating 属性值为 false 的此事件，请使用 Microphone.setSilenceLevel()。

此事件具有以下属性：

另请参见

在麦克风报告其状态时调度。如果 code 属性的值为“Microphone.Muted”，则表示用户拒绝 SWF 文件访问麦克风。如果 code 属性的值为“Microphone.Unmuted”，则表示用户允许 SWF 文件访问麦克风。

此事件具有以下属性：

另请参见

有两个侦听器用于侦听 activity 和 status 事件。activity 事件在会话开始和结束（如果有）时被调度，并由 activityHandler() 方法捕获（此方法跟踪有关该事件的信息）。status 事件在附加的 Microphone 对象报告任何状态信息时被调度；将使用 statusHandler() 方法捕获并跟踪此信息。

注意：必须将麦克风与计算机连接，此示例才能正常运行。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Microphone;
    import flash.system.Security;

    public class MicrophoneExample extends Sprite {
        public function MicrophoneExample() {
            var mic:Microphone = Microphone.getMicrophone();
            Security.showSettings("2");
            mic.setLoopBack(true);
                    
            if (mic != null) {
                mic.setUseEchoSuppression(true);
                mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                mic.addEventListener(StatusEvent.STATUS, statusHandler);
            }
        }

        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }

        private function statusHandler(event:StatusEvent):void {
            trace("statusHandler: " + event);
        }
    }
}