细节调整

This commit is contained in:
zhongluofeng committed 2026-09-23 18:29:20 +08:00
1 parent bccd21fde5
commit 79bded1cd2
25 files changed
+2655 -494

No files matched your search

+175
View File
@@ -0,0 +1,175 @@
//! cpal 输出流:把缓冲里的交错 f32 样本按设备格式喂给声卡。
//!
//! # 采样率策略(关系到音质)
//!
//! cpal 的 WASAPI **共享模式**输出带 `AUDCLNT_STREAMFLAGS_AUTOCONVERTPCM |
//! AUDCLNT_STREAMFLAGS_SRC_DEFAULT_QUALITY`,因此**可以用源采样率直接建流**,
//! 由 Windows 自己转换到设备混音格式。这样做的两个好处:
//!
//! 1. 不必自己引入重采样器,也就不会临时用一版质量不明的 SRC 把音质拉低;
//! 2. 与现状(WebView2 内部同样把音频交给共享模式输出)**同级**,不构成退步。
//!
//! 后续要做 bit-perfect(独占模式)时,只需把这里换成独占模式的 `IAudioClient`
//! 初始化:源采样率直出、绕过 Windows 混音器,届时**必须**要求源采样率与设备一致,
//! 否则要自己做高质量重采样。
//!
//! # 线程归属
//!
//! `cpal::Stream` 在 Windows 上不是 `Send`,**必须**在创建它的线程上持有与丢弃。
//! 因此本模块只提供 [`build`],由播放线程调用并把返回的流保存在自己内部。
use std::sync::atomic::Ordering;
use std::sync::Arc;
use cpal::traits::{DeviceTrait, HostTrait, StreamTrait};
use super::engine::Shared;
/// 建立输出流并立即启动。**必须在播放线程上调用**(见模块注释的线程归属说明)。
pub fn build(shared: &Arc<Shared>) -> Result<cpal::Stream, String> {
let host = cpal::default_host();
let device = host
.default_output_device()
.ok_or_else(|| "没有可用的默认音频输出设备".to_string())?;
let supported = device
.default_output_config()
.map_err(|e| format!("读取默认输出配置失败: {e}"))?;
let sample_format = supported.sample_format();
let out_channels = supported.channels();
let rate = shared.rate.load(Ordering::Relaxed);
shared.out_channels.store(out_channels, Ordering::Relaxed);
// 声道数用**设备**的(AUTOCONVERTPCM 只保证采样率可任意,声道布局仍按设备来),
// 采样率用**源**的。解码出来的样本在 fill() 里做声道映射。
let config = cpal::StreamConfig {
channels: out_channels,
sample_rate: rate.into(),
buffer_size: cpal::BufferSize::Default,
};
let stream = match sample_format {
cpal::SampleFormat::F32 => build_typed::<f32>(&device, config, shared.clone()),
cpal::SampleFormat::I16 => build_typed::<i16>(&device, config, shared.clone()),
cpal::SampleFormat::I32 => build_typed::<i32>(&device, config, shared.clone()),
cpal::SampleFormat::U16 => build_typed::<u16>(&device, config, shared.clone()),
other => Err(format!("不支持的输出采样格式: {other:?}")),
}?;
stream
.play()
.map_err(|e| format!("启动音频输出失败: {e}"))?;
Ok(stream)
}
/// 按设备默认采样格式建流,回调里统一用 f32 计算、再转成设备格式输出。
fn build_typed<T>(
device: &cpal::Device,
config: cpal::StreamConfig,
shared: Arc<Shared>,
) -> Result<cpal::Stream, String>
where
T: cpal::SizedSample + cpal::FromSample<f32>,
{
let err_shared = shared.clone();
device
.build_output_stream(
config,
move |data: &mut [T], _| fill(data, &shared),
move |e| {
// 设备被拔掉 / 被独占 / 驱动异常:只记日志并把会话标记为失败,
// 由引擎把错误转成前端提示。这里**不能** panic —— 它在音频线程上。
crate::logger::log_error("music-audio", &format!("音频输出流错误: {e}"));
err_shared.failed.store(true, Ordering::Relaxed);
},
None,
)
.map_err(|e| format!("创建音频输出流失败: {e}"))
}
/// 音频回调:把队列里的交错样本搬进设备缓冲。
///
/// 全程只做「出队 + 乘增益 + 转格式」,不加锁以外的任何分配/系统调用,
/// 以免在实时线程上引入不可控的延迟(会直接表现为爆音)。
fn fill<T>(data: &mut [T], shared: &Shared)
where
T: cpal::SizedSample + cpal::FromSample<f32>,
{
let out_ch = shared.out_channels.load(Ordering::Relaxed) as usize;
let src_ch = shared.src_channels.load(Ordering::Relaxed) as usize;
// 尚未确定声道数(刚起会话)或异常值:先输出静音,不能除零
if out_ch == 0 || src_ch == 0 {
for s in data.iter_mut() {
*s = T::from_sample(0.0);
}
return;
}
// 暂停:输出静音但**不消费队列**,恢复播放时数据不丢
if !shared.playing.load(Ordering::Relaxed) {
for s in data.iter_mut() {
*s = T::from_sample(0.0);
}
return;
}
let target = if shared.muted.load(Ordering::Relaxed) {
0.0
} else {
f32::from_bits(shared.volume.load(Ordering::Relaxed))
};
let mut gain = f32::from_bits(shared.gain.load(Ordering::Relaxed));
let frames = data.len() / out_ch;
// 音量在本块内线性走到目标值:拖动音量滑块/切静音时不会有台阶式的爆音。
let step = if frames > 0 {
(target - gain) / frames as f32
} else {
0.0
};
let mut consumed: u64 = 0;
{
let mut queue = shared.buf.lock().unwrap_or_else(|e| e.into_inner());
for f in 0..frames {
gain += step;
let base = f * out_ch;
// 一帧源数据 = src_ch 个样本;不足一帧(解码没跟上)就整帧输出静音
let mut src = [0f32; 8];
let has_frame = queue.len() >= src_ch;
if has_frame {
for slot in src.iter_mut().take(src_ch.min(8)) {
*slot = queue.pop_front().unwrap_or(0.0);
}
consumed += 1;
}
for c in 0..out_ch {
let v = if !has_frame {
0.0
} else if out_ch == 1 && src_ch > 1 {
// 多声道 → 单声道:取平均,避免只留左声道
let n = src_ch.min(8);
src[..n].iter().sum::<f32>() / n as f32
} else if src_ch == 1 {
// 单声道 → 任意声道数:复制
src[0]
} else if c < src_ch.min(8) {
src[c]
} else {
// 源声道数少于设备声道数:多出来的声道填静音
0.0
};
data[base + c] = T::from_sample(v * gain);
}
}
}
if consumed > 0 {
shared.frames_played.fetch_add(consumed, Ordering::Relaxed);
}
shared.gain.store(gain.to_bits(), Ordering::Relaxed);
}