VSCode环境下Jupyter Notebook运行Audio代码无法播放音频怎么办

问题表现 #

运行如下音频生成代码后，单元格正常输出音频播放控件，但点击播放按钮无响应，无法正常播放生成的音频：

import numpy as np
from IPython.display import Audio
framerate = 44100
t = np.linspace(0,5,framerate*5)
data = np.sin(2*np.pi*220*t) + np.sin(2*np.pi*224*t)
Audio(data, rate=framerate)

控件显示状态参考：

音频控件渲染正常，进度条、播放按钮、音量控制均可见，点击后进度条不移动，无声音输出。

故障原因 #

• 代码生成的音频数据不符合输入规范：两个正弦波叠加后数据幅值范围为[-2, 2]，超出了IPython Audio浮点型输入要求的[-1, 1]合法区间。原生Jupyter Lab、网页端Notebook会自动对超范围数据做归一化处理，但VSCode内置的Jupyter渲染器没有做这层兼容，直接解码失败。
• 旧版本VSCode Jupyter扩展存在兼容bug：IPython Audio默认将全量音频转成base64编码内嵌在单元格输出中，2023年之前的Jupyter扩展无法正确解析大体积的base64音频资源，导致控件加载不到有效音频数据。
• VSCode默认单格输出上限为1000行，5秒44.1kHz采样率的音频生成的base64数据长度超过阈值会被截断，造成音频文件损坏。

修复操作 #

按顺序执行以下操作即可解决问题：

1. 开启内置归一化修正幅值问题
   给Audio构造函数传入normalize=True参数，让IPython自动将音频数据缩放至合法幅值区间，这一步可以解决80%以上的同类问题：

   Audio(data, rate=framerate, normalize=True)
   

2. 切换音频加载方式避开base64解析bug
   如果第一步操作后仍无法播放，传入embed=False参数，让IPython将音频缓存为本地临时wav文件，通过本地文件路径加载资源，绕开base64解析逻辑：

   Audio(data, rate=framerate, normalize=True, embed=False)
   

3. 修复环境配置问题
   • 将VSCode中官方发布的Python、Jupyter两个扩展升级到最新版本，重启VSCode后重新运行代码
   • 打开VSCode设置面板，搜索notebook.output.textLineLimit，将单单元格输出行数上限调整为100000，避免长音频数据被截断。

修复完成后重新运行单元格，点击播放按钮即可听到220Hz与224Hz正弦波叠加产生的拍频声音。

内容的提问来源于stack exchange，提问作者An old man in the sea.