Класс VoiceStatus

Синтезаторы MIDI, как правило, способны генерировать некоторое максимальное количество одновременных нот, также называемых голосами. Голос — это поток последовательных отдельных нот, а процесс назначения входящих MIDI-нот конкретным голосам известен как распределение голосов. Однако алгоритм распределения голосов и содержимое каждого голоса обычно внутренние для синтезатора MIDI и скрыты от внешнего доступа. Конечно, можно узнать из сообщений MIDI, какие ноты играет синтезатор, и возможно, сделать вывод о назначении нот голосам. Но сам MIDI не предоставляет средств для отслеживания, какие ноты синтезатор назначил какому голосу, а также даже не сообщает, сколько голосов синтезатор способен генерировать.

Однако в Java Sound класс Synthesizer может предоставить содержимое своих голосов через метод getVoiceStatus(). Это поведение рекомендуется, но является необязательным; синтезаторы, которые не предоставляют информацию о распределении голосов, просто возвращают массив нулевой длины. Класс Synthesizer , который сообщает о состоянии своих голосов, должен поддерживать эту информацию для всех своих голосов в любое время, независимо от того, звучат они в данный момент или нет. Другими словами, у данного типа Synthesizer всегда есть фиксированное количество голосов, равное максимальному числу одновременных нот, которые он способен воспроизводить.

Если голос в данный момент не обрабатывает MIDI-ноту, он считается неактивным. Голос считается неактивным, когда ему не были даны команды note-on или когда все полученные команды note-on были завершены соответствующими командами note-off (или сообщением "отключить все ноты"). Например, это происходит, когда синтезатору, способному воспроизводить 16 одновременных нот, говорят сыграть аккорд из четырех нот; в этом случае активны только четыре голоса (если ранее не звучали какие-либо ноты). Обычно голос, состояние которого сообщается как активный, воспроизводит слышимый звук, но это не всегда верно; это зависит от деталей инструмента (то есть алгоритма синтеза) и того, как долго звучит нота. Например, голос может синтезировать звук одиночного хлопкого звука. Поскольку этот звук затухает так быстро, он может стать неслышимым до получения сообщения note-off. В такой ситуации голос по-прежнему считается активным, даже если в данный момент не производится никакого звука.

Помимо состояния активности или неактивности, класс VoiceStatus предоставляет поля, которые показывают текущий MIDI-канал, банку и номер программы, номер MIDI-ноты и уровень MIDI-громкости голоса. Все эти значения могут изменяться в процессе работы голоса. В то время как голос неактивен, каждое из этих полей имеет неопределенное значение, поэтому сначала необходимо проверить поле active.