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

Если микрофон доступен, но не используется, потому что не вызван метод Microphone.getMicrophone(), это свойство имеет значение -1.

См. также

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

См. также

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

См. также

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

Усиление микрофона — это степень умножения микрофонного сигнала перед его передачей. Значение 0 предписывает проигрывателю Flash Player выполнять умножение на 0; в этом случае микрофон не передает звук.

Этот параметр напоминает регулятор громкости стереосистемы: 0 — это выключенная громкость, а 50 — нормальная громкость. Числа до 50 определяют громкость, которая ниже нормальной, а числа после 50 задают громкость выше нормальной. Допустимые значения — от 0 до 100, а значение по умолчанию — 50. Пользователь может изменять это значение на панели параметров микрофона Flash Player.

См. также

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

См. также

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

См. также

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

См. также

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

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

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

См. также

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

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

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

См. также

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

Чтобы задать это значение, используйте метод Microphone.setSilenceLevel().

См. также

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

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

См. также

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

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

Чтобы получить микрофон по умолчанию, нужно вызвать метод getMicrophone(), указав значение -1. Также его можно вызвать без параметров, тогда метод возвратит первый микрофон в списке.

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

Как правило, не следует передавать значение для index. Просто используйте метод Microphone.get(), чтобы получить ссылку на микрофон по умолчанию. На панели "Параметры микрофона" можно задать микрофон по умолчанию, который должен использовать проигрыватель Flash Player. Если передать значение для параметра index, то метод может ссылаться не на тот микрофон, который выберет пользователь. Параметр index можно использовать в редких случаях, например если приложение записывает аудио одновременно с двух микрофонов.

Когда SWF-файл пытается обратиться к объекту, возвращенному методом Microphone.get(), например при вызове NetStream.attachAudio(), проигрыватель Flash Player отображает диалоговое окно "Конфиденциальность", с помощью которого пользователь может разрешить или запретить доступ к микрофону. (Убедитесь в том, что размеры рабочей области составляют не менее 215х 138 пикселов. Это минимальный размер, необходимый проигрывателю Flash Player для отображения диалогового окна.)

Когда пользователь отвечает на запрос диалогового окна, отправляется соответствующее событие status. Также можно проверить свойство Microphone.muted, чтобы определить, предоставил пользователь доступ к микрофону или нет.

Если Microphone.get() возвращает значение null, это значит, что микрофон используется другим приложением или что в системе не установлены микрофоны. Чтобы узнать, установлены ли микрофоны, используйте Microphones.names.length. Чтобы отобразить панель "Параметры микрофона" проигрывателя Flash Player, где пользователь может выбрать микрофон для метода Microphone.get, используйте метод Security.showSettings().

Параметры

См. также

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

Параметры

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

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

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

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

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

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

Параметры

См. также

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

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

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