Gets all MIDI devices names - Java javax.sound.midi

Description

Gets all MIDI devices names

Demo Code

/*/*  ww w. ja v a2 s  .  c  o m*/
 * Copyright (c) 1999 - 2001 by Matthias Pfisterer
 * Copyright (c) 2003 by Florian Bomers
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 */
import java.util.ArrayList;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import javax.sound.midi.InvalidMidiDataException;
import javax.sound.midi.MetaMessage;
import javax.sound.midi.MidiDevice;
import javax.sound.midi.MidiMessage;
import javax.sound.midi.MidiSystem;
import javax.sound.midi.MidiUnavailableException;
import javax.sound.midi.Receiver;
import javax.sound.midi.ShortMessage;
import javax.sound.midi.SysexMessage;
import javax.sound.midi.Transmitter;
import org.apache.log4j.Logger;

public class Main{
    static Logger log = Logger.getLogger(MidiUtils.class.getName());
    /**
     * Gets all MIDI devices names
     * 
     * @return A list with the names of the devices
     */
    public static List<String> getMidiDeviceSignatures() {
        return getMidiDeviceSignatures(null);
    }
    /**
     * Gets all MIDI devices names
     * 
     * @param direction
     *            The desired port direction, <NULL> gets all
     * @return A list with the signatures of the devices <index> <directions>:
     *         <name>
     */
    public static List<String> getMidiDeviceSignatures(String direction) {

        List<String> midiDeviceSignatures = new ArrayList<String>();
        MidiDevice.Info[] infos = MidiSystem.getMidiDeviceInfo();

        for (int i = 0; i < infos.length; i++) {
            try {

                MidiDevice device = MidiSystem.getMidiDevice(infos[i]);
                String name = infos[i].getName();
                int maxReceivers = device.getMaxReceivers();
                int maxTransmitters = device.getMaxTransmitters();

                if (direction == null) {

                    midiDeviceSignatures.add(name);

                } else {

                    if (direction.equals("IN") && (maxTransmitters != 0)) {
                        midiDeviceSignatures.add(name);
                    }

                    if (direction.equals("OUT") && (maxReceivers != 0)) {
                        midiDeviceSignatures.add(name);
                    }
                }

            } catch (MidiUnavailableException e) {
                log.error("A MIDI device is not available", e);
            }
        }

        return midiDeviceSignatures;
    }
    /**
     * Retrieve a MidiDevice.Info for a given name.
     * 
     * This method tries to return a MidiDevice.Info whose name matches the
     * passed name. If no matching MidiDevice.Info is found, null is returned.
     * If bForOutput is true, then only output devices are searched, otherwise
     * only input devices.
     * 
     * @param strDeviceName
     *            the name of the device for which an info object should be
     *            retrieved.
     * @param bForOutput
     *            If true, only output devices are considered. If false, only
     *            input devices are considered.
     * @return A MidiDevice.Info object matching the passed device name or null
     *         if none could be found.
     */
    public static MidiDevice.Info getMidiDeviceInfo(String strDeviceName,
            boolean bForOutput) {

        MidiDevice.Info[] aInfos = MidiSystem.getMidiDeviceInfo();

        for (int i = 0; i < aInfos.length; i++) {

            if (aInfos[i].getName().equals(strDeviceName)) {

                try {
                    MidiDevice device = MidiSystem.getMidiDevice(aInfos[i]);
                    boolean bAllowsInput = (device.getMaxTransmitters() != 0);
                    boolean bAllowsOutput = (device.getMaxReceivers() != 0);
                    if ((bAllowsOutput && bForOutput)
                            || (bAllowsInput && !bForOutput)) {
                        return aInfos[i];
                    }

                } catch (MidiUnavailableException e) {
                    // TODO:
                }
            }
        }
        return null;
    }
    /**
     * Gets a midi device by name
     * 
     * @param midiDeviceName
     *            The name of the midi device
     * @param outputDevice
     *            "OUT" only output devices are considered, "IN" only input
     *            devices are considered.
     * @return The midi device
     * @throws MidiUnavailableException
     *             If the midi device can not be found
     */
    public static MidiDevice getMidiDevice(String midiDeviceName,
            String direction) throws MidiUnavailableException {

        MidiDevice.Info[] midiInfos;
        MidiDevice device = null;

        if (midiDeviceName != null) {

            midiInfos = MidiSystem.getMidiDeviceInfo();

            for (int i = 0; i < midiInfos.length; i++) {
                if (midiInfos[i].getName().equals(midiDeviceName)) {
                    device = MidiSystem.getMidiDevice(midiInfos[i]);

                    if (getDirectionOfMidiDevice(device).equals(direction)) {
                        return device;
                    }
                }
            }

        }
        throw new MidiUnavailableException();
    }
    /**
     * Returns the allowed direction of the given midi device
     * 
     * @param device
     *            The midi device
     * @return "IN" for inbound devices, "OUT" for outbound devices, else <NULL>
     */
    public static String getDirectionOfMidiDevice(MidiDevice device) {

        if (device.getMaxTransmitters() != 0) {
            return "IN";
        }

        if (device.getMaxReceivers() != 0) {
            return "OUT";
        }
        return null;
    }
}

• Previous
• Next

Related Tutorials

• remove Midi Output Devices
• remove Midi Software Devices
• Retrieve a MidiDevice.Info for a given name.
• Checks if a given receiver is already connected to the Midi device
• Removes a midi receiver from a midi device