接口描述
接口名称:
/Material/DescribeMaterials
。接口功能:获取媒体详情,支持返回部分详情信息。
调用方式
输入参数
字段 | 类型 | 必填 | 描述 |
MaterialIds | Array of String | 是 | 搜索的媒体 ID 集合。 |
FilterInfo | 否 | 选择过滤信息。 | |
Sort | 否 | 排序方式。Sort.Field 可选字段:CreateTime 创建时间;UpdateTime 最后修改时间。 |
输出参数
字段 | 类型 | 描述 |
MaterialInfoSet | Array of MaterialInfo | 媒体信息集合。 |
FailedMaterialInfoSet | Array of FailedMaterialInfo | 获取失败的媒体集合。 |
示例
示例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"}