直接跳到内容

Audio 音频

音频组件用于展示音频播放器,可以显示本地或远程音频文件、NumPy ndarray 或 Torch Tensor。

该组件还允许访问和控制播放器状态,包括切换播放/暂停和循环状态、当前播放时间和音量。

音频播放器支持 oggmp3wav 文件格式。

如果安装了 SciPy,还支持 1 维 NumPy ndarray 和 1 维 Torch Tensor。数据类型必须是以下之一:

  • numpy: np.int16, np.uint16, np.float32, np.float64
  • torch: torch.short, torch.int16, torch.half, torch.float16, torch.float, torch.float32, torch.double, torch.float64

数组或张量输入将被 SciPy 降采样到 16bit 并转换为 wav 文件。

底层实现为panel.pane.Audio,参数基本一致,参考文档:https://panel.holoviz.org/reference/panes/Audio.html

基本用法

PnAudio 组件可以通过指向远程音频文件的 URL 或本地音频文件构建(在这种情况下,数据被嵌入):

控制播放

播放器可以使用其自身的控件控制,也可以通过 Python 代码控制。要在代码中暂停或取消暂停,请使用 paused 属性:

NumPy 数组输入

当提供 NumPy 数组或 Torch 张量时,应指定 sample_rate

在此示例中,我们绘制了一个频率调制信号:

API

属性

属性名说明类型默认值
object本地文件路径、指向音频文件的远程URL、1维numpy数组或1维torch张量string, numpy.ndarray, torch.Tensor None
autoplay当为True时,指定输出将自动播放。在Chromium浏览器中,这需要用户点击一次播放boolean False
loop是否在播放结束时循环boolean False
muted当为True时,指定输出应该被静音boolean False
name面板的标题str None
paused播放器是否暂停boolean True
sample_rate给定NumPy数组或Torch张量时的采样率int 44100
throttle以毫秒为单位的当前播放采样频率int 500
time当前播放时间(秒)float 0
volume音量范围为0-100int 100
sizing_mode尺寸调整模式str 'fixed'
width宽度int, str None
height高度int, str None

Controls

src/examples/panel_vuepy/panes/Audio

Audio 音频已经加载完毕