树莓派 Python 音频播放开发实战指南

关键点解析

💡 经验谈：如果遇到播放速度异常快或慢，八成是采样率没对上。用 file alert.wav 命令查看真实参数。

什么时候该用 PyAudio？

• 需要自定义音频流（如网络流播放）
• 实现全双工录音 + 播放
• 对延迟敏感的应用（<50ms）
• 自行解码后送原始 PCM 数据

但它也有缺点：不支持 MP3 解码。想播 MP3？得先转成 WAV，或者搭配 pydub 使用。

方案二：快速上手利器 —— pygame.mixer

你是不是只想让程序'响一下'就完事？比如按钮按下播放提示音？那完全没必要折腾 PyAudio。

试试 pygame.mixer —— 虽然它是游戏库的一部分，但在树莓派社区里早已成为'最香'的音频播放方案之一。

安装简洁

pip install pygame

没错，就这一句。而且它自带音频解码器，MP3、OGG、WAV 全都支持！

极简代码示例

import pygame
import time

def play_sound(file_path):
    pygame.mixer.init(frequency=44100, size=-16, channels=2, buffer=512)
    pygame.mixer.music.load(file_path)
    pygame.mixer.music.set_volume(0.7)
    pygame.mixer.music.play()
    # 等待播放完成
    while pygame.mixer.music.get_busy():
        time.sleep(0.1)

play_sound("welcome.mp3")

就这么几行，MP3 就响了。而且音量可调、支持循环播放，连缓冲区都可以设。

为什么开发者都喜欢它？

• API 极其简单，三步搞定：init → load → play
• 内置解码，无需额外安装 ffmpeg
• 资源占用低，适合长时间运行的服务
• 支持并发播放多个音效（通过 Channel 分配）

注意事项

• 第一次 init() 会有轻微延迟（初始化音频引擎）
• 不要频繁创建/销毁 mixer，建议全局初始化一次
• 多线程中使用时注意同步，避免冲突

📌 最佳实践：在主程序启动时初始化一次 mixer，后续复用即可。

# 应用启动时
pygame.mixer.init(frequency=44100, size=-16, channels=2, buffer=1024)
# 按需播放
pygame.mixer.music.load("beep.mp3")
pygame.mixer.music.play()

方案三：科学计算搭档 —— sounddevice

如果你正在做一个信号生成、音频分析或机器学习相关的项目，那你一定会爱上 sounddevice。

它的设计哲学很明确：一切皆为 NumPy 数组。正弦波、白噪声、滤波后的信号，只要是个数组，就能直接播放。

安装方便

pip install sounddevice numpy

播放一个标准音 A4（440Hz）

import numpy as np
import sounddevice as sd

def play_tone(freq=440, duration=2.0, sr=44100):
    t = np.linspace(0, duration, int(sr * duration), False)
    tone = 0.5 * np.sin(2 * np.pi * freq * t)
    sd.play(tone, samplerate=sr)
    sd.wait()  # 阻塞直到播放结束

play_tone()

是不是很像 MATLAB？这种写法非常适合教学演示、算法验证、合成音效等场景。

高级玩法：回调模式连续播放

不想阻塞主线程？可以用异步回调：

import numpy as np
import sounddevice as sd

def callback(outdata, frames, time, status):
    if status:
        print(status)
    frequency = 440.0
    phase = getattr(callback, 'phase', 0.0)
    t = (phase + np.arange(frames)) / 44100.0
    outdata[:, 0] = 0.5 * np.sin(2 * np.pi * frequency * t)  # 左声道
    outdata[:, 1] = outdata[:, 0]  # 右声道同步
    callback.phase = phase + frames

stream = sd.OutputStream(samplerate=44100, channels=2, callback=callback)
with stream:
    input("按回车停止...\n")

这种方式可用于生成无限持续音、实时信号注入等高级用途。

三种方案怎么选？一张表说清楚

✅ 总结一句话：

• 想快速响一声？用 pygame.mixer
• 做专业音频处理？选 PyAudio
• 玩信号合成或算法？上 sounddevice

实际项目中的常见'坑'与应对策略

❌ 问题 1：明明代码跑了，为啥没声音？

最常见的原因有三个：

1. 音频输出设备选错了（HDMI vs 耳机口）
2. 音量被系统静音
3. 文件路径错误或格式不受支持

🔧 排查步骤：

# 查看当前音频设备
arecord -l  # 录音设备
aplay -l    # 播放设备
# 测试是否能播放（绕过 Python）
aplay example.wav
# 查看音量设置
amixer controls | grep Master
amixer cset numid=1 -- 80%  # 设置主音量

❌ 问题 2：MP3 播放失败？

PyGame 有时会因缺少 GStreamer 插件无法播放 MP3。解决方案是安装 pydub + ffmpeg 做预处理：

sudo apt install ffmpeg
pip install pydub

然后转换格式：

from pydub import AudioSegment
# 转成 WAV 供 PyAudio 使用
audio = AudioSegment.from_mp3("input.mp3")
audio.export("output.wav", format="wav")

❌ 问题 3：多进程抢设备冲突？

Linux 一次只允许一个进程访问音频设备。多个脚本同时运行会导致'Device busy'。

🔧 解决办法：

• 使用文件锁协调访问
• 统一由一个服务负责播放
• 改用 PulseAudio（支持混音），但增加延迟

例如加个简单的锁机制：

import fcntl

with open("/tmp/audio.lock", "w") as f:
    fcntl.flock(f.fileno(), fcntl.LOCK_EX)  # 排他锁
    play_sound("alert.mp3")  # 安全播放
    fcntl.flock(f.fileno(), fcntl.LOCK_UN)  # 释放

实战案例：做个智能门铃

设想这样一个场景：有人按门铃，树莓派检测到 GPIO 上升沿，立刻播放一段 MP3 提示音。

import RPi.GPIO as GPIO
import pygame
import time

BUTTON_PIN = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(BUTTON_PIN, GPIO.IN, pull_up_down=GPIO.PUD_UP)
pygame.mixer.init(frequency=44100, size=-16, channels=2, buffer=512)

def on_button_pressed(channel):
    print("门铃被按下！")
    pygame.mixer.music.load("/home/pi/sounds/welcome.mp3")
    pygame.mixer.music.play()
    while pygame.mixer.music.get_busy():
        time.sleep(0.1)

# 添加边沿检测
GPIO.add_event_detect(BUTTON_PIN, GPIO.FALLING, callback=on_button_pressed, bouncetime=500)

try:
    print("等待按钮触发...")
    while True:
        time.sleep(1)
except KeyboardInterrupt:
    GPIO.cleanup()

这就是一个典型的物联网音频应用场景。结合网络还能实现远程播报、微信通知联动等功能。