NLayer 开源项目教程

NLayer 开源项目教程

NLayerMPEG 1 & 2 Decoder for Layers 1, 2, & 3项目地址:https://gitcode.com/gh_mirrors/nl/NLayer

项目介绍

NLayer 是一个完全托管的 MP3 到 WAV 解码器。该项目最初基于 JavaLayer (v1.0.1)，并已被移植到 C#。NLayer 主要用于解码 MP3 文件，支持 MPEG 1 & 2 的层 1、2 和 3。

项目快速启动

安装 NLayer

首先，通过 NuGet 安装 NLayer 包：

dotnet add package NLayer --version 1.15.0

解码 MP3 文件

以下是一个简单的示例，展示如何使用 NLayer 解码 MP3 文件：

using NLayer;

class Program
{
    static void Main()
    {
        const int samplesCount = 44100;
        var fileName = "myMp3File.mp3";
        var mpegFile = new MpegFile(fileName);
        float[] samples = new float[samplesCount];
        int readCount = mpegFile.ReadSamples(samples, 0, samplesCount);

        Console.WriteLine($"Read {readCount} samples.");
    }
}

应用案例和最佳实践

文件转换

NLayer 可以与 NAudio 结合使用，进行文件转换和实时播放。以下是一个示例，展示如何将 MP3 文件转换为 WAV 文件：

using NAudio.Wave;
using NLayer.NAudioSupport;

class Program
{
    static void Main()
    {
        var fileName = "myMp3File.mp3";
        var builder = new Mp3FileReader.FrameDecompressorBuilder(wf => new Mp3FrameDecompressor(wf));
        using (var reader = new Mp3FileReader(fileName, builder))
        {
            WaveFileWriter.CreateWaveFile("output.wav", reader);
        }
    }
}

实时播放

以下是一个示例，展示如何使用 NLayer 和 NAudio 进行实时播放：

using NAudio.Wave;
using NLayer.NAudioSupport;

class Program
{
    static void Main()
    {
        var fileName = "myMp3File.mp3";
        var builder = new Mp3FileReader.FrameDecompressorBuilder(wf => new Mp3FrameDecompressor(wf));
        using (var reader = new Mp3FileReader(fileName, builder))
        {
            using (var waveOut = new WaveOutEvent())
            {
                waveOut.Init(reader);
                waveOut.Play();
                while (waveOut.PlaybackState == PlaybackState.Playing)
                {
                    System.Threading.Thread.Sleep(100);
                }
            }
        }
    }
}

典型生态项目

NAudio

NAudio 是一个用于音频处理的开源库，广泛用于音频播放、录制和转换。NLayer 与 NAudio 结合使用，可以实现强大的音频处理功能。

CSCore

CSCore 是另一个音频处理库，提供了丰富的音频处理功能。NLayer 可以与 CSCore 结合使用，扩展音频处理的能力。

通过以上教程，您可以快速上手 NLayer 项目，并了解其在实际应用中的使用方法和最佳实践。

NLayerMPEG 1 & 2 Decoder for Layers 1, 2, & 3项目地址:https://gitcode.com/gh_mirrors/nl/NLayer