Microphone  - AS3

Уровень звука, распознаваемый микрофоном. Значения находятся в диапазоне от 0 (звук не определяется) до 100 (определяется очень громкий звук). Значение этого свойства помогает определить подходящее значение для передачи методу Microphone.setSilenceLevel().

Если для свойства микрофона muted установлено значение true, это свойство всегда имеет значение -1.

Связанные элементы API

Кодек, используемый для сжатия аудио. Доступные кодеки: Nellymoser (по умолчанию) и Speex. Класс перечисления SoundCodec содержит различные значения, действительные для свойства codec.

При использовании кодека Nellymoser можно установить частоту дискретизации с помощью Microphone.rate(). При использовании кодека Speex частота дискретизации составляет 16 кГц.

Speex включает систему обнаружения речевой активности (Voice Activity Detection, VAD) и обеспечивает автоматическое уменьшение полосы пропускания при отсутствии речевой активности. При использовании кодека Speex компания Adobe рекомендует установить значение уровня тишины на 0. Для установки уровня тишины используйте метод Microphone.setSilenceLevel().

Связанные элементы API

Включение обнаружения голосовой активности Speex.

Качество зашифрованной речи при использовании кодека Speex. Допускаются значения от 0 до 10. Значением по умолчанию является 6. Более высокие значение подразумевают лучшее качество, но требуют большей пропускной способности в соответствии с таблицей ниже. Приведенные значения скорости потока являются чистыми значениями без учета данных пакетирования.

Связанные элементы API

Управляет улучшенными параметрами микрофона. Дополнительные сведения см. в описании класса MicrophoneEnhancedOptions. Это свойство игнорируется у нерасширенных экземпляров объекта Microphone.

Связанные элементы API

Количество речевых кадров Speex, передаваемых в пакете (сообщении). Длина каждого кадра составляет 20 мс. Значение по умолчанию — два кадра в пакете.

Чем больше кадров в сообщении Speex, тем уже необходимая полоса пропускания, но дольше задержка при отправке сообщения. При уменьшении количества кадров Speex увеличивается необходимая полоса пропускания, но сокращается задержка.

Степень усиления сигнала микрофоном. Действительны значения от 0 до 100. Значением по умолчанию является 50.

Связанные элементы API

Индекс микрофона согласно содержимому массива, возвращаемого функцией Microphone.names.

Связанные элементы API

Свойству isSupported задается значение true, если текущая платформа поддерживает класс Microphone, в противном случае задается значение false.

Определяет наличие у пользователя доступа к микрофону: нет доступа (true), или доступ разрешен (false). При изменении этого значения отправляется событие status. Дополнительные сведения см. в описании метода Microphone.getMicrophone().

Связанные элементы API

Имя текущего устройства звукозаписи, возвращаемое данным устройством.

Связанные элементы API

Массив строк, содержащих имена всех доступных устройств звукозаписи. При возвращении имен пользователю не отображается панель параметров конфиденциальности. Этот массив передает индекс от нуля для каждого устройства звукозаписи и количество этих устройств в системе посредством свойства Microphone.names.length. Дополнительные сведения см. в разделе в описании класса Array.

Вызов метода Microphone.names требует обширного анализа аппаратных средств, и на составление массива может потребоваться несколько секунд. В большинстве случаев можно использовать микрофон по умолчанию.

Примечание. Для определения имени текущего микрофона используйте свойство name.

Связанные элементы API

Максимальное ослабление шума в дБ (отрицательное число), используемое для кодека Speex. Если включено, перед сжатием кодеком Spеex звука, захваченного с микрофона, выполняется шумоподавление. Чтобы отключить шумоподавление, нужно задать значение 0. Шумоподавление по умолчанию включено с ослаблением -30 дБ. Игнорируется, когда выбран кодек Nellymoser.

Определяет, предоставлено или нет приложению разрешение на использование микрофона.

Связанные элементы API

Частота, с которой микрофон записывает звук, в кГц. Допустимыми являются значения 5, 8, 11, 22 и 44. Значение по умолчанию — 8 кГц, если его поддерживает звукозаписывающее устройство. В противном случае, значением по умолчанию становится ближайший уровень записи выше 8 кГц, поддерживаемый звукозаписывающим устройством, обычно это 11 кГц.

Примечание. Фактическая частота немного отличается от значения rate, как описано в следующей таблице.

Связанные элементы API

Уровень звука, необходимый для активации микрофона и передачи события activity. Значением по умолчанию является 10.

Связанные элементы API

Число миллисекунд с момента, когда микрофон камера прекратила распознавать звук, до вызова события activity. Значение по умолчанию 2000 (две секунды).

Для установки этого значения используйте метод Microphone.setSilenceLevel().

Связанные элементы API

Управляет звуком этого объекта Microphone, когда микрофон работает в режиме петли.

Возвращает true, если эхокомпенсация включена, в противном случае возвращает false. Значение по умолчанию — false, если пользователь не выбрал «Уменьшить эхо» на панели «Параметры микрофона» проигрывателя Flash Player.

Связанные элементы API

Возвращает ссылку на расширенный объект Microphone, который может выполнить акустическое эхоподавление. Используйте акустическое эхоподавление для создания приложений аудио- или видеочата, в которых не требуются наушники.

Параметр index для методов Microphone.getEnhancedMicrophone() и Microphone.getMicrophone() работает одинаково.

