Files
vllm-omni/vllm_omni/utils/audio.py
T
fcf1085395 [Refactor][OutputProcessor 2/8]: OmniRequestOutput should inherit RequestOutput and no nested wrap-up (#5146)
Signed-off-by: Boao Shi <aoibosh@connect.hku.hk>
Signed-off-by: bowieshi <aoibosh@connect.hku.hk>
Signed-off-by: princepride <wangzhipeng628@gmail.com>
Signed-off-by: R2-Y <ruiruyang2@gmail.com>
Signed-off-by: amy-why-3459 <wuhaiyan17@huawei.com>
Signed-off-by: Shi Boao Bowie <aoibosh@connect.hku.hk>
Co-authored-by: 汪志鹏 <wangzhipeng628@gmail.com>
Co-authored-by: ruirui(rein) yang <73573651+R2-Y@users.noreply.github.com>
Co-authored-by: amy-why-3459 <wuhaiyan17@huawei.com>
Co-authored-by: Gao Han <hgaoaf@connect.ust.hk>
Co-authored-by: Hongsheng Liu <liuhongsheng4@huawei.com>
2026-08-12 22:58:23 +08:00

108 lines
3.3 KiB
Python

# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project
"""Audio utility functions shared across models and entrypoints."""
import numpy as np
import torch
from torchaudio.functional import melscale_fbanks
from vllm_omni.metrics import definitions as _metric_defs
from vllm_omni.outputs import OmniRequestOutput
def mel_filter_bank(
sr: int,
n_fft: int,
n_mels: int,
fmin: float = 0.0,
fmax: float | None = None,
) -> torch.Tensor:
"""Compute a mel filterbank matrix.
Drop-in replacement for ``librosa.filters.mel`` using
``torchaudio.functional.melscale_fbanks``.
Args:
sr: Sample rate of the audio.
n_fft: FFT window size.
n_mels: Number of mel bands.
fmin: Minimum frequency (Hz).
fmax: Maximum frequency (Hz). Defaults to ``sr / 2``.
Returns:
Tensor of shape ``(n_mels, n_fft // 2 + 1)``.
"""
if fmax is None:
fmax = float(sr) / 2.0
# Use mel_scale='slaney' and norm='slaney' to match librosa's
# default behaviour (Slaney 1998 frequency mapping with area
# normalization).
return melscale_fbanks(
n_freqs=n_fft // 2 + 1,
f_min=float(fmin),
f_max=float(fmax),
n_mels=n_mels,
sample_rate=sr,
mel_scale="slaney",
norm="slaney",
).T
def peak_normalize(
audio: np.ndarray,
db_level: float = -6.0,
) -> np.ndarray:
"""Normalize audio so peak amplitude reaches a target dB level.
Drop-in replacement for ``sox.Transformer().norm(db_level=...)``.
Args:
audio: Input waveform as a 1-D numpy array.
db_level: Target peak amplitude in dBFS.
Returns:
Normalized waveform with the same dtype as *audio*.
"""
peak = np.abs(audio).max()
if peak == 0:
return audio
target = 10.0 ** (db_level / 20.0)
return audio * (target / peak)
def audio_chunk_pcm_bytes(omni_res: OmniRequestOutput) -> int:
"""Best-effort PCM byte count of the last audio chunk in ``omni_res``.
Used by the audio-streaming continuity tracker to size the player buffer.
Returns 0 when the chunk shape can't be interpreted — caller drops the
sample rather than recording a wrong byte count.
"""
try:
final_res = omni_res
mm_output = final_res.outputs[0].multimodal_output
audio_data = mm_output.get("audio")
if isinstance(audio_data, list):
if not audio_data:
return 0
audio_tensor = audio_data[-1]
else:
audio_tensor = audio_data
if audio_tensor is None:
return 0
n_samples = int(audio_tensor.numel() if hasattr(audio_tensor, "numel") else audio_tensor.size)
# PCM s16le mono → 2 bytes per sample. This matches what
# _create_audio_choice serialises via CreateAudio (response_format="wav").
return max(n_samples, 0) * 2
except Exception:
return 0
def audio_chunk_sample_rate(omni_res: OmniRequestOutput) -> int:
"""Resolve audio sample rate for the request's audio stream."""
try:
mm_output = omni_res.outputs[0].multimodal_output
except Exception:
return _metric_defs.DEFAULT_AUDIO_SAMPLE_RATE
return _metric_defs.resolve_audio_sample_rate(mm_output)