智能多媒体 API

  • 音视频元信息

    最近更新时间:2018-01-18 18:22:21

    音视频元信息接口(avinfo)用于获取指定音频、视频资源的元信息。

    请求语法

    GET <AvDownloadURI>?avinfo HTTP/1.1
    Host: <AvDownloadHost>
    

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    <AvMetadataInfo>
    

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "streams": [
            {
                "index": 0,
                "codec_name": "h264",
                "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                "codec_type": "video",
                "codec_time_base": "1/30",
                "codec_tag_string": "avc1",
                "codec_tag": "0x31637661",
                "width": 1152,
                "height": 864,
                ...
            },
            {
                "index": 1,
                "codec_name": "aac",
                "codec_long_name": "Advanced Audio Coding",
                "codec_type": "audio",
                "codec_time_base": "1/44100",
                "codec_tag_string": "mp4a",
                "codec_tag": "0x6134706d",
                ...
            }
        ],
        "format": {
            "filename": "/disk1/fopd_tmpdir/avinfo184020568",
            "nb_streams": 2,
            "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
            "format_long_name": "QuickTime/MPEG-4/Motion JPEG 2000 format",
            "start_time": "0.000000",
            "duration": "6413.359589",
            ...
        }
    }
    
    • 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "code":     <HttpCode  int>, 
        "error":   "<ErrMsg    string>",
    }
    
    字段名称 必填 说明
    code HTTP状态码,请参考响应状态码
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 获取成功
    400 请求报文格式错误
    404 资源不存在
    599 服务端操作失败。

    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。

    示例

    http://media-resource.com0.z0.glb.qiniucdn.com/%E4%B8%83%E7%89%9B%E4%BA%91%E5%AD%98%E5%82%A8%E8%A7%86%E9%A2%91%EF%BC%8D%E4%B8%89%E5%91%A8%E5%B9%B4.mp4?avinfo
    

    将返回如下元信息(已经经过格式化,以便阅读):

    {
        "streams": [
            {
                "index": 0,    流索引号
                "codec_name": "h264",   编码器名
                "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",    编码器名全称
                "codec_type": "video",    编码器类型
                "codec_time_base": "1/30",    编码器每帧时长
                "codec_tag_string": "avc1",    编码器标签名
                "codec_tag": "0x31637661",    编码器标签
                "width": 1152,   宽度
                "height": 864,   高度
                "has_b_frames": 0,   记录帧缓存大小
                "sample_aspect_ratio": "1:1",   采样率
                "display_aspect_ratio": "4:3",
                "pix_fmt": "yuv420p",   像素个数
                "level": 40,   级别
                "is_avc": "1",
                "nal_length_size": "4",
                "r_frame_rate": "15/1",   真实基础帧率
                "avg_frame_rate": "15/1",   平均帧率
                "time_base": "1/15000",   每帧时长
                "start_time": "0.000000",   首帧时间
                "duration": "6413.333333",   文件总时间
                "nb_frames": "96200",   帧数
                "tags": {    标签
                    "creation_time": "2013-01-07 12:58:08",     创建时间
                    "language": "eng",   语言
                    "handler_name": "Video Media Handler"    处理器名字
                }
            },
            {
                "index": 1,   流索引号
                "codec_name": "aac",   编码器名
                "codec_long_name": "Advanced Audio 编码器全名Coding",   编码器名全称
                "codec_type": "audio",   编码器类型
                "codec_time_base": "1/44100",   编码器每帧时长
                "codec_tag_string": "mp4a",   编码器标签名
                "codec_tag": "0x6134706d",   编码器标签
                "sample_fmt": "s16",   采样格式
                "sample_rate": "44100",   采样率
                "channels": 2,   音频数
                "bits_per_sample": 0,   采样码率
                "r_frame_rate": "0/0",   真实基础帧率
                "avg_frame_rate": "0/0",   平均帧率
                "time_base": "1/44100",   每帧时长
                "start_time": "0.000000",   首帧时间
                "duration": "6413.374694",   文件总时间
                "nb_frames": "276201",   帧数
                "tags": {   标签信息
                    "creation_time": "2013-01-07 12:58:08",   创建时间
                    "language": "eng",   语言
                    "handler_name": "Sound Media Handler"   处理器名字
                }
            }
        ],
        "format": {
            "filename": "/disk1/fopd_tmpdir/avinfo184020568",   文件名
            "nb_streams": 2,   流的数目
            "format_name": "mov,mp4,m4a,3gp,3g2,mj2",   格式名  
            "format_long_name": "QuickTime/MPEG-4/Motion JPEG 2000 format",   格式名全称
            "start_time": "0.000000",   首帧时间
            "duration": "6413.359589",   时长
            "size": "101416337",   文件大小
            "bit_rate": "126506",   码率
            "tags": {   标签信息
                "major_brand": "mp42",   主品牌
                "minor_version": "1",   次要版本
                "compatible_brands": "M4V mp42isom",   兼容性品牌
                "creation_time": "2013-01-07 12:58:08"   创建时间
            }
        }
    }
    

    点击查看示例结果

    以上内容是否对您有帮助?
  • Close