根据ICE公共版权媒资的 mediaId,获取并返回媒资信息。接口返回的URL为版权媒资的试听或试看地址,合成时会使用正式素材。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| MediaId |
string |
否 |
IMS 媒资 ID |
icepublic-****14e501538aeef0a3140176f6**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
RequestId |
******11-DB8D-4A9A-875B-275798****** |
| MediaInfo |
object |
媒资信息 |
|
| MediaId |
string |
媒资 ID |
icepublic-****14e501538aeef0a3140176f6**** |
| MediaBasicInfo |
object |
BasicInfo |
|
| MediaId |
string |
MediaId |
icepublic-****14e501538aeef0a3140176f6**** |
| MediaType |
string |
媒资媒体类型 |
video |
| BusinessType |
string |
媒资业务类型 |
general |
| Source |
string |
来源 |
oss |
| Title |
string |
标题 |
title |
| Description |
string |
内容描述 |
description |
| Category |
string |
分类 |
category |
| MediaTags |
string |
标签 |
标签,tag1 |
| CoverURL |
string |
封面地址 |
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires= |
| UserData |
string |
用户数据 |
{"key":"value"} |
| Status |
string |
资源状态 |
Normal |
| CreateTime |
string |
媒资创建时间 |
2020-12-26T04:11:08Z |
| ModifiedTime |
string |
媒资修改时间 |
2020-12-26T04:11:10Z |
| DeletedTime |
string |
媒资删除时间 |
2020-12-26T04:11:15Z |
| SpriteImages |
string |
雪碧图 |
[{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}] |
| DynamicMetaData |
object |
公共媒资动态元数据 |
|
| Type |
string |
类型。取值范围:
|
system |
| Data |
string |
元数据 json |
{"AuditionUrl": "http://example-bucket.cdn.domain.com/example.mp4", "AuditionCount": 3} |
| FileInfoList |
array<object> |
FileInfos |
|
|
array<object> |
|||
| FileBasicInfo |
object |
文件基础信息,包含时长,大小等 |
|
| FileName |
string |
文件名 |
example.mp4 |
| FileStatus |
string |
文件状态 |
Normal |
| FileType |
string |
文件类型 |
source_file |
| FileSize |
string |
文件大小(字节) |
27007 |
| FileUrl |
string |
版权媒资试听或试看地址。 |
http://example-bucket.cdn.domain.com/example.mp4 |
| Region |
string |
文件存储区域 |
cn-shanghai |
| FormatName |
string |
封装格式 |
mp4 |
| Duration |
string |
时长 |
16.2 |
| Bitrate |
string |
码率 |
192.0 |
| Width |
string |
宽 |
0 |
| Height |
string |
高 |
0 |
| AudioStreamInfoList |
array<object> |
音频流信息,一个媒资可能有多条音频流 |
|
|
object |
|||
| Index |
string |
音频流序号 |
1 |
| CodecName |
string |
编码格式简述名 |
aac |
| CodecLongName |
string |
编码格式长述名 |
AAC (Advanced Audio Coding) |
| CodecTimeBase |
string |
编码时基 |
1/44100 |
| CodecTagString |
string |
编码格式标记文本 |
mp4a |
| CodecTag |
string |
编码格式标记 |
0x6134706d |
| Profile |
string |
编码预置 |
High |
| SampleFmt |
string |
采样格式 |
fltp |
| SampleRate |
string |
采样率 |
44100 |
| Channels |
string |
声道数 |
2 |
| ChannelLayout |
string |
声道输出样式 |
stereo |
| Timebase |
string |
时基 |
1/44100 |
| StartTime |
string |
起始时间 |
0.000000 |
| Duration |
string |
时长 |
16.2 |
| Bitrate |
string |
码率 |
192.0 |
| Fps |
string |
音频帧率 |
10 |
| NumFrames |
string |
总帧数 |
162 |
| Lang |
string |
语言 |
und |
| VideoStreamInfoList |
array<object> |
视频流信息,一个媒资可能有多条视频流 |
|
|
object |
|||
| Index |
string |
视频流序号 |
0 |
| CodecName |
string |
编码格式简述名 |
h264 |
| CodecLongName |
string |
编码格式长述名 |
H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
| Profile |
string |
编码预置 |
High |
| CodecTimeBase |
string |
编码时基 |
1/48 |
| CodecTagString |
string |
编码格式标记文本 |
[0][0][0][0] |
| CodecTag |
string |
编码格式标记 |
0x0000 |
| Width |
string |
宽 |
960 |
| Height |
string |
高 |
540 |
| HasBFrames |
string |
是否有 B 帧 |
2 |
| Sar |
string |
编码信号分辨率比 |
0:1 |
| Dar |
string |
编码显示分辨率比 |
0:1 |
| PixFmt |
string |
像素格式 |
yuv420p |
| Level |
string |
编码等级 |
30 |
| Fps |
string |
视频帧率 |
24.0 |
| AvgFPS |
string |
平均帧率 |
24.0 |
| Timebase |
string |
时基 |
1/12288 |
| StartTime |
string |
起始时间 |
0.081706 |
| Duration |
string |
时长 |
216.206706 |
| Bitrate |
string |
码率 |
1001.594 |
| NumFrames |
string |
总帧数 |
5184 |
| Lang |
string |
语言 |
und |
| Rotate |
string |
旋转 |
0 |
| Nb_frames |
string |
总帧数 |
5184 |
| SubtitleStreamInfoList |
array<object> |
字幕流信息,一个媒资可能有多条字幕流 |
|
|
object |
|||
| Index |
string |
字幕流序号 |
1 |
| CodecName |
string |
编码格式简述名 |
srt |
| CodecLongName |
string |
编码格式长述名 |
SubRip Text |
| CodecTimeBase |
string |
编码时基 |
29.97 |
| CodecTagString |
string |
编码格式标记文本 |
unicode |
| CodecTag |
string |
编码格式标记 |
unicode |
| Timebase |
string |
时基 |
30 |
| StartTime |
string |
起始时间 |
0 |
| Duration |
string |
时长 |
1 |
| Lang |
string |
语言 |
und |
示例
正常返回示例
JSON格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"MediaInfo": {
"MediaId": "icepublic-****14e501538aeef0a3140176f6****",
"MediaBasicInfo": {
"MediaId": "icepublic-****14e501538aeef0a3140176f6****",
"MediaType": "video",
"BusinessType": "general",
"Source": "oss",
"Title": "title",
"Description": "description",
"Category": "category",
"MediaTags": "标签,tag1",
"CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
"UserData": "{\"key\":\"value\"}",
"Status": "Normal",
"CreateTime": "2020-12-26T04:11:08Z",
"ModifiedTime": "2020-12-26T04:11:10Z",
"DeletedTime": "2020-12-26T04:11:15Z",
"SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]"
},
"DynamicMetaData": {
"Type": "system",
"Data": "{\"AuditionUrl\": \"http://example-bucket.cdn.domain.com/example.mp4\", \"AuditionCount\": 3}"
},
"FileInfoList": [
{
"FileBasicInfo": {
"FileName": "example.mp4",
"FileStatus": "Normal",
"FileType": "source_file",
"FileSize": "27007",
"FileUrl": "http://example-bucket.cdn.domain.com/example.mp4",
"Region": "cn-shanghai",
"FormatName": "mp4",
"Duration": "16.2",
"Bitrate": "192.0",
"Width": "0",
"Height": "0"
},
"AudioStreamInfoList": [
{
"Index": "1",
"CodecName": "aac",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecTimeBase": "1/44100",
"CodecTagString": "mp4a",
"CodecTag": "0x6134706d",
"Profile": "High",
"SampleFmt": "fltp",
"SampleRate": "44100",
"Channels": "2",
"ChannelLayout": "stereo",
"Timebase": "1/44100",
"StartTime": "0.000000",
"Duration": "16.2",
"Bitrate": "192.0",
"Fps": "10",
"NumFrames": "162",
"Lang": "und"
}
],
"VideoStreamInfoList": [
{
"Index": "0",
"CodecName": "h264",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Profile": "High",
"CodecTimeBase": "1/48",
"CodecTagString": "[0][0][0][0]",
"CodecTag": "0x0000",
"Width": "960",
"Height": "540",
"HasBFrames": "2",
"Sar": "0:1",
"Dar": "0:1",
"PixFmt": "yuv420p",
"Level": "30",
"Fps": "24.0",
"AvgFPS": "24.0",
"Timebase": "1/12288",
"StartTime": "0.081706",
"Duration": "216.206706",
"Bitrate": "1001.594",
"NumFrames": "5184",
"Lang": "und",
"Rotate": "0",
"Nb_frames": "5184"
}
],
"SubtitleStreamInfoList": [
{
"Index": "1",
"CodecName": "srt",
"CodecLongName": "SubRip Text",
"CodecTimeBase": "29.97",
"CodecTagString": "unicode",
"CodecTag": "unicode",
"Timebase": "30",
"StartTime": "0",
"Duration": "1",
"Lang": "und"
}
]
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。