Класс VoiceStatus

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

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

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

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