Microphone  - AS3

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

如果麦克风 muted 属性为 true，此属性的值始终为 -1。

相关 API 元素

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

如果使用 Nellymoser 编解码器，可使用 Microphone.rate() 设置采样率。如果使用 Speex 编解码器，则采样率会设置为 16 kHz。

Speex 具有语音活动检测功能 (VAD)，在未检测到语音时将自动减小带宽。使用 Speex 编解码器时，Adobe 建议将静音级别设置为 0。要设置静音级别，请使用 Microphone.setSilenceLevel() 方法。

相关 API 元素

启用 Speex 语音活动检测。

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

相关 API 元素

控制增强的麦克风选项。有关详细信息，请参阅 MicrophoneEnhancedOptions 类。对于非增强的 Microphone 实例，此属性被忽略。

相关 API 元素

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

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

麦克风放大信号的程度。有效值为 0 到 100。默认值为 50。

相关 API 元素

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

相关 API 元素

如果当前平台支持 Microphone 类，则 isSupported 属性设置为 true，否则，设置为 false。

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

相关 API 元素

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

相关 API 元素

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

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

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

相关 API 元素

Speex 编码器使用的最大噪音衰减分贝数（负数）。如果启用，则在从 Microphone 捕获的声音进行 Speex 压缩之前应用噪音抑制。设置为 0 以禁用噪音抑制。默认启用噪音抑制，最大衰减为 -30 dB。选择 Nellymoser 编解码器时被忽略。

确定应用程序是否已被授予麦克风使用权限。

相关 API 元素

麦克风捕获声音时使用的速率，单位是 kHz。可接受的值为 5、8、11、22 和 44。如果您的声音捕获设备支持 8 kHz，则默认值为 8 kHz。否则，默认值是您的声音捕获设备支持的高于 8 kHz 的下一个可用捕获级别，通常为 11 kHz。

注意：实际速率与下表中注明的 rate 值稍有不同：

相关 API 元素

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

相关 API 元素

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

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

相关 API 元素

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

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

相关 API 元素

返回对可以执行回音消除功能的增强的 Microphone 对象的引用。使用回音消除功能可创建不需要耳机的音频/视频聊天应用程序。

Microphone.getEnhancedMicrophone() 方法和 Microphone.getMicrophone() 方法的 index 参数的工作方式相同。

要在 Android 上使用此方法，需在应用程序描述符的 Android 清单添加项下添加 MODIFY_ AUDIO_ SETTINGS 权限。

重要说明：在任何给定时间，您只能具有单个增强麦克风设备实例。所有其他 Microphone 实例都将停止提供音频数据，并且将收到 code 属性为 Microphone.Unavailable 的 StatusEvent。当增强的音频初始化失败时，调用此方法将返回 null，为 Microphone.enhancedOptions 设置值没有效果，并且所有现有 Microphone 实例的工作方式保持不变。

若要配置增强的 Microphone 对象，请设置 Microphone.enhancedOptions 属性。下面的代码在本地测试中使用增强的 Microphone 对象和全双工回音消除功能：

	     var mic:Microphone = Microphone.getEnhancedMicrophone();
	     var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions();
	     options.mode = MicrophoneEnhancedMode.FULL_DUPLEX;
	     mic.enhancedOptions = options;
	     mic.setLoopBack(true);
	 

在使用回音消除功能时，将忽略 setUseEchoSuppression() 方法。

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

参数

相关 API 元素

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

多个对 Microphone.getMicrophone() 的调用引用相同的麦克风。因此，如果您的代码包含 mic1 = Microphone.getMicrophone() 和 mic2 = Microphone.getMicrophone() 行，那么 mic1 和 mic2 都会引用相同的（默认）麦克风。

通常，不应传递 index 的值。只需调用 air.Microphone.getMicrophone() 即可返回对默认麦克风的引用。使用 Flash Player 设置面板的“麦克风设置”部分，用户可以指定应用程序应该使用的默认麦克风。（用户通过右键单击在 Web 浏览器中运行的 Flash Player 内容来访问 Flash Player 设置面板。）如果您为 index 传递一个值，您可以引用与用户选择的麦克风不同的麦克风。在极少数情况下（例如，应用程序同时从两个麦克风捕获音频），您可能会使用 index。在 Adobe AIR 中运行的内容也使用默认麦克风的 Flash Player 设置。

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

当 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()。

参数

相关 API 元素

var mic:Microphone = Microphone.getMicrophone();
mic.setLoopBack();
mic.addEventListener(StatusEvent.STATUS, mic_status);
 
var tf:TextField = new TextField();
tf.autoSize = TextFieldAutoSize.LEFT;
tf.text = "Detecting microphone...";
addChild(tf);
 
function mic_status(evt:StatusEvent):void {
    tf.text = "Microphone is muted?: " + mic.muted;
    switch (evt.code) {
        case "Microphone.Unmuted":
            tf.appendText("\n" + "Microphone access was allowed.");
            break;
        case "Microphone.Muted":
            tf.appendText("\n" + "Microphone access was denied.");
            break;
    }
}

为应用程序申请麦克风权限。

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

参数

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

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

Speex 具有语音活动检测功能 (VAD)，在未检测到语音时将自动减小带宽。使用 Speex 编解码器时，Adobe 建议将静音级别设置为 0。

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

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

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

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

参数

相关 API 元素

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

回音抑制是指降低音频回馈效果，当扬声器发出的声音由同一系统上的麦克风拾取时，将导致音频回馈。（这不同于回音消除，后者会完全移除反馈。在调用 getEnhancedMicrophone() 方法以使用回音消除功能时，将忽略 setUseEchoSuppression() 方法。）

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

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

参数

相关 API 元素

有两个侦听器用于侦听 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);
        }
    }
}