Класс VoiceStatus

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

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

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

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