LingoRecorder 开源项目教程

LingoRecorder 开源项目教程

LingoRecorder LingoRecorder is a better recorder for Android, you can easily process pcm from it. 项目地址: https://gitcode.com/gh_mirrors/li/LingoRecorder

1. 项目介绍

LingoRecorder 是一个专为 Android 平台设计的优秀录音库，能够轻松处理 PCM 数据。它提供了多线程机制来保证处理能力和 PCM 数据的完整性，并通过抽象出 AudioProcessor 接口来支持录音和处理的分离。此外，LingoRecorder 还提供了 WavFileRecorder 以支持以文件形式生成录音数据，并提供了 AIDL 接口以便在另一个进程中处理录音数据。

2. 项目快速启动

2.1 添加依赖

在项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.liulishuo.engzo:lingo-recorder:1.2.5'
}

2.2 初始化 LingoRecorder

在你的 Android 项目中初始化 LingoRecorder，并设置录音停止和处理停止的监听器：

LingoRecorder lingoRecorder = new LingoRecorder();

lingoRecorder.setOnRecordStopListener(new LingoRecorder.OnRecordStopListener() {
    @Override
    public void onRecordStop(Throwable throwable, Result result) {
        // 录音过程中发生的任何异常都会在这里接收
        // 你可以从 Result 中获取录音时长和输出文件
    }
});

lingoRecorder.setOnProcessStopListener(new LingoRecorder.OnProcessStopListener() {
    @Override
    public void onProcessStop(Throwable throwable, Map<String, AudioProcessor> map) {
        // 处理过程中发生的任何异常都会在这里接收
        // 你可以获取注入到录音器中的任何处理器
        // 此回调会在 "onRecordStop" 之后调用
    }
});

2.3 开始录音

调用 startRecording 方法开始录音：

lingoRecorder.startRecording();

2.4 停止录音

调用 stopRecording 方法停止录音：

lingoRecorder.stopRecording();

3. 应用案例和最佳实践

3.1 自定义 AudioProcessor

你可以通过实现 AudioProcessor 接口来自定义自己的音频处理器：

public class CustomAudioProcessor implements AudioProcessor {
    @Override
    public void start() throws Exception {
        // 初始化处理器
    }

    @Override
    public void flow(byte[] bytes, int size) throws Exception {
        // 处理音频数据
    }

    @Override
    public boolean needExit() {
        // 判断是否需要退出处理
        return false;
    }

    @Override
    public void end() throws Exception {
        // 处理结束时的操作
    }

    @Override
    public void release() {
        // 释放资源
    }
}

3.2 在独立进程中运行 AudioProcessor

LingoRecorder 提供了 AIDL 接口，支持在独立的进程中运行 AudioProcessor。示例中自定义了一个 LocalScorerProcessor 运行在 "score" 进程中。

4. 典型生态项目

LingoRecorder 可以与其他音频处理库和工具结合使用，例如：

• MediaCodec: 用于音频的硬编码，如 FLAC 编码。
• FFmpeg: 用于音频的复杂处理和格式转换。
• TensorFlow Lite: 用于音频数据的机器学习处理。

通过这些工具和库的结合，LingoRecorder 可以实现更复杂的音频处理和分析任务。

LingoRecorder LingoRecorder is a better recorder for Android, you can easily process pcm from it. 项目地址: https://gitcode.com/gh_mirrors/li/LingoRecorder