在开发应用程序或是游戏的时候,常常会需要加入一些音乐或是音效来提示或是取悦用户。那么如果是使用 Java 编程语言的话该如何播放出声音呢?难不成要像是 Csound 一样需要使用振荡器来振荡出不同波形、振幅、频率的信号吗?不用!实际上,Java 有提供音乐播放的相关套件,可以直接读取网络上或是电脑内的音频文件(Audio File)。

在 Javax 函数库中,提供了 AudioInputStream 可以用来读取音频文件,但它只能支持 WAV、AIFF、AU 等 PCM (Pulse-code modulation)格式,如果要能播放如 MP2、MP3 等其他有编码压缩过音频格式的话,可以使用 JavaFX 提供的 MediaPlayer 或 AudioClip,或是第三方的 Java 函数库。

使用 MediaPlayer 或 AudioClip 播放音频

AudioClip 能播放的音频格式有非常多种,如果想要知道有哪几种的话,可以使用 MediaManager 的 getSupportedContentTypes 方法来取得。

MediaManager.getSupportedContentTypes();

AudioClip 使用方式十分简单,只要将其实体化后再使用 play 方法即可。

AudioClip plonkSound = new AudioClip(url);
plonkSound.play();

MediaPlayer 是 AudioClip 的高级版本,提供多种取得媒体信息及播放控制的方法。

MediaPlayer plonkSound = new MediaPlayer(new Media(uri));
plonkSound.play();

虽然使用 MediaPlayer 或 AudioClip 来播放声音十分方便,但是 MediaPlayer 或 AudioClip 的跨平台性实在不怎么好,因为它的音乐解码器仰赖于运行的操作系统上的音频解码器(函数库),所以可能会在某些平台下无法播放某些特定的格式。因此,最保险的作法,还是将 Java 要播放的音乐都转成 WAV、AIFF 或是 AU 格式,然后使用以下提到的 AudioInputStream 来播放。

使用 AudioInputStream 播放音频

AudioInputStream 会使用 JDK Service 提供的 AudioFileReader 来读取音频文件,创建 AudioInputStream 实体可以透过 AudioSystem 的 getAudioInputStream 方法,程序如下:

AudioInputStream audioInputStream = AudioSystem.getAudioInputStream(url);

由于 AudioInputStream 只是一个输入串流,并没有办法控制声音的播放与输出,因此我们必须要有一个时间轴。要产生出一个时间轴前,我们必须要先知道音频的 SampleRate、Bitrate、Size 等等重要的信息,可以透过 AudioInputStream 的 getFormat 方法来取得。

AudioFormat audioFormat = audioInputStream.getFormat();

再来就是利用这些信息,创建出时间轴,时间轴可以使用继承 DataLine 的 Clip 对象。要创建出 Clip 对象,可以先创建出 DataLine 的 Info 对象后,再使用 AudioSystem 的 getLine 方法取得 Clip 对象,然后再用这个拥有 audioFormat 信息的 Clip 对象去打开 audioInputStream。javax 把这个部份搞得有点复杂,程序如下:

int bufferSize = (int) Math.min(audioInputStream.getFrameLength() * audioFormat.getFrameSize(), Integer.MAX_VALUE); //缓冲大小,如果音频文件不大,可以全部存入缓冲空间。这个数值应该要按照用途来决定
DataLine.Info dataLineInfo = new DataLine.Info(Clip.class, audioFormat, bufferSize);
Clip clip = (Clip) AudioSystem.getLine(dataLineInfo);
clip.open(audioInputStream);

再来就可以使用 Clip 对象的 start、stop 等等的方法来控制声音的播放了!

使用 MagicAudioPlayer 播放音频

MagicAudioPlayer 是一个基于 AudioInputStream 和 MediaPlayer 所实作出来的声音播放器,因此除了能支持 WAV、AIFF 或是 AU 等未压缩音频格式之外,还可以借由系统函数库的帮助来支持 MP3、AAC 等音频格式。

取得 MagicAudioPlayer

GitHub:

使用 MagicAudioPlayer

MagicAudioPlayer 的使用方法十分容易,只要将其实体化后再使用 play 方法即可。读取音频文件的方式如下:

File audioFile = new File("/home/magiclen/test.wav");
AudioPlayer player = AudioPlayer.createPlayer(audioFile);
player.play();

也可以用 URL 当作音频来源:

AudioPlayer player = AudioPlayer.createPlayer(url);
player.play();

如果要暂停、停止播放的话,可以使用 pause 与 stop 方法。

player.pause();
player.stop();

如果要设置播放次数以及播放完成后自动关闭并释放资源的话,可以使用 setPlayCount 和 setAutoClose 方法,程序如下:

player.setPlayCount(2);
player.setAutoClose(true);

另外还可以使用 setVolume 和 setBalance 方法设置播放的音量以及左右声道的平衡,程序如下:

player.setVolume(100);
player.setBalance(100);

如果要取得 AudioPlayer 目前的状态,可以使用 getStatus 方法,如下:

AudioPlayer.Status status = player.getStatus();

如果要监听 AudioPlayer 的状态改变事件,可以使用 setStatusChangedListener 方法,如下:

player.setStatusChangedListener((previousStatus, currentStatus) -> {
    switch (currentStatus) {
        case OPEN:
            break;
        case START:
            break;
        case STOP:
            break;
        case CLOSE:
            break;
    }
});

当然也可以取得与设置目前播放的位置,如下:

long position = player.getAudioPosition();
//往前一秒
player.setAudioPosition(position + 1000000);