智能创作
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 智能创作 > 客户端 API > 媒体管理相关接口 > 获取媒体详情

获取媒体详情

最近更新时间：2022-03-23 17:12:07

我的收藏

本页目录：

接口描述

接口名称：/Material/DescribeMaterials。
接口功能：获取媒体详情，支持返回部分详情信息。

调用方式

具体调用方式参见 客户端 API 调用方式综述，您也可以使用 CME 客户端 API 调试工具 快速进行调试。

输入参数

字段
类型
必填
描述
MaterialIds
Array of String
是
搜索的媒体 ID 集合。
FilterInfo
否
选择过滤信息。
Sort
否
排序方式。Sort.Field 可选字段：CreateTime 创建时间；UpdateTime 最后修改时间。

输出参数

接口输出参数由 公共返回参数 和接口自身返回参数两部分组成。接口自身返回参数详情如下。
字段
类型
描述
MaterialInfoSet
Array of MaterialInfo
媒体信息集合。
FailedMaterialInfoSet
获取失败的媒体集合。

示例

示例1：获取媒体详情成功

获取 ID 为38192156030633420589的视频媒体详情，返回详情信息。

输入示例

{
    "MaterialIds": [
        "38192156030633420589"
    ]
}

输出示例

{
    "Code": "Success",
    "Message": "成功",
    "EnglishMessage": "success",
    "Data": {
        "MaterialBasicInfo": {
            "MaterialId": "38192156030633420589",
            "MaterialType": "VIDEO",
            "Name": "脱口秀",
            "CreateTime": "2020-12-14T09:05:08Z",
            "UpdateTime": "2020-12-14T09:05:08Z",
            "ClassPath": "/个人/视频",
            "TagSet": [
                "综艺",
                "脱口秀"
            ],
            "PreviewUrl": "https://cme.vod2.myqcloud.com/181000xxxx/8d388657vodtranscq181000xxxx/9be0dda85285890811308550195/coverBySnapshot/coverBySnapshot_10_0.jpg",
            "MediaUrl": "https://cme.vod2.myqcloud.com/181000xxxx/b64e98afvodcq181000xxxx/9be0dda85285890811308550195/ixbEocVHT1oA.mp4?t=5fdf14b4&whref=yunjian.qq.com&sign=ce15ca0558bebe775974e2821728xxxx",
            "Owner": {
                "Id": "ce4cdaf6-6039-486b-8f09-a5df23xxxxxx",
                "Type": "PERSON"
            }
        },
        "MediaInfo": {
            "Width": 1980,
            "Height": 1080,
            "Size": 167287626,
            "Duration": 1873.50202,
            "MediaType": "VIDEO"
        },
        "MaterialStatus": {
            "TranscodeStatus": "NORMAL"
        },
        "VideoMaterial": {
            "MetaData": {
                "AudioStreamInfoSet": [
                    {
                        "Bitrate": 95999,
                        "Codec": "aac",
                        "SamplingRate": 44100
                    }
                ],
                "VideoStreamInfoSet": [
                    {
                        "Bitrate": 615845,
                        "Codec": "h264",
                        "Fps": 30,
                        "Width": 1980,
                        "Height": 1080
                    }
                ],
                "Bitrate": 711844,
                "Container": "mov,mp4,m4a,3gp,3g2,mj2",
                "Duration": 1873.50202,
                "Width": 1980,
                "Height": 1080,
                "Size": 167287626,
                "Rotate": 0
            },
            "ImageSpriteInfo": {
                "Height": 80,
                "Width": 142,
                "TotalCount": 1874,
                "WebVttUrl": "https://181000xxxx.vod2.myqcloud.com/8d388657vodtranscq181000xxxx/9be0dda85285890811308550195/imageSprite/imageSprite_20056.vtt",
                "ImageUrlSet": [
                    "https://181000xxxx.vod2.myqcloud.com/8d388657vodtranscq181000xxxx/9be0dda85285890811308550195/imageSprite/imageSprite_20056_0.jpg",
                    "https://181000xxxx.vod2.myqcloud.com/8d388657vodtranscq181000xxxx/9be0dda85285890811308550195/imageSprite/imageSprite_20056_1.jpg"
                ]
            },
            "MaterialUrl": "https://cme.vod2.myqcloud.com/181000xxxx/b64e98afvodcq181000xxxx/9be0dda85285890811308550195/ixbEocVHT1oA.mp4?t=5fdf14b4&whref=yunjian.qq.com&sign=ce15ca0558bebe775974e2821728xxxx",
            "CoverUrl": "https://cme.vod2.myqcloud.com/181000xxxx/8d388657vodtranscq181000xxxx/9be0dda85285890811308550195/coverBySnapshot/coverBySnapshot_10_0.jpg",
            "Resolution": "FHD",
            "OriginalUrl": "https://181000xxxx.vod2.myqcloud.com/b64e98afvodcq181000xxxx/9be0dda85285890811308550195/ixbEocVHT1oA.mp4"
        }
    }
}

示例2：获取媒体详情失败

获取 ID 为38192156030633420589的视频媒体详情，返回权限不足。

输入示例

{
    "MaterialIds": [
        "38192156030633420589"
    ]
}

输出示例

{
    "Code": "OperationDenied.PermissionDeny",
    "Message": "权限不足",
    "EnglishMessage": "permission denied"
}

中国站