当前位置: 代码网 > it编程>前端脚本>Python > 基于Python实现MP4文件格式验证工具

基于Python实现MP4文件格式验证工具

2025年08月19日 Python 我要评论
工具概述本工具用于检查mp4文件格式的正确性,通过解析文件结构、编码信息等关键要素,判断文件是否符合mp4格式规范,是否存在损坏或不兼容问题。适用于视频处理、文件校验等场景,帮助快速识别异常mp4文件

工具概述

本工具用于检查mp4文件格式的正确性,通过解析文件结构、编码信息等关键要素,判断文件是否符合mp4格式规范,是否存在损坏或不兼容问题。适用于视频处理、文件校验等场景,帮助快速识别异常mp4文件。

功能说明

工具通过以下维度验证mp4文件有效性:

  • 基础检查:验证文件是否存在、是否为有效文件、是否为空文件
  • 格式校验:确认文件是否为mp4/mpeg-4容器格式
  • 轨道检查:检测是否包含视频轨道(mp4文件必需)
  • 编码兼容性:验证视频/音频编码是否为mp4支持的主流编码
  • 信息提取:获取文件的格式、编码、分辨率、时长等详细信息

环境依赖

python版本:python 3.6及以上

依赖库:pymediainfo(用于解析媒体文件信息)

安装命令:pip install pymediainfo

完整代码

import os
from pymediainfo import mediainfo


def is_valid_mp4(file_path):
    """
    使用pymediainfo检查mp4文件格式是否正确

    参数:
        file_path: mp4文件路径

    返回:
        tuple: (是否有效, 错误信息/详细信息)
    """
    # 基础检查
    if not os.path.exists(file_path):
        return false, "文件不存在"

    if not os.path.isfile(file_path):
        return false, "路径不是一个文件"

    file_size = os.path.getsize(file_path)
    if file_size == 0:
        return false, "文件大小为0字节,可能为空文件"

    try:
        # 分析媒体信息
        media_info = mediainfo.parse(file_path)

        # 获取文件格式信息
        general_track = next(t for t in media_info.tracks if t.track_type == "general")
        format_name = general_track.format

        if format_name not in ["mpeg-4", "mp4"]:
            return false, f"不是mp4格式,实际格式为: {format_name}"

        # 检查是否包含视频轨道
        video_tracks = [t for t in media_info.tracks if t.track_type == "video"]
        if not video_tracks:
            return false, "文件不包含视频轨道"

        video_track = video_tracks[0]
        video_codec = video_track.codec_id or video_track.codec

        # 检查视频编码兼容性
        supported_video_codecs = ["avc1", "hev1", "hvc1", "mp4v", "vp09"]  # mp4常见视频编码
        if not any(codec in video_codec.lower() for codec in supported_video_codecs):
            return false, f"不支持的视频编码: {video_codec} (支持: {', '.join(supported_video_codecs)})"

        # 检查音频轨道(如果存在)
        audio_tracks = [t for t in media_info.tracks if t.track_type == "audio"]
        if audio_tracks:
            audio_codec = audio_tracks[0].codec_id or audio_tracks[0].codec
            supported_audio_codecs = ["mp4a", "mp3", "ac-3", "opus"]  # mp4常见音频编码
            if not any(codec in audio_codec.lower() for codec in supported_audio_codecs):
                return false, f"不支持的音频编码: {audio_codec} (支持: {', '.join(supported_audio_codecs)})"

        # 收集详细信息
        details = {
            "格式": format_name,
            "视频编码": video_codec,
            "分辨率": f"{video_track.width}x{video_track.height}",
            "时长": f"{video_track.duration / 1000:.2f}秒",
            "文件大小": f"{file_size / (1024 * 1024):.2f}mb"
        }

        return true, f"mp4格式正确。详细信息: {details}"

    except stopiteration:
        return false, "无法解析文件结构,可能不是媒体文件"
    except exception as e:
        return false, f"格式错误或文件损坏: {str(e)}"


if __name__ == "__main__":
    # 替换为你的mp4文件路径
    mp4_file = "d:\\vid_1931_040_ouput1.mp4"

    valid, message = is_valid_mp4(mp4_file)
    print(f"检查结果: {'有效' if valid else '无效'}")
    print(f"详情: {message}")

效果如下

使用方法

1. 代码结构

工具核心函数为is_valid_mp4(file_path),接收mp4文件路径作为参数,返回元组(是否有效, 信息描述)

  • 第一个返回值:布尔值(true表示格式正确,false表示异常)
  • 第二个返回值:字符串(错误原因或格式详情)

2. 运行步骤

(1)将工具代码保存为check_mp4.py

(2)修改代码中if __name__ == "__main__":部分的mp4_file变量,设置待检查的mp4文件路径:

mp4_file = "你的mp4文件路径"  # 例如:"d:\\test.mp4" 或 "/home/user/video.mp4"

(3)运行脚本:python check_mp4.py

(4)查看输出结果,判断文件格式是否正确

返回结果说明

1. 正常结果

当文件格式正确时,输出示例:

检查结果: 有效
详情: mp4格式正确。详细信息: {'格式': 'mpeg-4', '视频编码': 'avc1', '分辨率': '1920x1080', '时长': '30.50秒', '文件大小': '25.60mb'}

包含的关键信息:

  • 格式:文件容器格式(如mpeg-4)
  • 视频编码:视频流使用的编码(如avc1对应h.264)
  • 分辨率:视频宽×高(如1920x1080)
  • 时长:视频总时长(单位:秒)
  • 文件大小:文件占用存储空间(单位:mb)

2. 异常结果

常见异常情况及输出示例:

  • 文件不存在:检查结果: 无效 详情: 文件不存在
  • 非mp4格式:检查结果: 无效 详情: 不是mp4格式,实际格式为: avi
  • 无视频轨道:检查结果: 无效 详情: 文件不包含视频轨道
  • 编码不兼容:检查结果: 无效 详情: 不支持的视频编码: vp8 (支持: avc1, hev1, hvc1, mp4v, vp09)
  • 文件损坏:检查结果: 无效 详情: 格式错误或文件损坏: 无法解析媒体信息

支持的编码格式

工具默认支持的mp4兼容编码:

视频编码

  • avc1(h.264)
  • hev1/hvc1(h.265/hevc)
  • mp4v(mpeg-4视频)
  • vp09(vp9)

音频编码

  • mp4a(aac)
  • mp3(mp3)
  • ac-3(ac-3)
  • opus(opus)

如需扩展支持的编码,可修改代码中supported_video_codecssupported_audio_codecs列表。

注意事项

  • 工具仅验证文件格式规范性,不保证文件一定能正常播放(部分编码兼容但播放器不支持的情况需额外测试)
  • 对于超大文件(gb级),解析时间可能较长,建议耐心等待
  • 网络路径或共享文件可能因权限问题导致解析失败,建议先复制到本地再检查
  • 若出现pymediainfo相关错误,可尝试重新安装依赖:pip uninstall pymediainfo && pip install pymediainfo

通过本工具,可快速判断mp4文件是否符合格式规范,为视频处理、存储管理等场景提供可靠的格式校验支持。

到此这篇关于基于python实现mp4文件格式验证工具的文章就介绍到这了,更多相关python mp4文件格式验证内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com