数据类型

本文介绍智能媒体生产内容库相关数据类型。

MediaInfo

媒资内容信息

字段名

类型

描述

MediaId

String

媒资ID,全局唯一

MediaBasicInfo

MediaBasicInfo

媒资基础信息,包含标题、描述等

FileInfoList

FileInfo[]

媒资文件信息,一个媒资可能包含多条文件信息

AiRoughDataList

AiRoughData[]

AI原始结果

DynamicMetaDataList

DynamicMetaData[]

其他元数据 (对AI原始结果统一化处理后的AI数据, 用户自定义数据)

MediaBasicInfo

媒资基础信息

字段名

类型

描述

MediaId

String

媒资ID,全局唯一

- 32位UUID

InputURL

String

待注册的媒资在相应系统中的地址,现在支持oss 地址。

MediaType

String

媒资媒体类型。取值范围:

- "image" 图片

- "video" 视频

- "audio" 音频

- "text" 文字

BusinessType

String

媒资业务类型。取值范围:

- "subtitles" 字幕

- "watermark" 水印

- "opening" 片头/开场

- "ending" 片尾

- "general" 通用 (默认)

Source

String

来源,

- "oss" OSS存储

- "vod" 视频点播

- "live" 视频直播

- "general" 其他 (默认)

Title

String

标题,若不提供,根据日期自动生成默认title。

- 长度不超过128字节。

- UTF8编码。

Description

String

内容描述

- 长度不超过1024字节

- UTF8编码。

Category

String

分类

- 长度不超过64字节。

- UTF8编码。

MediaTags

String

标签。

- 最多不超过16个标签。

- 多个用逗号分隔。

- 单个标签不超过32字节。

- UTF8编码。

CoverURL

String

封面地址。

- 长度不超过128字节。

- UTF8编码。

UserData

String

用户数据

- 长度不超过1024字节。

- UTF8编码。

Status

String

资源状态。取值范围:

- Init(初始状态:源文件未就绪)

- Preparing(源文件准备中:比如上传中或者剪辑合成中)

- PrepareFail(源文件准备失败:比如获取源文件信息失败)

- Normal(正常:源文件已就绪)

TranscodeStatus

String

转码状态。取值范围: - Init(初始状态:未转码) - Transcoding(转码中) - TranscodeSuccess(转码成功) - TranscodeFail(转码失败)

CreateTime

String

媒资创建时间,格式:

"yyyy-MM-dd'T'HH:mm:ss'Z'"

ModifiedTime

String

媒资修改时间,格式:

"yyyy-MM-dd'T'HH:mm:ss'Z'"

DeletedTime

String

媒资删除时间,格式:

"yyyy-MM-dd'T'HH:mm:ss'Z'"

SpriteImages

String

雪碧图配置及地址

List<SnapshotDTO> -> json String

FileInfo

文件信息

字段名

类型

描述

FileBasicInfo

FileBasicInfo

文件基础信息,包含时长,大小等

AudioStreamInfoList

AudioStreamInfo[]

音频流信息,一个媒资可能有多条音频流

VideoStreamInfoList

VideoStreamInfo[]

视频流信息,一个媒资可能有多条视频流

SubtitleStreamInfoList

SubtitleStreamInfo[]

字幕流信息,一个媒资可能有多条字幕流

AiRoughData

AI原始数据

字段名

类型

描述

Type

String

AI类型。取值范围:

  • Face(人脸)

  • ASR(语音识别)

  • OCR(文字识别)

  • Label(物体/地标等识别)

  • VideoSummary(视频摘要)

  • Delogo(遮标)

  • Crop(裁剪)

  • H2V(横转竖)

  • Matting(抠像)

  • Color(颜色分析)

  • VideoCover(静态封面)

  • Beat(节奏检测)

Result

String

AI原始结果,当Result不超过16KB时,直接返回结果,若超过16KB,将AI原始结果写入oss文件,返回ossUrl

DynamicMetaData

动态元数据

字段名

类型

描述

In

Double

开始时间

Out

Double

结束时间

Type

String

类型。取值范围:

  • "ai" AI原始结果统一化处理后的AI数据

  • "user-defined" 用户自定义元数据

Data

String

元数据json string。

{"人物": "C罗", "动作": "射门", ...}

如果type为ai", 则key的取值范围:

- Person(人物)

- Sequence(片段)

- Shot(镜头)

- Color(颜色)

- Beat(节拍)

- Cover(封面)

FileBasicInfo

文件基础信息

字段名

类型

描述

FileName

String

文件名

FileStatus

String

