树莓派3B上Java/LibGDX游戏指定HDMI音频输出的技术问询

核心问题原因 #

Java音频库（包括LibGDX依赖的OpenAL）不会自动同步树莓派系统层的音频路由配置，哪怕系统默认是HDMI输出，Java应用可能仍会优先选择3.5mm接口的设备。

可行解决方案 #

1. 通过JVM启动参数强制指定ALSA设备 #

• 先在树莓派终端执行aplay -l，查看音频设备列表，找到HDMI对应的设备编号（通常格式为card X, device Y）
• 启动游戏jar时添加以下参数，替换hw:X,Y为你的HDMI设备编号：

java -Djavax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider \
-Djavax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider \
-Dalsa.device=hw:X,Y \
-jar your-game.jar

2. 在LibGDX代码中指定OpenAL输出设备 #

LibGDX基于OpenAL处理音频，你可以主动枚举设备并指定HDMI输出：

• 先枚举所有可用音频设备：

import com.badlogic.gdx.audio.AudioDevice;
import com.badlogic.gdx.utils.Array;

// 在游戏初始化阶段执行
Array<String> audioDevices = AudioDevice.getAvailableDevices();
for (String device : audioDevices) {
    System.out.println("检测到音频设备：" + device);
}

• 找到HDMI对应的设备名称（比如bcm2835 HDMI 1）后，初始化指定设备的AudioDevice：

String hdmiDevice = "bcm2835 HDMI 1"; // 替换为你查到的设备名
// 44100为采样率，false代表单声道（根据需求调整）
AudioDevice hdmiAudioDevice = new AudioDevice(hdmiDevice, 44100, false);

• 若使用LibGDX的Sound/Music类，可封装自定义音频播放逻辑，或替换LibGDX内部的音频设备实例。

3. 确保系统音频配置正确 #

先确认树莓派系统默认输出为HDMI：

• 执行sudo raspi-config，进入System Options -> Audio，选择HDMI作为默认输出
• 或用命令直接设置：amixer cset numid=3 2（2=HDMI，1=3.5mm，0=自动）
• 无需特意在默认HDMI的树莓派上编译jar，编译环境不影响运行时路由，但运行时必须保证系统默认配置正确，同时结合方案1/2确保Java应用读取该配置。

4. 借助PulseAudio统一音频路由 #

若树莓派安装了PulseAudio，可让Java应用通过它继承系统默认输出：

• 安装PulseAudio：sudo apt install pulseaudio
• 启动jar时添加环境变量：

PULSE_SERVER=unix:/run/user/1000/pulse/native java -jar your-game.jar

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