Чтобы использовать этот метод на Android, добавьте разрешение MODIFY_AUDIO_SETTINGS в дополнениях декларации для Android в дескрипторе приложения.

Важно. В любой момент времени доступен только один экземпляр расширенного устройства микрофона. Все остальные экземпляры объекта Microphone перестают предоставлять аудиоданные и получают событие StatusEvent со свойством code, имеющим значение Microphone.Unavailable. В случае неудачной инициализации расширенного аудио при вызове этого метода возвращается значение 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 х 138 пикселей. Это минимальный размер, необходимый проигрывателю Flash Player для отображения диалогового окна.)

Параметры

Связанные элементы API

Возвращает ссылку на объект Microphone для записи аудио. Для начала записи аудио, необходимо присоединить объект Microphone к объекту NetStream (см. NetStream.attachAudio()).

Многочисленные вызовы метода Microphone.getMicrophone() ссылаются на один микрофон. Таким образом, если код содержит строки mic1 = Microphone.getMicrophone() и mic2 = Microphone.getMicrophone(), то и mic1 и mic2 ссылаются на один и тот же микрофон (по умолчанию).

Как правило, не следует передавать значение для index. Просто используйте метод Microphone.getMicrophone() для получения ссылки на микрофон по умолчанию. В разделе настроек микрофона на панели «Параметры Flash Player» пользователь может задать микрофон по умолчанию, который должно использовать приложение. (Доступ к панели параметров настройки Flash Player можно получить, щелкнув правой кнопкой мыши по содержимому Flash Player в веб-браузере.) Если передать значение для параметра index, то метод может ссылаться не на тот микрофон, который выберет пользователь. Параметр index можно использовать в редких случаях, например, если приложение записывает аудио одновременно с двух микрофонов. Содержимое, выполняемое в Adobe AIR, также использует установку Flash Player для микрофона по умолчанию.

Используйте свойство Microphone.index для получения значения индекса текущего объекта Microphone. Затем можно передать это значение другим методам класса Microphone.

Когда SWF-файл пытается обратиться к объекту, возвращенному методом Microphone.getMicrophone(), например при вызове метода NetStream.attachAudio(), проигрыватель Flash Player отображает диалоговое окно «Конфиденциальность», с помощью которого пользователь может разрешить или запретить доступ к микрофону. (Убедитесь в том, что размеры рабочей области составляют не менее 215 х 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;
    }
}

Запрашивает разрешение на использование микрофона для приложения.

Направляет записываемое микрофоном аудио на локальные динамики.

Параметры

Задает минимальный входной уровень, который будет обрабатываться как звук и (дополнительно) продолжительность тишины, по которой настоящую тишину можно будет отличить от паузы.

• Чтобы микрофон совсем не улавливал звук, передайте значение 100 для silenceLevel; в этом случае событие activity никогда не отправляется.
• Чтобы определить уровень звука, в данный момент улавливаемый микрофоном, используйте Microphone.activityLevel.

Speex включает систему обнаружения речевой активности (Voice Activity Detection, VAD) и обеспечивает автоматическое уменьшение полосы пропускания при отсутствии речевой активности. При использовании кодека Speex компания Adobe рекомендует установить значение уровня тишины на 0.

Обнаружение активности — это способность определять, когда уровень звука указывает на то, что пользователь говорит. Когда пользователь не говорит, можно экономить полосу пропускания, так как не требуется передавать соответствующий аудиопоток. Эти сведения также можно использовать для визуальной обратной связи, чтобы сообщить пользователям о том, что они (или другие) молчат.

Значения тишины прямо соответствуют значениям активности. Полную тишину представляет значение активности 0. Постоянный громкий шум (настолько громкий, насколько это возможно зарегистрировать на основе текущей настройки усиления) соответствует значению активности 100. После соответствующей регулировки усиления значение активности составляет меньше, чем значение тишины, когда вы не говорите. Во время разговора значение активности превышает значение тишины.

Этот метод похож на Camera.setMotionLevel(); они оба используются для определения момента отправки события activity. Однако эти методы имеют в значительной степени различное влияние на публикацию потоков.

• Метод Camera.setMotionLevel() предназначен для определения движения и не влияет на использование полосы пропускания. Даже если видеопоток не обнаруживает движения, видео все равно передается.
• Метод Microphone.setSilenceLevel() предназначен для оптимизации использования полосы пропускания. Когда аудиопоток считается тихим, аудиоданные не передаются. Вместо этого отправляется одно сообщение, свидетельствующее о наступлении тишины.

Параметры

Связанные элементы API

Определяет, используется ли функция эхокомпенсации аудиокодека. Значение по умолчанию — false, если пользователь не выбрал «Уменьшить эхо» на панели «Параметры микрофона» проигрывателя Flash Player.

Эхокомпенсацией называется попытка уменьшить эффект звуковой обратной связи, возникающей при улавливании звука из динамика микрофоном, подключенным к той же системе. (Следует отличать эхокомпенсацию от акустического эхоподавления, при котором обратная связь убирается полностью. Метод setUseEchoSuppression() игнорируется, когда вызывается метод getEnhancedMicrophone() для акустического эхоподавления.)

Как правило, эхокомпенсацию рекомендуется использовать, когда записываемый звук воспроизводится на том же компьютере через динамики, а не наушники. Если 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);
        }
    }
}