简介
更新时间：2016-11-23 16:04:03
欢迎使用阿里云媒体转码服务。用户可以使用本文档介绍的API对进行相关操作。
请确保在使用这些接口前，已充分了解了媒体转码服务产品说明、使用协议和收费方式。
术语表
| 术语 | 全称 | 中文 | 说明 |
|---|---|---|---|
| OSS | Open Storage Service | 阿里云开放存储服务 | 媒体转码服务对用户存储于OSS的媒体文件进行转码，并将转码输出文件保存在MediaBucket中或者OutputBucket中。 |
| Bucket | OSS Bucket | OSS Bucket | 遵守OSS Bucket定义，只能包括小写字母，数字和短横线(-)，必须以小写字母或者数字开头，长度必须在3-255字节之间. |
| Location | OSS Location | OSS 数据中心 | 遵守OSS Location定义。 |
| Object | OSS Object | OSS Object | 遵守OSS Object定义，使用UTF-8编码，长度必须在1-1023字节之间，不能以“/”或者“\”字符开头。 |
| LocalFile | Local File | 本地媒体文件 | 用户本地存储的媒体文件，还没有上传到OSS。 |
| Input | Job Input | 作业输入 | 作业输入，包括InputFile以及其它一些转码作业输入配置参数 |
| InputFile | Input File | 输入文件 | 本地文件上传到OSS后，就转变成一个输入文件。 |
| Output | Job Output | 作业输出配置 | 作业输出配置由模板ID，水印列表，OutputFile，输出文件等属性构成。 |
| OutputFile | Output File | 输出文件 | 作业输出文件，存储于OSS上，由OutputLocation,OutputBucket,OutputObject唯一标识一个输出文件。 |
| OutputBucket | Output Bucket | 转码输出Bucket | 用户指定的转码输出Bucket，“OSS文件转码流程”中提交作业时需要指定的参数，用户必须通过媒体转码服务的控制台资源管理页面的Bucket授权频道授予OutputBucket给媒体转码服务有写权限。 |
| OutputLocation | Output Location | 转码输出Bucket所在的OSS Location | 转码输出Bucket所在的数据中心，“OSS文件转码流程”中提交转码作业时可以指定的参数，目前只支持指定输出到杭州数据中心（oss-cn-hangzhou）。 |
| Template | Transcode Template | 自定义模板 | 自定义模板是指用户自行定义转码参数的转码模板，它是转码参数（音频、视频、容器等）的集合。每个自定义模板有一个唯一ID。 |
| PresetTemplate | Preset Transcode Template | 预置模板 | 预置模版是媒体转码服务内置的智能转码模板，能根据输入文件的特点动态调整转码设置，从而为用户提供在一定带宽条件下的最优转码输出。由于输入文件本身有差异（分辨率、码率等），不一定所有的预置模板都适合于该输入文件。输入文件的转码使用预置模板时，需要调用"提交模板分析作业"接口（SubmitAnalysisJob）来触发模板分析；调用"查询模板分析作业"接口（QueryAnalysisJobList）来获取该输入文件可用的预置模板列表。媒体转码服务支持的预置模板详见附录 预置模板。 |
| WaterMarkTemplate | WaterMark Template | 水印模板 | 水印包括两部分参数：水印内容为可变参数；水印位置、偏移量、大小等为相对稳定的参数；相对稳定的参数构成水印模板，每个水印模板有一个唯一的ID。 |
| Job | Transcode Job | 转码作业 | 转码作业，一个转码作业由一路输入及一路输出构成，作业会被加入到管道中，管道中的作业会被调度引擎调度到转码系统进行转码。 |
| AnalysisJob | Analysis Job | 预置模板分析作业 | 预置模板分析作业由输入文件及分析配置构成，分析得到可用的预置模板。 |
| SnapshotJob | Snapshot Job | 截图作业 | 截图作业由输入文件及截图配置构成，得到输入文件按截图配置截取的图片。 |
| MediaInfoJob | MediaInfo Job | 媒体信息作业 | 媒体信息作业需指定输入文件，得到输入文件的媒体信息。 |
| Pipeline | Job pipeline | 管道 | 管道是一作业队列，转码作业加入到管道中，才会被媒体转码服务调度到转码执行；如果管道中作业数量过多，会排队等待。管道有激活、暂停两种状态；管道被暂停时，媒体转码服务不再调度此管道中的作业执行转码，直到管道被重新激活为止，已经在执行转码的作业不受影响。 |