使用Python pyo库播放音频文件报TypeError错误如何解决

报错根本原因 #

sndinfo()是pyo内置的音频元数据读取函数，只有当传入路径存在、且文件是pyo支持的可解码音频格式时，才会返回包含文件大小、时长、采样率、声道数等信息的元组；只要读取失败就会直接返回None，后续初始化SfPlayer时尝试将None解包为6个元数据变量，就会触发你看到的类型错误。
常见触发场景：

• 传入的音频路径不完整，最典型的就是漏写文件扩展名。你代码里的路径SNDS_PATH + r"/05.Black Alien - Take Ten"没有带音频后缀（比如.wav、.aif、.mp3），系统找不到对应文件自然读取失败。
• 路径拼接逻辑不规范，手动用+拼接斜杠在Windows环境下容易出现斜杠方向不匹配、转义字符冲突的问题，哪怕文件名写对了也可能识别不到路径。
• 路径正确但pyo缺少对应音频格式的解码依赖，最常见的是安装pyo时没有正确安装libsndfile解码库，无法读取对应格式的音频元数据。
• 音频存放路径包含中文、特殊emoji等非ASCII字符，部分旧版本pyo对这类路径的兼容性极差，也会导致读取失败。

修复方案 #

按以下步骤排查即可解决：

1. 先确认目标文件的完整名称。如果是调用pyo自带的示例音频，先运行下面的代码打印SNDS_PATH目录下的所有文件，拿到你要播放的音频的完整文件名（含后缀）：

from pyo import *
import os
# 打印pyo自带音频目录下的所有文件
print(os.listdir(SNDS_PATH))

2. 替换原有的手动路径拼接逻辑，用os.path.join做跨平台安全的路径拼接，拼接时补全文件后缀。可以在初始化播放器前加一步校验，提前定位路径问题，修正后的参考代码如下：

from pyo import *
import os

s = Server().boot()
# 注意替换后缀为你实际查到的文件后缀
path = os.path.join(SNDS_PATH, "05.Black Alien - Take Ten.wav")

# 提前校验文件可读性
file_info = sndinfo(path)
if file_info is None:
    raise RuntimeError(f"音频文件读取失败，请检查路径、文件格式是否支持：{path}")

sf = SfPlayer(path, speed=[1, 0.995], loop=True, mul=0.4).out()
s.gui(locals())

3. 如果路径校验通过但还是读取失败，直接卸载当前环境的pyo包，重新安装带全量解码依赖的官方发行版本，确保libsndfile等底层解码组件被正确安装，支持常见音频格式的读取。

提示：如果播放的是自己存储的非pyo自带音频，尽量把文件放在纯英文、无特殊符号的路径下，避免路径编码兼容问题。

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