文件状态

FileType

String

文件类型。取值范围:

  • "source_file" 源文件

  • "transcode_file" 二次处理文件

FileSize

String

文件大小,单位:字节

FileUrl

String

文件oss地址

Region

String

文件存储区域

FormatName

String

封装格式

Duration

String

时长,单位:秒

Bitrate

String

码率,单位:Kbps

Width

String

宽,单位:px

Height

String

高,单位:px

AudioStreamInfo

音频流信息

字段名

类型

描述

Index

String

音频流序号

CodecName

String

编码格式简述名

CodecLongName

String

编码格式长述名

CodecTimeBase

String

编码时基

CodecTagString

String

编码格式标记文本

CodecTag

String

编码格式标记

Profile

String

编码预置

SampleFmt

String

采样格式

SampleRate

String

采样率,单位:Hz

Channels

String

声道数

ChannelLayout

String

声道输出样式

Timebase

String

时基

StartTime

String

起始时间

Duration

String

时长,单位:秒

Bitrate

String

码率,单位:Kbps

Fps

String

音频帧率

NumFrames

String

总帧数

Lang

String

语言

VideoStreamInfo

视频流信息

字段名

类型

描述

Index

String

视频流序号

CodecName

String

编码格式简述名

CodecLongName

String

编码格式长述名

Profile

String

编码预置

CodecTimeBase

String

编码时基

CodecTagString

String

编码格式标记文本

CodecTag

String

编码格式标记

Width

String

宽,单位:px

Height

String

高,单位:px

HasBFrames

String

是否有B帧

Sar

String

编码信号分辨率比

Dar

String

编码显示分辨率比

PixFmt

String

像素格式

Level

String

编码等级

Fps

String

视频帧率

AvgFPS

String

平均帧率

Timebase

String

时基

StartTime

String

起始时间

Duration

String

时长,单位:秒

Bitrate

String

码率,单位:Kbps

NumFrames

String

总帧数

Lang

String

语言

Rotate

String

旋转

Nb_frames

String

总帧数

SubtitleStreamInfo

字幕流信息

字段名

类型

描述

Index

String

字幕流序号

CodecName

String

编码格式简述名

CodecLongName

String

编码格式长述名

CodecTimeBase

String

编码时基

CodecTagString

String

编码格式标记文本

CodecTag

String

编码格式标记

Timebase

String

时基

StartTime

String

起始时间

Duration

String

时长,单位:秒

Lang

String

语言

MediaTag

媒资标签

字段名称

类型

描述

MediaTagId

String

标签ID

MediaTagNameEnglish

String

标签英文名

MediaTagNameChinese

String

标签中文名

SnapshotDTO

截图信息

字段名

类型

描述

Config

String

截图配置,SnapshotConfig -> json String

SnapshotUrlList

List

带鉴权的截图URL列表

Count

String

截图数量,如果类型为雪碧图则为拼接出的大图数量

SnapshotUrlRegular

String

截图文件名规则,如果是一般截图placeHolder为{Count}, 如果是雪碧图placeHolder为{TileCount}

SnapshotConfig

截图配置

字段名

类型

描述

FrameType

String

截图的帧类型:intra(关键帧)、normal(普通帧)

Num

String

需要截取的图片数

Interval

String

截图的间隔时间,必须大于等于0,单位:秒。其中,Interval为0表示按照num数根据视频时长平均截图

Time

Long

截图指定时间的起始点,单位:毫秒。

Width

String

截图宽,取值范围:[8,4096],默认原片宽,单位:px。

Height

String

截图高,取值范围:[8,4096],默认原片高,单位:px。

SpriteSnapshotConfig

SpriteSnapshotConfig

雪碧图配置

SpriteSnapshotConfig

雪碧图配置

字段名

类型

描述

CellWidth

String

小图图宽,如果宽与高仅有一个不为空,表示小图维持原图宽高比。默认截图输出分辨率宽度。

CellHeight

String

小图图高,如果宽与高仅有一个不为空,表示小图维持原图宽高比。默认截图输出分辨率高度。

Padding

String

图片间距,默认0,单位px

Margin

String

外框宽度。默认:0单位:px

Columns

String

图片拼合列数。整型,取值范围:(0,10000],默认:10

Lines

String

图片拼合行数。整型,取值范围:(0,10000],默认:10

Color

String

背景颜色。取值范围:颜色关键字,random,默认:black,其中颜色关键字支持三种格式,比如黑色,支持Black,black,#000000

IsKeepCellPic

String

是否保留单图片。取值范围:true、false,默认:true