如何在树莓派的Docker容器中实现HDMI接口音频播放

1. 树莓派主机端预配置 #

首先需将主机默认音频输出切换为HDMI，避免容器继承默认3.5mm输出配置：

• 执行配置命令 sudo raspi-config，依次选择「系统选项」->「音频」，选中对应HDMI输出项后保存退出
• （桌面版可选）直接点击任务栏右上角音量图标，选择HDMI设备作为默认输出
• 安装音频测试工具验证主机HDMI输出正常：

  sudo apt update && sudo apt install -y alsa-utils
  speaker-test -t wav
  

• 执行 aplay -l 记录HDMI设备对应的card号和device号，例如输出中card 0, device 1: HDMI 1代表设备编号为0,1

2. Docker容器启动参数配置 #

在原有--device /dev/snd基础上，补充挂载ALSA配置或添加权限参数：

docker run -it --rm \
  --device /dev/snd \
  --group-add audio \
  -v /etc/asound.conf:/etc/asound.conf \
  -v /usr/share/alsa:/usr/share/alsa \
  你的基础镜像名

若不想修改主机全局配置，可在容器内单独创建/etc/asound.conf指定HDMI输出，将下方的card和device替换为你之前记录的编号即可：

pcm.!default {
  type hw
  card 0
  device 1
}
ctl.!default {
  type hw
  card 0
}

3. 容器内播放器配置（支持管道流输入） #

推荐使用轻量的mpg123播放器，完美支持标准输入管道传输的mp3流：

• 容器内安装（Debian/Ubuntu基础镜像）：

  apt update && apt install -y mpg123
  

• 管道播放流媒体mp3示例：

  curl -s 流媒体mp3地址 | mpg123 -
  

如果偏好使用sox，可在播放命令中指定HDMI设备：

cat 本地mp3文件/流媒体输入 | play -t mp3 - -d plughw:0,1

命令中plughw:0,1需替换为你实际的HDMI设备编号

验证步骤 #

容器内执行以下命令确认HDMI输出正常：

aplay -l # 确认能识别到HDMI音频设备
speaker-test -D plughw:0,1 -t wav # 替换为你的HDMI设备编号，确认有音频输出

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