音视频音频处理【免费下载链接】NAudioAudio and MIDI library for .NET项目地址https://gitcode.com/gh_mirrors/na/NAudio点击查看免费下载NAudio.Core 是 NAudio 3 架构拆分后的跨平台核心程序集它剥离了所有与具体音频 API 绑定的代码仅依赖 .NET 平台自身即可在 Windows、Linux、macOS 上运行。本文以仓库内 src/NAudio.Core/README.md 为骨架结合 src/NAudio.Core 下的源码与 tests/NAudio.Core.Tests 测试系统讲解它的接口模型WaveStream/IWaveProvider/ISampleProvider、WaveFormat体系、WAV/AIFF 文件读写、Sample Provider 处理链、重采样变调、DSP 工具与 G.711 编解码并给出可运行的实战代码帮助读者理解在 NAudio 3 时代如何围绕 Core 自行拼装平台后端。NAudio.Core 是什么跨平台、与音频 API 无关的核心NAudio.Core 的官方定位是“the cross-platform core of NAudio”它包含所有与底层音频 API 无关的内容因此目标框架是纯net9.0可以在 Windows、Linux 和 macOS 上直接使用详见 src/NAudio.Core/README.md 开头说明。所谓“与底层音频 API 无关”指的是它不包含WasapiOut、WaveOut、AsioOut、DirectSoundOut、AlsaOut这类直接驱动声卡的播放/录音后端。那些代码分别属于NAudio.Wasapi、NAudio.WinMM、NAudio.Asio、NAudio.Dmo、NAudio.Alsa等平台包。Core 提供的是它们共同依赖的上游音频数据的抽象、格式描述、文件读写、信号处理与混音逻辑。从 NAudio 3 的整体拆分来看参见 Docs/Architecture/NAudio3AssemblyLayoutPlan.md 与根目录 README.md 的包表NAudio.Core承载了WaveStream/IWaveProvider/ISampleProvider接口与基类体系WaveFormat及格式转换辅助类WAV、AIFF、raw PCM 文件的读写器混音、声像、音量、淡入淡出、偏移、单双声道转换等 Sample Provider重采样WdlResamplingSampleProvider与变调SmbPitchShiftingSampleProvider信号发生器、包络发生器、BiQuad 滤波器、FFT 等 DSP 工具G.711µ-law / a-law编解码器。此外根 README.md 的包表还注明 NAudio.Core 同时包含NAudio.Effects效果框架与 Sequencing 排序模块它们分别位于 src/NAudio.Core/Effects38 个效果相关源文件与 src/NAudio.Core/Sequencing16 个源文件后文会展开。何时使用 NAudio.Core原 README 给出的选型建议非常明确共两条路径1. 面向非 Windows 目标平台当你需要在 Linux 或 macOS 上读取、写入、加工音频时直接引用NAudio.Core。例如配合NAudio.Alsa做 Linux 播放/录音见 src/NAudio.Alsa 的AlsaOut/AlsaIn或配合NAudio.SoundFile做跨平台文件读写见 src/NAudio.SoundFile。2. 自行组合平台包而非引用全量元包如果只想用 WASAPI 加 Core而不想要 WinMM、ASIO、DMO、WinForms 等就可以只引用NAudio.WasapiNAudio.Core缩小依赖面。从元包 src/NAudio/NAudio.csproj 的源码可以印证这一点NAudio元包在任何目标框架下都固定引用NAudio.Core与NAudio.Midi第 36-38 行而NAudio.Asio、NAudio.Dmo、NAudio.WinMM、NAudio.WinForms、NAudio.Wasapi则通过ItemGroup Condition $(TargetPlatformIdentifier) windows 条件引用第 39-51 行——即 Windows 上才拉入平台后端非 Windows 目标框架下元包只剩跨平台部分。这与 src/NAudio/README.md 的描述一致“On a non-Windows target framework only the cross-platform pieces are referenced.”因此实践原则是如果只需 Core 的能力文件转码、混音、DSP、效果直接引NAudio.Core如果既要 Core 又要某个具体后端把后端包也引上只有希望“一个包搞定全部 Windows 音频能力”时才使用NAudio元包。工程与兼容性基础net9.0、Native AOT 与向量化内核src/NAudio.Core/NAudio.Core.csproj 揭示了几个重要的工程事实TargetFrameworknet9.0/TargetFrameworkCore 最低要求 .NET 9NAudio 3 已放弃 .NET Framework 与 .NET Standard 2.0根 README.md 明示。需要旧框架的用户应使用 NAudio 2.x。IsAotCompatibletrue/IsAotCompatibleCore 声明 Native AOT 兼容根 README.md 也把NAudio.Core列入 Native-AOT 兼容包清单。AllowUnsafeBlockstrue/AllowUnsafeBlocks内部 DSP 与格式编解码需要指针级操作。依赖System.Numerics.Tensors9.0.0项目注释说明它用于驱动向量化的 mix-add / volume 内核mixing 与音量处理的高性能实现基础在 TensorPrimitives 进入 BCL 之前以 NuGet 包形式随附。Native AOT 对类型设计有直接影响WaveFormat类头部的注释见 src/NAudio.Core/Wave/WaveFormats/WaveFormat.cs明确说明它不再携带[StructLayout]、不再被直接 marshalling 成WAVEFORMATEX——因为类继承字段在 Native AOT 下无法正确编组。需要跨原生边界时必须使用ToWaveFormatExBytes()、MarshalToPtr()、MarshalFromPtr()。这是读者在自行编写 AOT 应用时需要注意的细节。三大核心抽象WaveStream、IWaveProvider 与 ISampleProviderWaveStream所有 Wave 流的基类WaveStreamsrc/NAudio.Core/Wave/WaveStreams/WaveStream.cs继承自System.IO.Stream并实现IWaveProvider是可读、可定位、不可写的音频字节流抽象。其关键成员WaveFormat抽象属性描述流的音频格式CanRead/CanSeek恒为trueCanWrite恒为falseWrite与SetLength抛NotSupportedExceptionBlockAlign块对齐字节数默认取WaveFormat.BlockAlign定位时不应偏离该值的整数倍Skip(int seconds)按WaveFormat.AverageBytesPerSecond前后跳转秒数并自动夹取到流边界第 107-116 行CurrentTime/TotalTime基于Position/Length与AverageBytesPerSecond换算的TimeSpan设置CurrentTime时会向下取整到BlockAlign的整数倍保证停留在合法块边界第 123-134 行HasData(int count)当前位置是否仍有数据默认实现为Position Length。类头部注释给出了一个重要的性能指引第 10-30 行Stream.Read(byte[], int, int)是抽象方法必须重写而Read(Spanbyte)是虚方法其默认实现会从ArrayPool.Shared租缓冲再拷贝。为了性能应在Read(Spanbyte)中实现真正的读取逻辑并让byte[]重载转发给它public override int Read(Spanbyte buffer) { /* 真正的读取逻辑 */ } public override int Read(byte[] array, int offset, int count) Read(array.AsSpan(offset, count));仓库注释说明所有内置 reader 都遵循这一模式只重写byte[]重载的旧式子类仍能工作但每次基于 span 的读取都要付出一次缓冲池租借与一次拷贝。IWaveProvider 与 ISampleProvider字节流与浮点采样流的两种视图IWaveProvidersrc/NAudio.Core/Wave/WaveOutputs/IWaveProvider.cs只暴露WaveFormat属性其余通过Read方法读取编码后的字节ISampleProvidersrc/NAudio.Core/Wave/WaveOutputs/ISampleProvider.cs同样只有WaveFormat属性但Read(float[] buffer, int offset, int count)以32 位浮点形式读取采样。接口注释明确指出它存在的目的是“让搭建 32 位浮点混音引擎变得简单得多”。ISampleProvider 是整个 Sample Provider 处理链的基石混音、淡入淡出、声像、单双声道转换等都以它为输入输出用浮点运算避免整数处理的截断误差最后在输出端再转回 16/24 位整数或直接喂给播放后端。扩展方法在两种模型间自由切换src/NAudio.Core/Wave/WaveExtensionMethods.cs 提供了在两个模型之间转换的便捷方法是日常最常用的工具扩展方法作用源码位置ToSampleProvider()把IWaveProvider转为ISampleProvider仅适用于 PCM内部走SampleProviderConverters第 16-19 行ToWaveProvider()/ToWaveProvider16()把ISampleProvider包装回IWaveProvider后者额外转成 16 位整数第 63-76 行ToMono(leftVol, rightVol)立体声转单声道默认各取 0.5 音量已是单声道则原样返回第 81-85 行ToStereo(leftVol, rightVol)单声道转立体声默认 1.0/1.0第 90-94 行FollowedBy(silence, next)拼接两个采样源中间插入静音用OffsetSampleProvider的LeadOutConcatenatingSampleProvider实现第 99-103 行Skip(duration)/Take(duration)跳过或截取指定时长的采样基于OffsetSampleProvider第 108-118 行AsStandardWaveFormat()把WaveFormatExtensible或带 GUID 的WaveFormatExtraData还原为标准 PCM / IEEE float 格式第 38-56 行例如把一首 16 位立体声 WAV 转成单声道浮点流、取前 30 秒一行链式即可完成using NAudio.Wave; var pcm16 new WaveFileReader(input.wav).ToSampleProvider(); var mono30s pcm16.ToMono().Take(TimeSpan.FromSeconds(30));WaveFormat 体系与格式转换WaveFormatsrc/NAudio.Core/Wave/WaveFormats/WaveFormat.cs承载采样率、声道数、位深、编码标签、AverageBytesPerSecond、BlockAlign等 WAVEFORMATEX 核心字段。默认构造函数直接给出最常见的配置44.1 kHz、16 bit、立体声第 39 行。还提供ConvertLatencyToByteSize(int milliseconds)把毫秒延迟换算成块对齐的缓冲区字节数第 60-69 行播放器中“按延迟算缓冲”正是基于它。src/NAudio.Core/Wave/WaveFormats 目录下的完整格式族包括WaveFormatEncoding编码标签枚举WaveFormatExtensible/WaveFormatExtraData扩展格式前者用于程序构造后者是文件/流中物化出的形态AsStandardWaveFormat可把它还原为标准格式AdpcmWaveFormat、Gsm610WaveFormat、Mp3WaveFormat、TrueSpeechWaveFormat压缩格式描述Speakers声道布局掩码枚举AudioMediaSubtypesMedia Foundation 子类型 GUID 常量。文件读写WaveFileReader、WaveFileWriter、AiffFileReader 与 raw PCM原 README 列出的文件读写能力集中在 src/NAudio.Core/Wave/WaveStreams19 个源文件WaveFileReaderRIFF WAV 读取器配合WaveFileChunkReader解析 chunk、RiffChunk/CueList/BroadcastExtension处理扩展信息WaveFileWriterWAV 写入器在 src/NAudio.Core/Wave/WaveOutputs 下AiffFileReaderAIFF 读取器RawSourceWaveStream把任意Stream按给定WaveFormat当作裸 PCM 读取此外还有WaveChannel32把任意位深的单/多声道流统一转成 32 位浮点、Wave32To16Stream、WaveMixerStream32、WaveOffsetStream、BlockAlignReductionStream等流级处理工具。测试侧也有对应覆盖tests/NAudio.Core.Tests/WaveStreams下 45 个测试文件、WaveFormats下 4 个文件可作为行为参考见 tests/NAudio.Core.Tests。一个典型的纯 Core 转码例如把 16 位立体声 WAV 降为单声道并转成 8 位 PCM 输出可以这样组织using NAudio.Wave; using var reader new WaveFileReader(input.wav); // WAV 读取 var monoFloat reader.ToSampleProvider().ToMono(); // → 浮点 → 单声道 var wave16 monoFloat.ToWaveProvider16(); // 输出端回到 16 位整数 WaveFileWriter.CreateWaveFile16(output.wav, monoFloat); // 或直接写 16 位文件Sample Provider 处理链混音、声像、音量、淡入淡出与偏移src/NAudio.Core/Wave/SampleProviders 目录集中了 28 个采样级处理组件原 README 提到的“mixing, panning, volume, fade in/out, offset/skip/take, mono↔stereo conversion”在这里都有对应实现能力实现类文件说明混音MixingSampleProvider多路采样源混音支持动态增删源多路选择MultiplexingSampleProvider把多路输入按声道路由到输出声道矩阵ChannelMixerSampleProviderChannelMixMatrix任意声道数重映射声像PanningSampleProvider立体声声像定位音量VolumeSampleProvider线性音量增益淡入淡出FadeInOutSampleProvider淡入淡出包络偏移/截取OffsetSampleProviderSkipOver/Take/LeadIn/LeadOut等拼接ConcatenatingSampleProvider顺序拼接多路采样源单↔双声道MonoToStereoSampleProvider/StereoToMonoSampleProvider配合扩展方法ToStereo/ToMono测量MeteringSampleProvider/NotifyingSampleProvider采样级回调用于电平表、波形渲染ADSRAdsrSampleProvider包络发生器采样适配PCM 转换Pcm8/16/24/32BitToSampleProvider、WaveToSampleProvider(64)、SampleToWaveProvider(16/24)整数↔浮点、Wave↔Sample 双向桥接WaveExtensionMethods.Skip/Take/FollowedBy的底层正是OffsetSampleProvider与ConcatenatingSampleProvider见上文源码行号可见“处理链”即层层嵌套的ISampleProvider组合。例如淡出后拼接另一段音频using NAudio.Wave; var a new WaveFileReader(a.wav).ToSampleProvider(); var b new WaveFileReader(b.wav).ToSampleProvider(); var faded new FadeInOutSampleProvider(a, true); // 以静音开始BeginFadeIn 淡入 faded.BeginFadeIn(1000); faded.BeginFadeOut(2000); var chain faded.FollowedBy(TimeSpan.FromMilliseconds(500), b);重采样与变调重采样WdlResamplingSampleProvidersrc/NAudio.Core/Wave/SampleProviders/WdlResamplingSampleProvider.cs底层使用 Cockos 的WDL Resampler算法核心实现见 src/NAudio.Core/Dsp/WdlResampler.cs。构造时传入源与目标采样率即可典型场景是把 48 kHz 素材重采样到 44.1 kHz 输出。变调SmbPitchShiftingSampleProvider源码文件名为 src/NAudio.Core/Wave/SampleProviders/SMBPitchShiftingSampleProvider.cs基于 Stephan M. Bernsee 的 DFT 时域压伸/移调算法核心见 src/NAudio.Core/Dsp/SmbPitchShifter.cs可设置变调倍率与 FFT 尺寸。两者都位于 SampleProviders 层意味着它们可以无缝嵌入上面的处理链source → WdlResamplingSampleProvider → SmbPitchShiftingSampleProvider → 输出。信号发生器、包络、BiQuad 滤波与 FFT原 README 提到的 DSP 四件套在 src/NAudio.Core/Dsp21 个源文件中均有对应SignalGeneratorsrc/NAudio.Core/Wave/SampleProviders/SignalGenerator.cs正弦、方波、三角波、锯齿、白噪声/粉噪声等波形发生可配置频率与增益常用于测试音、报警音包络发生器EnvelopeGenerator/DahdsrEnvelopeAHDSR 包络/AdsrSampleProviderBiQuadFiltersrc/NAudio.Core/Dsp/BiQuadFilter.cs二阶 IIR 滤波器提供LowPassFilter/HighPassFilter/BandPassFilter/PeakingEQ等静态工厂FastFourierTransformsrc/NAudio.Core/Dsp/FastFourierTransform.csFFT 变换配合Complex、FftProcessor可用于频谱分析。除上述核心工具外Dsp 目录还包含Lfo、DelayLine、PartitionedConvolver分区卷积用于卷积混响、LinkwitzRileyCrossover、Oversampler、VoiceActivityDetector、DenormalGuard、ParameterSmoother、SynthMath等构成一个相对完整的音频 DSP 工具箱。对应测试见tests/NAudio.Core.Tests/Dsp6 个测试文件与tests/NAudio.Core.Tests/Effects17 个测试文件。由于 Core 不含播放后端信号发生器通常配合平台包使用在 Windows 上用NAudio.Wasapi/NAudio.WinMM播放在 Linux 上用NAudio.Alsa跨平台“生成即写文件”的路径则完全可由 Core 独立完成。G.711 编解码µ-law / a-lawsrc/NAudio.Core/Codecs 目录包含语音编解码器MuLawEncoder/MuLawDecoderµ-lawALawEncoder/ALawDecodera-lawG722CodecG.722 编码器。G.711 常见于电话语音、NAudioDemo的 NetworkChatDemo 中的语音通话编解码仓库样例见 samples/NAudioDemo/NetworkChatDemo 的MuLawChatCodec.cs、ALawChatCodec.cs。在 Core 中它们是纯计算代码可在任意平台使用。效果框架与排序NAudio.Core 中额外承载的两块能力虽然原 README 的 “Whats included” 清单未逐项列出但根 README.md 的包表明确把NAudio.Effects与Sequencing归入NAudio.Core包源码也印证了这一点src/NAudio.Core/Effects38 个源文件组成的效果框架包括 EQ 与滤波Equalizer、GraphicEqualizer、动态处理CompressorEffect、LimiterEffect、GateEffect、MultibandCompressorEffect、饱和与低保真SaturationEffect、BitCrusherEffect、延迟与调制DelayEffect、ChorusEffect、PhaserEffect、FlangerEffect、TremoloEffect、混响ReverbEffect、FdnReverbEffect、ConvolutionReverbEffect、变调PitchShiftEffect、干湿比与旁路EffectChain、EffectSampleProvider以及参数自动化模型EffectParameter、IParameterized、ParameterDispatchQueuesrc/NAudio.Core/Sequencing16 个源文件的排序模块包括EventTimeline、SequencerEvent、SequencedSampleProvider、节拍速度图ITempoMap、StaticTempoMap、LiveTempoMap、Transport、SwingTransform、LoopRegion等配套测试见tests/NAudio.Core.Tests/Sequencing10 个测试文件。这两块进一步扩大了“非平台后端”职责的边界凡是与具体声卡驱动无关的音频逻辑都被收进 Core。实战建议如何组合出最小可用工程综合以上内容可给出三条选型结论跨平台转码/加工任务Linux/macOS 上读 WAV、混音、重采样、变调、写文件只引NAudio.Core即可不需要任何 Windows 包。需要播放/录音时在 Core 之上按平台补充后端——Windows 用NAudio.Wasapi推荐或NAudio.WinMMLinux 用NAudio.AlsamacOS 用NAudio.MacOS希望“一个包解决”则直接引NAudio元包其在非 Windows 目标下会自动只带跨平台部分。Native AOT 应用Core 已声明IsAotCompatibletrue但跨原生边界时须通过WaveFormat的ToWaveFormatExBytes/MarshalToPtr/MarshalFromPtr显式编组不要依赖隐式 struct 布局。上手时可对照仓库的示例程序samples/NAudioConsoleTest跨平台控制台测试集与 samples/NAudioDemoWinForms 演示含AudioPlaybackDemo中多种后端适配器可观察 Core 与平台包的装配方式。许可证NAudio.Core 与整个 NAudio 项目一样采用MIT许可证参见仓库根目录的 LICENSE。这意味着 Core 可以被自由用于商业与开源项目只要保留版权声明即可。赞分享音视频音频处理【免费下载链接】NAudioAudio and MIDI library for .NET项目地址https://gitcode.com/gh_mirrors/na/NAudio点击查看免费下载相关推荐GLFW跨平台核心平台抽象层实现原理详解GLFW跨平台核心平台抽象层实现原理详解 你还在为跨平台窗口管理烦恼GLFW作为一款轻量级的多平台库为OpenGL、OpenGL ES和Vulkan提供了图形学桌面应用Qwen3.8-27B 全面解读阿里最强开源多模态大模型凭什么值得你立刻上手Qwen3.8 27B 全面解读阿里最强开源多模态大模型凭什么值得你立刻上手 Qwen3.8 27B 是阿里通义千问团队最新发布的开源多模态大模型也是目POCO跨平台图像处理库设计抽象接口与实现POCO跨平台图像处理库设计抽象接口与实现 引言 POCO C Libraries是功能强大的跨平台C库用于构建基于网络和互联网的应用程序可在桌面后端网络/通信数据库密码学Web框架上一篇完全掌握MTKClient5个专业技巧深度解析联发科设备底层控制下一篇90DaysOfDevOps深入理解 Go Workspace 与 go build / go install / go run 编译运行机制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
