Java中Clip.getLevel()方法仅返回-1.0的问题求助

我在开发Java音频可视化工具时，遇到Clip.getLevel()方法始终返回-1.0的问题，音频播放功能正常，更换过不同音频文件也无法解决。原本希望通过这个方法获取音频电平，避免使用FFT，相关代码如下：

import java.io.File;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;
import javax.sound.sampled.Clip;

public class Music {
    
    private static String filePath = "audio\\audio ";
    private static Clip clip;
    
    public static void playAudio(int track){
        try {
            File path = new File(filePath + track + ".wav");
            if (path.exists()){ 
                AudioInputStream input = AudioSystem.getAudioInputStream(path);
                
                clip = AudioSystem.getClip();
                clip.open(input); 
                clip.start();
            }
            else { System.out.println("Audio missing."); }
        }
        catch(Exception e) { System.out.println(e); }
    }
    
    public static int getFrame(){
        return clip.getFramePosition();
    }
    
    public static double getLevel(){
        return clip.getLevel();
    }
}

问题原因 #

Clip.getLevel()是Java Sound API中的可选实现方法，并非所有平台、音频驱动或Clip实现都会提供实际功能，多数情况下它仅返回默认值-1.0，这是该方法设计上的局限性。

替代方案（无需FFT） #

我们可以直接读取音频的PCM样本数据，通过计算**均方根（RMS）**来获取音频电平，这是基础音频可视化中常用的简单方法。修改后的代码如下：

import java.io.File;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;
import javax.sound.sampled.Clip;

public class Music {
    
    private static String filePath = "audio\\audio ";
    private static Clip clip;
    private static float[] audioSamples;
    private static AudioFormat format;
    
    public static void playAudio(int track){
        try {
            File path = new File(filePath + track + ".wav");
            if (path.exists()){ 
                AudioInputStream input = AudioSystem.getAudioInputStream(path);
                format = input.getFormat();
                
                // 将音频转换为标准16位PCM格式，统一样本解析逻辑
                AudioInputStream pcmInput = AudioSystem.getAudioInputStream(
                    new AudioFormat(
                        AudioFormat.Encoding.PCM_SIGNED,
                        format.getSampleRate(),
                        16,
                        format.getChannels(),
                        format.getChannels() * 2,
                        format.getSampleRate(),
                        format.isBigEndian()
                    ),
                    input
                );
                
                // 读取所有音频样本到数组，方便播放时实时获取
                long frameLength = pcmInput.getFrameLength();
                int channels = format.getChannels();
                audioSamples = new float[(int)frameLength * channels];
                
                byte[] buffer = new byte[4096];
                int bytesRead;
                int sampleIndex = 0;
                
                while ((bytesRead = pcmInput.read(buffer)) != -1) {
                    for (int i = 0; i < bytesRead; i += 2) { // 16位样本占2字节
                        short sampleShort = ByteBuffer.wrap(buffer, i, 2)
                            .order(format.isBigEndian() ? ByteOrder.BIG_ENDIAN : ByteOrder.LITTLE_ENDIAN)
                            .getShort();
                        // 将16位样本转换为-1.0到1.0的浮点值
                        audioSamples[sampleIndex++] = sampleShort / 32768.0f;
                    }
                }
                
                // 初始化并播放音频
                clip = AudioSystem.getClip();
                clip.open(input); 
                clip.start();
            }
            else { System.out.println("Audio missing."); }
        }
        catch(Exception e) { System.out.println(e); }
    }
    
    public static int getFrame(){
        return clip != null ? clip.getFramePosition() : 0;
    }
    
    public static double getLevel(){
        if (clip == null || audioSamples == null || format == null) {
            return 0.0;
        }
        
        int currentFrame = clip.getFramePosition();
        int channels = format.getChannels();
        int startIndex = currentFrame * channels;
        
        // 取当前帧附近2048个样本计算RMS，避免电平突变，显示更平滑
        int endIndex = Math.min(startIndex + 2048 * channels, audioSamples.length);
        if (startIndex >= audioSamples.length) {
            return 0.0;
        }
        
        double sumOfSquares = 0.0;
        int sampleCount = endIndex - startIndex;
        
        for (int i = startIndex; i < endIndex; i++) {
            sumOfSquares += audioSamples[i] * audioSamples[i];
        }
        
        // RMS值范围在0-1之间，可根据可视化需求调整映射范围
        return Math.sqrt(sumOfSquares / sampleCount);
    }
}

关键说明 #

1. 统一转换为16位PCM格式，简化不同音频格式的样本解析逻辑；
2. 预读取所有音频样本到数组，确保播放时能实时获取当前位置的音频数据；
3. 通过计算一段样本的均方根（RMS）代表当前电平，避免单样本的波动，让可视化效果更稳定；
4. 最终返回的RMS值范围在0-1之间，可根据需求映射到合适的显示区间。

内容的提问来源于stack exchange，提问作者VQ350GeTsome