媒体文件上传完成或完成媒体处理后,就可以通过控制台或者API获取到相应媒资信息。本文为您介绍通过控制台和API/SDK获取媒资信息的方法。
场景一:通过API获取/更新
媒资信息是描述一个媒体文件的结构化数据集合。为了满足不同业务场景的需求,视频点播将媒资信息划分为以下几种类型,可以通过不同的API独立获取和更新:
信息类型 | 获取信息API | 更新信息API | 使用场景 |
基础信息 | 获取媒资基础信息(标题/时长/状态)用于应用展示,更新媒资属性(标题/描述/封面图/分类ID/标签)完善内容管理。 | ||
源文件信息 | 源文件信息是从文件本身提取的Meta信息,不支持更新。 | 获取上传的原始文件地址和参数,常用于存档、二次处理或问题排查。 | |
播放信息 | 播放信息不支持更新。但可通过转码,转出新的音视频流。提交媒体转码作业 | 获取用于播放的地址(含鉴权),是视频播放功能的核心。 |
推荐使用服务端SDK调用API来获取和更新媒资信息,详情请参见VOD SDK使用说明。
场景二:通过控制台获取/更新
控制台提供了直观的界面来查看和管理单个媒资的详细信息,适合运营人员日常管理或开发阶段快速验证。
登录视频点播控制台。
点播控制台左侧的导航栏选择媒资库,单击音/视频、图片或短视频素材,进入音视频、图片或短视频素材页面。
单击管理查看媒资详情。

以音/视频管理为例:
基础信息
可以在基础信息页签查看或修改音/视频的标题、描述、分类、标签、封面等信息。信息编辑完成后,单击保存完成配置。

参数和说明如下表所示。
参数 | 说明 |
封面 | 您可以通过上传一张图片或选中某个视频截图,将其设置为默认的视频封面。 说明 可以上传自定义封面,仅支持JPG或PNG格式,最大1MB,分辨率不超过1920*1080。 |
名称 | 音/视频的名称,播放时在播放器窗口中可见,支持的长度范围为1~128个字节。 |
描述 | 音/视频的详细描述信息,支持的长度范围为0~1024个字节。 |
分类 | 可以在分类管理中,配置视频分类,详情请参见媒资分类。 |
标签 | 可以对每个音/视频添加多个标签,仅支持中文、英文、数字及下划线,输入逗号、分号,或按回车键完成单个标签输入。 |
视频地址
可以查看当前视频的原始文件、所有转码格式和所有清晰度的详细地址,以及相应的分辨率和码率信息。

功能和说明如下表所示。
功能 | 说明 |
复制地址 | 复制当前清晰度的播放地址到浏览器或播放器中预览播放。 |
预览 | 在控制台中直接预览当前清晰度的视频。 |
删除 | 删除对应清晰度视频。 |
一键清除 | 清除全部转码后的文件(不含原始文件),清除后无法恢复,请谨慎使用。 |
Web播放器代码
开发者可以根据需要,针对每个视频使用HTML代码或JavaScript代码。此外,还可以通过使用播放器参数(包括播放器尺寸、是否自动播放)的快捷配置工具,快速修改代码片段中的相应参数,提高工作效率。
仅当媒体资源为视频时,才存在Web播放器代码页签。
实际接入时请使用Web播放器的最新版本,详情请参见Web播放器。
