FFmpeg 元数据

文章目录

元数据

在处理音视频文件时,了解其元数据信息是非常重要的。元数据是描述文件内容和属性的数据,包括了诸如标题、作者、时长、分辨率等信息。

使用ACDictonary API,可以查看元数据或者将元数据写入到AVFormatContext,AVStream,AVChapter和AVProgram结构体中,元数据保存在它们Metadata字段中。元数据是由一个键值对组成的。与FFmpeg中的所有字符串一样,元数据被假定为UTF-8编码的Unicode。请注意,在大多数情况下,demuxers导出的元数据不会检查字符串是否是有效的UTF-8。

需要记住的重要概念:

  • KEY是唯一的,不能存在相同的键。即一个demuxer不应该故意产生几个字面上不同但语义上相同的键。

  • 元数据是平面的,不是分层的,没有子标签。如果你想存储,例如,制片人Alice和演员Bob的孩子的电子邮件地址,可以有key=alice_and_bobs_childs_email_address。

  • 可以将几个修饰符应用于标记名。这是通过添加一个破折号('-')和修饰符名称,按照它们在下面的列表中出现的顺序来完成的。例如foo-eng-sort,而不是foo-sort-eng。

    • language:标记的值被本地化为特定的语言并附加ISO 639-2/B 3个字母的语言代码。例如:Author_get=Michael,Author_eng=Mike,原始/默认语言在非限定的Author标签中,如果demuxer设置了任何已翻译的标记,它应该设置一个默认值。
    • sort:应该用于排序的标记修改版本将附加-sort,例如:artist="The Beatles",artist-sort = "Beatles,The"。
  • 一些协议和demuxers支持元数据更新。在成功调用av_read_frame()之后,AVFormatContext.event_flags或AVStream.event_falgs将被更新以指示元数据是否修改。为了检测流上的元数据变化,你需要循环遍历AVFormatContext中的所有流,并检查它们各自的event_flags。

  • Demuxers视图以通用格式导出元数据,但没有通用等价物的标记会被保留u,因为它们存储在容器中。下面是一个通用标签名称列表:

    标签 描述
    album 该作品所属的专辑名称
    album_artist 如果与艺术家不同,则为专辑/合辑的主要创作者
    artist 作品的主要创作者
    comment 文件的任何附加描述
    composer 如果与艺术家不同,则为作品的作曲家
    copytight 版权持有者的名称
    creation_time 文件创建的日期,最好以ISO 8601格式表示
    date 创作日期
    disc 子集的数量
    encoder 生成文件的软件/硬件的名称/设置
    encoded_by 创建文件的个人/团体
    filename 文件的原始名称
    genre 音乐流派
    language 作品的主要表演语言,可以通过逗号分隔多个语言
    performer 如果与艺术家不同,则为表演作品的艺术家
    publisher 标签/发布者的名称
    service_name 广播中的服务名称(频道名称)
    service_provider 广播中的服务提供商名称
    title 作品的名称
    track 该作品在集合中的编号,可以是当前/总数的形式
    variant_bitrate 当前流所属的比特率变体的总比特率

代码实例,查看元数据

cpp 复制代码
void Widget::getMetaData()
{
    char *err = nullptr;                               // 错误信息
    const char *input_file = "../../source/audio.mp3"; // 输入文件路径
    AVFormatContext *fmt_ctx = nullptr;                // 文件格式上下文
    const AVDictionaryEntry *m = nullptr;              // 字典项

    // 打开输入文件
    int ret = avformat_open_input(&fmt_ctx, input_file, nullptr, nullptr);
    if (ret < 0)
    {
        av_strerror(ret, err, sizeof(err));
        qDebug() << "打开输入文件失败: " << err;
        return;
    }

    // 查找流信息
    ret = avformat_find_stream_info(fmt_ctx, nullptr);
    if (ret < 0)
    {
        av_strerror(ret, err, sizeof(err));
        qDebug() << "查找流信息失败: " << err;
        return;
    }

    // 输出元数据
    while (m = av_dict_get(fmt_ctx->metadata, "", m, AV_DICT_IGNORE_SUFFIX))
    {
        qDebug() << m->key << ": " << m->value;
    }

    avformat_close_input(&fmt_ctx);
}

运行结果如下:

相关推荐
StarsGreen4 天前
ffmpeg中常用结构体以及函数简介以及版本变化情况
ffmpeg
大飞哥软件自习室5 天前
视频批量截图并自动拼图是怎么做的:从四步向导、三种截帧模式到等距抽样与日志兜底的实现拆解,附 FFmpeg 调用与线程模型说明
ffmpeg·音视频·批量截图
todoitbo6 天前
把 K-Lite「什么都能播」搬上鸿蒙 PC:影匣播放器的 FFmpeg + libass 原生移植实录
华为·ffmpeg·harmonyos·鸿蒙
FlightYe7 天前
音视频修炼之容器与协议(四):RTSP详解
android·linux·ffmpeg·音视频·dash
架构师伯子明8 天前
ffmpeg学习4:opencv在音视频领域常用指令
opencv·学习·ffmpeg
Android系统攻城狮9 天前
Linux FFmpeg深度解析之avio_open调用流程与实战(三十八)
linux·运维·服务器·ffmpeg·音视频进阶·ffmpeg音视频
Android系统攻城狮10 天前
Linux FFmpeg深度解析之av_guess_format调用流程与实战(三十六)
linux·运维·服务器·ffmpeg·ffmpeg音视频进阶
Android系统攻城狮11 天前
Linux FFmpeg深度解析之av_write_frame调用流程与实战(三十三)
linux·运维·服务器·ffmpeg·音视频进阶·ffmpeg音视频
小豆庄13 天前
测试视频里的人脸车牌敏感信息自动化脱敏方案
计算机视觉·目标跟踪·ffmpeg·音视频·边缘计算·视频·敏捷流程
Android系统攻城狮14 天前
Linux FFmpeg深度解析之avcodec_default_get_encode_buffer调用流程与实战(二十八)
linux·运维·服务器·ffmpeg·车载音视频·ffmpeg音视频