11、MediaMuxer实战：添加封面图（Album Art）——为音频文件设置封面

你有没有遇到过这种情况？

在手机里听自己录制的播客或音乐，播放器界面总是显示一个默认的灰色音符图标。说实话，这体验挺差的。我早期做的一个音频编辑App就因为这个被用户吐槽过——"连个封面都没有，太简陋了"。嗯，今天我们就来解决这个问题。

11.1 什么是Album Art？

Album Art，说白了就是音频文件的封面图。你在网易云音乐、QQ音乐里看到的专辑封面，就是它。技术上，它是一张嵌入到音频文件元数据（Metadata）中的图片。

常见的音频格式都支持封面图：

我们今天主要讲M4A/AAC格式，因为MediaMuxer原生支持MP4容器。我个人习惯用M4A做测试，兼容性好，处理起来也顺手。

11.2 MediaMuxer能直接添加封面吗？

直接回答：不能。

MediaMuxer只负责把音视频轨道数据写入MP4文件。封面图属于元数据，MediaMuxer压根不提供这个接口。我在项目中第一次遇到这个需求时，也以为MediaMuxer有现成API，翻了一圈文档才发现——嗯，想多了。

那怎么办？两个思路：

• 思路一：先用MediaMuxer生成不带封面的音频文件，再用MediaMetadataRetriever或第三方库写入封面。
• 思路二：直接用MediaCodec + MediaMuxer处理音频，最后用mp4parser或类似库修改元数据。

我个人推荐思路一，简单可靠，不用引入太多依赖。

11.3 核心流程：生成音频 + 写入封面

整个流程分两步走：

1. 用MediaMuxer把音频轨道写入MP4文件（M4A格式）
2. 用MediaMetadataRetriever或自定义方式写入封面图

等等，你可能会问：MediaMetadataRetriever不是用来读取元数据的吗？没错，但Android还提供了一个隐藏的API——MediaMetadataRetriever#setEmbeddedPicture()？其实没有。官方并没有提供写入封面的API。

那怎么办？

我踩过这个坑。当时翻遍了官方文档，发现Android从API 14开始就没有提供写入封面的标准API。最后我的解决方案是：用Java的RandomAccessFile直接操作MP4文件的元数据区域。

说白了，就是手动往MP4文件里塞一个"covr"原子（Atom）。

11.4 实战代码：手动写入封面图

下面是我在实际项目中用过的代码片段。注意，这里只展示核心逻辑，异常处理什么的你自己补上。

public class AlbumArtInjector {

    /**
     * 给M4A文件写入封面图
     * @param m4aPath 已生成的M4A文件路径
     * @param coverPath 封面图片路径（JPEG格式）
     */
    public static void injectCoverArt(String m4aPath, String coverPath) {
        File m4aFile = new File(m4aPath);
        File coverFile = new File(coverPath);
        
        if (!m4aFile.exists() || !coverFile.exists()) {
            throw new IllegalArgumentException("文件不存在");
        }

        try {
            // 1. 读取封面图片数据
            byte[] coverData = Files.readAllBytes(coverFile.toPath());
            
            // 2. 构建covr原子数据
            byte[] covrAtom = buildCovrAtom(coverData);
            
            // 3. 写入MP4文件
            injectAtom(m4aFile, covrAtom);
            
            Log.d("AlbumArt", "封面写入成功");
        } catch (IOException e) {
            Log.e("AlbumArt", "写入失败", e);
        }
    }

    private static byte[] buildCovrAtom(byte[] imageData) {
        // covr原子结构：
        // [原子大小(4字节)] [原子类型"covr"(4字节)] [数据(图片)]
        ByteBuffer buffer = ByteBuffer.allocate(8 + imageData.length);
        buffer.putInt(8 + imageData.length); // 原子总大小
        buffer.put("covr".getBytes());       // 原子类型
        buffer.put(imageData);               // 图片数据
        return buffer.array();
    }

    private static void injectAtom(File m4aFile, byte[] atomData) throws IOException {
        // 这里简化处理：直接追加到文件末尾
        // 实际项目中需要解析MP4结构，找到moov原子位置
        RandomAccessFile raf = new RandomAccessFile(m4aFile, "rw");
        raf.seek(raf.length());
        raf.write(atomData);
        raf.close();
    }
}

11.5 更靠谱的方案：使用mp4parser库

手动操作MP4原子太容易出错了。我后来改用了一个成熟的开源库——mp4parser（Google的mp4parser项目）。它提供了完整的MP4文件读写能力，包括元数据操作。

用mp4parser写入封面的代码简洁很多：

// 添加依赖：com.googlecode.mp4parser:isoparser:1.1.22

public static void addCoverToM4a(String m4aPath, String coverPath) throws IOException {
    File m4aFile = new File(m4aPath);
    File coverFile = new File(coverPath);
    
    // 读取M4A文件
    Movie movie = MovieCreator.build(m4aFile.getAbsolutePath());
    
    // 读取封面图片
    byte[] coverData = Files.readAllBytes(coverFile.toPath());
    
    // 创建covr原子
    Covr covr = new Covr();
    covr.setCoverData(coverData);
    
    // 获取moov盒子
    Container container = movie.getBoxes().get(0); // 通常是moov
    container.addBox(covr);
    
    // 写回文件
    FileOutputStream fos = new FileOutputStream(m4aFile);
    movie.writeContainer(fos);
    fos.close();
}

11.6 知识体系：封面图写入的核心逻辑

下面这张图帮你理清整个流程：

11.7 避坑指南

我在实际项目中踩过几个坑，分享给你：

• 图片格式问题：有些播放器只认JPEG格式的封面，PNG可能不显示。我建议统一用JPEG。
• 图片大小限制：封面图不要超过1MB。我见过一个用户塞了5MB的封面，结果播放器直接卡死。
• 原子位置问题：covr原子必须放在moov原子内部，不能随便放。否则播放器解析不到。
• 多封面问题：有些MP4文件可能包含多个covr原子，播放器可能只认第一个。写入前最好先清理旧的。

好了，关于MediaMuxer添加封面图的内容就这些。说实话，这个功能虽然不大，但很实用。你想想看，一个带封面的音频文件和没有封面的，用户体验差太多了。下次你的App再生成音频文件，记得加上封面——用户会感受到你的用心。

公众号:蓝海资料掘金营，微信deep3321