Microphone  - AS3

마이크가 감지하는 사운드 크기입니다. 값은 0(사운드가 감지되지 않음)부터 100(매우 큰 사운드가 감지됨)까지입니다. 이 속성 값은 Microphone.setSilenceLevel() 메서드에 전달할 최적 값을 계산할 때 유용합니다.

마이크 muted 속성이 true인 경우 이 속성의 값은 항상 -1입니다.

관련 API 요소

오디오 압축에 사용할 코덱입니다. 사용할 수 있는 코덱은 Nellymoser(기본값)와 Speex입니다. 열거형 클래스 SoundCodec에는 codec 속성에 유효한 여러 값이 포함되어 있습니다.

Nellymoser 코덱을 사용할 경우 Microphone.rate()를 사용하여 샘플 속도를 설정할 수 있습니다. Speex 코덱을 사용할 경우 샘플 속도는 16kHz로 설정됩니다.

Speex에는 VAD(음성 활동 검출) 기능이 있어 음성이 검출되지 않을 때 대역폭이 자동으로 낮아집니다. 따라서 Speex 코덱을 사용하는 경우에는 묵음 레벨을 0으로 설정하는 것이 좋습니다. 묵음 레벨을 설정하려면 Microphone.setSilenceLevel() 메서드를 사용합니다.

관련 API 요소

Speex 음성 활동 검출을 사용하도록 설정합니다.

Speex 코덱을 사용할 때의 인코딩된 음성 품질입니다. 가능한 값은 0에서 10 사이입니다. 기본값은 6입니다. 다음 표와 같이 숫자가 크면 품질이 높아지지만 대역폭이 더 많이 필요합니다. 나열된 비트율 값은 패킷화 오버헤드가 포함되지 않은 순 비트율을 나타냅니다.

관련 API 요소

고급 마이크 옵션을 제어합니다. 자세한 내용은 MicrophoneEnhancedOptions 클래스를 참조하십시오. 이 속성은 향상되지 않은 Microphone 인스턴스에서는 무시됩니다.

관련 API 요소

패킷(메시지)으로 전송된 Speex 음성 프레임 수입니다. 각 프레임의 길이는 20ms입니다. 기본값은 패킷당 두 개 프레임입니다.

메시지에 Speex 프레임이 많을수록 대역폭이 적게 필요하지만 메시지를 보낼 때의 지연 시간이 길어집니다. 반대로, Speex 프레임이 적을수록 대역폭이 많이 필요하지만 지연 시간이 짧아집니다.

마이크가 신호를 증폭하는 양입니다. 유효한 값은 0부터 100까지입니다. 기본값은 50입니다.

관련 API 요소

Microphone.names에 의해 반환되는 배열에 반영된 마이크의 인덱스입니다.

관련 API 요소

현재 플랫폼에서 Microphone 클래스가 지원되면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다.

사용자가 마이크에 대한 액세스를 거부했는지(true) 아니면 허용했는지(false) 나타냅니다. 이 값이 변경되면 status 이벤트가 전달됩니다. 자세한 내용은 Microphone.getMicrophone()을 참조하십시오.

관련 API 요소

사운드 캡처 하드웨어에서 반환된 현재 사운드 캡처 장치 이름입니다.

관련 API 요소

사용 가능한 모든 사운드 캡처 장치의 이름을 포함하는 문자열 배열입니다. Flash Player의 [개인 정보 설정] 패널을 표시하지 않아도 반환됩니다. 이 배열은 시스템에 있는 사운드 캡처 장치의 수와 각 사운드 캡처 장치의 0부터 시작하는 인덱스를 Microphone.names.length 속성을 통해 제공합니다. 자세한 내용은 Array 클래스 항목을 참조하십시오.

Microphone.names를 호출하면 광범위한 하드웨어 검사가 실시되며, 배열을 구성하려면 수 초가 소요됩니다. 대부분의 경우 기본 마이크를 사용합니다.

참고: 현재의 마이크 이름을 확인하려면 name 속성을 사용합니다.

관련 API 요소

Speex 인코더에 사용되는 노이즈의 최대 감쇠(dB, 음수)입니다. 사용하도록 설정할 경우 Speex 압축 전 Microphone에서 캡처한 사운드에 노이즈 억제가 적용됩니다. 0으로 설정하면 노이즈 억제가 사용하지 않도록 설정됩니다. 노이즈 억제는 기본적으로 최대 -30dB의 감쇠가 적용되도록 설정됩니다. Nellymoser 코덱을 선택한 경우 무시됩니다.

응용 프로그램에 마이크에 액세스할 수 있는 권한이 부여되었는지 여부를 확인합니다.

관련 API 요소

