Mobile Media API (MMAPI) - это протоколо- и платформо-независимый API для проигрывания и работы с мультимедийным контентом на мобильных устройствах.

Микширование: в чем проблема?

Возможность наложения звуков в приложениях для мобильных устройствах безусловно востребована - например, в играх. MMAPI позволяет этого добиться, но есть несколько подводных камней.

Фрагментация платформы

Реализации MMAPI, которые возвращают true в качестве значения системного свойства supports.mixing, теоретически, должны обеспечивать следующие возможности:

• Поддерживать одновременное проигрывание минимум двух тоновых сигналов
  
• Использовать Manager.playTone(), когда другой экземпляр проигрывателя воспроизводит звук
• Поддерживать проигрывание на как минимум двух экземплярах плеера

На практике не все реализации MMAPI соблюдают эти требования. Это зависит от устройста и точный ответ о том, что возможно на вашем устройстве можно получить лишь в документации по этому устройству от его производителя.

Множественные экземпляры плеера

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

MIDI, тональные звуки, и сэмплированное аудио

То, что можно микшировать зависит от возможностей вашего устройства. Большинство известных реализаций позволяют микшировать один экземпляр сэмплированного аудио и один экземпляр тонального звука или MIDI, или и то и другое.

Пишем код

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

Пример создан и может быть запущен с помощью Netbeans 6.5. При создании приложения не забудьте отметить MMAPI среди дополнительных API, так как MIDIControl не входит в базовый MIDP 2.0 MMAPI.

Код протестирован с помощью Sun Wireless Toolkit 2.2, который входит в netbeans 6.5. Для запуска в других окружениях убедитесь, что MIDIControl поддерживается.

Ресурсы

• Исходный код aв виде проекта Netbeans
  
• Mobile Media API
• Mobile Media API Book

import javax.microedition.media.*;
import javax.microedition.lcdui.*;
import javax.microedition.midlet.*;
import javax.microedition.media.control.MIDIControl;
 
/*
 * TechnicalTipMIDlet микширует мелодии, MIDI и тональные звуки
 * @author  Vikram Goyal
 */
public class TechnicalTipMIDlet extends MIDlet implements CommandListener {
 
  //плееры для фоновой музыки и MIDI
  private Player backgroundMusic = null;
  private Player aPlayer = null;
 
  // MIDIControl полученный из aPlayer
  private MIDIControl mControl = null;
 
  private Display display = null;
  private Alert alert = null;
 
  // команды для выхода из приложения, проигрывания MIDI (aCommand) и тонального звука (bCommand)
  private Command exitCommand = null;
  private Command aCommand = null;
  private Command bCommand = null;
 
  public TechnicalTipMIDlet() {
    display = Display.getDisplay(this);
 
    alert = new Alert("Message");
    alert.setString("Press A to play a tone, Press B to play a MIDI");
    alert.setTimeout(Alert.FOREVER);
 
    //создаем комманды
    exitCommand = new Command("Exit", Command.EXIT, 1);
    aCommand = new Command("A", Command.ITEM, 1);
    bCommand = new Command("B", Command.ITEM, 1);
 
    alert.addCommand(exitCommand);
    alert.addCommand(aCommand);
    alert.addCommand(bCommand);
 
    //подписываемся на события
    alert.setCommandListener(this);
 
    //инициализируем экземпляры плеера
    initialize();
  }
 
  private void initialize() {
    //создаем и загружаем экземпляры плеера
    try {
 
      // для фоновой музыки загружаем wav файл и проигрываем его в бесконечном цикле
      backgroundMusic = Manager.createPlayer(
          getClass().getResourceAsStream("music.wav"), "audio/x-wav");
      backgroundMusic.prefetch();
      backgroundMusic.setLoopCount(-1);
 
      // создаем проигрыватель для MIDI, подгружаем звук
      aPlayer = Manager.createPlayer(Manager.MIDI_DEVICE_LOCATOR);
      aPlayer.prefetch();
 
      // запоминаем MIDIControl
      mControl =
        (MIDIControl)aPlayer.getControl(
          "javax.microedition.media.control.MIDIControl");
 
    } catch(Exception ex) {
      handleError(ex);
    }
  }
 
  public void commandAction(Command cmd, Displayable disp) {
 
    if(cmd == exitCommand) {
      destroyApp(true);
      notifyDestroyed();
      return;
    }
 
    try {
 
      // if it's the aCommand
      if (cmd == aCommand) {
 
        // проигрываем MIDI
        mControl.shortMidiEvent(MIDIControl.NOTE_ON | 11, 60, 100);
      }
 
      if (cmd == bCommand) {
 
        //для bCommand, проигрываем тоновый звук используя класс Manager
        Manager.playTone(61, 1000, 100);
      }
    } catch(Exception ex) {
      handleError(ex);
    }
  }
 
  public void startApp() {
 
    try {
 
      // запускаем фоновую музыку
      if (backgroundMusic != null) 
          backgroundMusic.start();
      else 
          handleError(new Exception("Error with background player"));
    } catch(Exception ex) { 
        handleError(ex); 
    }
 
    display.setCurrent(alert);
  }
 
  public void pauseApp() {
  }
 
  public void destroyApp(boolean unconditional) {
 
    try {
 
      //закрываем плееры
      if(backgroundMusic != null) {
        backgroundMusic.close();
        backgroundMusic = null;
      }
 
      if(aPlayer != null) {
        aPlayer.close();
        aPlayer = null;
      }
 
    } catch(Exception e) {
      handleError(e);
    }
 
  }
 
  private void handleError(Exception ex) {
    alert.setTitle("Error");
    alert.setString(ex.getMessage());
    display.setCurrent(alert);
    ex.printStackTrace();
  }
}