audiobusio – 支持数字总线上的音频输入和输出¶
该 audiobusio模块包含通过数字总线提供对音频 IO 的访问的类。这些协议用于将音频传送到同一电路中的其他芯片。它不包括 S/PDIF 等音频互连协议。
所有库都会更改硬件状态，并且在不再需要它们时应取消初始化。为此，请调用deinit() 或使用上下文管理器。
在这些板上可用
-
class
audiobusio.I2SOut(bit_clock: microcontroller.Pin, word_select: microcontroller.Pin, data: microcontroller.Pin, *, left_justified: bool)¶ 输出 I2S 音频信号
创建与给定引脚关联的 I2SOut 对象。
- 参数
Metro M0 Express上 使用 UDA1334 Breakout的简单 8ksps 440 Hz 正弦波：
import audiobusio import audiocore import board import array import time import math # Generate one period of sine wave. length = 8000 // 440 sine_wave = array.array("H", [0] * length) for i in range(length): sine_wave[i] = int(math.sin(math.pi * 2 * i / length) * (2 ** 15) + 2 ** 15) sine_wave = audiocore.RawSample(sine_wave, sample_rate=8000) i2s = audiobusio.I2SOut(board.D1, board.D0, board.D9) i2s.play(sine_wave, loop=True) time.sleep(1) i2s.stop()
从闪存播放波形文件：
import board import audioio import audiocore import audiobusio import digitalio f = open("cplay-5.1-16bit-16khz.wav", "rb") wav = audiocore.WaveFile(f) a = audiobusio.I2SOut(board.D1, board.D0, board.D9) print("playing") a.play(wav) while a.playing: pass print("stopped")
-
playing:bool¶ 输出音频样本时为真。（只读）
-
paused:bool¶ 播放暂停时为真。（只读）
-
__exit__(self) → None¶ 退出上下文时自动取消初始化硬件。有关更多信息，请参阅 Lifetime 和 ContextManagers
-
play(self, sample: _typing.AudioSample, *, loop: bool = False) → None¶ 当 loop=False 时播放一次样本，当 loop=True 时连续播放。不阻塞。使用
playing以块。样品必须是
audiocore.WaveFile,audiocore.RawSample,audiomixer.Mixer或audiomp3.MP3Decoder。样本本身应由 8 位或 16 位样本组成。
-
class
audiobusio.PDMIn(clock_pin: microcontroller.Pin, data_pin: microcontroller.Pin, *, sample_rate: int = 16000, bit_depth: int = 8, mono: bool = True, oversample: int = 64, startup_delay: float = 0.11)¶ 录制输入 PDM 音频流
创建与给定引脚关联的 PDMIn 对象。这允许您从给定的引脚记录音频信号。个别端口可能会进一步限制记录参数。总采样率由
sample_ratex决定，总采样率oversample必须为 1MHz 或更高，因此sample_rate必须至少为 16000。- 参数
clock_pin (Pin) – 将时钟输出到的引脚
data_pin (Pin) – 从中读取数据的引脚
sample_rate (int) – 结果样本的目标 sample_rate。检查
sample_rate实际值。最小采样率约为 16000 Hz。bit_depth (int) – 每个样本的最终位数。必须能被 8 整除
mono (bool) – 捕获单个音频通道时为真，否则捕获两个通道
oversample (int) – 要抽取为最终样本的单个位样本数。必须能被 8 整除
startup_delay (float) – 启动麦克风时钟后等待的秒数以允许麦克风打开。大多数只需要0.01s；有些需要0.1s。越久越安全。必须在 0.0-1.0 秒的范围内。
-
sample_rate:int¶ 录音的实际采样率。由于内部时钟限制，这可能与构建的采样率不匹配。
-
record(self, destination: _typing.WriteableBuffer, destination_length: int) → None¶ 将样本的 destination_length 字节记录到目标。这是阻塞。
当目的地太慢而无法以给定的速率录制音频时，可能会引发 IOError。对于内部闪存，建议在记录前将全 1 写入文件以加快写入速度。
- 返回
记录的样本数。如果该值小于
destination_length，则由于处理时间而遗漏了一些样本。