마이크가 사운드를 캡처하는 속도(kHz)입니다. 사용할 수 있는 값에는 5, 8, 11, 22 및 44가 있습니다. 사운드 캡처 장치가 이 값을 지원하면 8kHz가 기본값입니다. 그렇지 않으면 기본값은 사운드 캡처 장치가 지원하는 8kHz 이상의 다음 사용 가능한 캡처 레벨이며 보통 11kHz입니다.

참고: 다음 표와 같이 실제 속도는 rate 값과 약간 다릅니다.

관련 API 요소

마이크를 활성화하고 activity 이벤트를 전달하는 데 필요한 사운드 크기입니다. 기본값은 10입니다.

관련 API 요소

마이크가 사운드 감지를 중지한 때부터 activity 이벤트가 전달되기까지의 시간(밀리초)입니다. 기본값은 2000(2초)입니다.

이 값을 설정하려면 Microphone.setSilenceLevel() 메서드를 사용합니다.

관련 API 요소

루프백 모드일 때 마이크 객체의 사운드를 제어합니다.

반향 제거를 사용하려면 true로 설정하고 사용하지 않으려면 false로 설정합니다. Flash Player의 [마이크 설정] 패널에서 [반향 줄이기]가 선택되어 있지 않은 경우 기본값은 false입니다.

관련 API 요소

어쿠스틱 에코 제거를 수행할 수 있는 고급 Microphone 객체에 대한 참조를 반환합니다. 어쿠스틱 에코 제거 기능을 통해 헤드셋이 필요하지 않은 오디오/비디오 채팅 응용 프로그램을 만들 수 있습니다.

index 매개 변수는 Microphone.getEnhancedMicrophone() 메서드와 Microphone.getMicrophone() 메서드에 대해 동일한 방식으로 작동합니다.

Android에서 이 메서드를 사용하려면 응응 프로그램 설명자의 Android manifest additions에 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()를 호출하는 경우 마이크에 대한 액세스 허용 여부를 선택할 수 있는 [개인 정보] 대화 상자가 표시됩니다. 스테이지 크기가 215 x 138 픽셀 이상이 되도록 하십시오. 이 크기는 대화 상자가 표시되는 데 필요한 최소 크기입니다.

매개 변수

관련 API 요소

오디오를 캡처할 Microphone 객체에 대한 참조를 반환합니다. 오디오 캡처를 시작하려면 NetStream 객체에 Microphone 객체를 첨부해야 합니다(NetStream.attachAudio() 참조).

Microphone.getMicrophone()을 여러 번 호출해도 동일한 마이크를 참조합니다. 따라서 코드에 mic1 = Microphone.getMicrophone() 및 mic2 = Microphone.getMicrophone()이 포함된 경우 mic1과 mic2 모두 동일한 (기본) 마이크를 참조합니다.

일반적으로 index의 값을 전달해서는 안됩니다. air.Microphone.getMicrophone()을 호출하기만 하면 기본 마이크에 대한 참조가 반환됩니다. Flash Player 설정 패널의 [마이크 설정] 섹션에서 응용 프로그램에서 사용해야 하는 기본 마이크를 지정할 수 있습니다. 사용자는 웹 브라우저에서 실행되는 Flash Player 내용을 마우스 오른쪽 버튼으로 클릭하여 Flash Player 설정 패널에 액세스할 수 있습니다. index 값을 전달하면 사용자가 선택한 것과 다른 마이크를 참조할 수 있습니다. index는 응용 프로그램이 동시에 두 마이크의 오디오를 캡처하는 것과 같은 경우를 제외하고는 거의 사용되지 않습니다. Adobe AIR에서 실행되는 내용 또한 Flash Player의 기본 마이크 설정을 사용합니다.

Microphone.index 속성을 사용하여 현재 Microphone 객체의 인덱스 값을 구합니다. 그런 다음 이 값을 Microphone 클래스의 다른 메서드로 전달하면 됩니다.

SWF 파일이 Microphone.getMicrophone()에 의해 반환된 객체에 액세스하려면 예를 들어 NetStream.attachAudio()를 호출하는 경우 마이크에 대한 액세스 허용 여부를 선택할 수 있는 [개인 정보] 대화 상자가 표시됩니다. 스테이지 크기가 215 x 138 픽셀 이상이 되도록 하십시오. 이 크기는 대화 상자가 표시되는 데 필요한 최소 크기입니다.

사용자가 이 대화 상자에 응답하면 사용자의 응답을 나타내는 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 코덱을 사용하는 경우에는 묵음 레벨을 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 이벤트는 연결된 마이크 객체가 상태 정보를 보고할 때 전달되며, 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);
        }
    }
}