Vid 模式与 DirectUrl 模式的全链路说明
最近更新时间：2024.04.07 17:18:50
首次发布时间：2023.03.31 18:53:50
视频点播支持 Vid 和 DirectUrl 两种媒资管理模式。您选择不同的模式，在不同模块中具体的操作不同。本文提供这两种模式的全链路对比说明。
Vid 模式
在视频点播中，Vid 模式为标准模式。在 Vid 模式下，串联视频点播各个模块的桥梁是视频 ID (Vid)。Vid 是一个源视频和该视频转出的分辨率、编解码格式、封装格式等属性不同的转码产物集合的 ID。
默认情况下，您上传视频后系统会自动生成 Vid。您可利用 Vid 作为索引查找或者管理视频。触发媒体处理工作流时，您需要使用 Vid 作为入参来定位到被处理的视频，最终使用 Vid 请求服务端获取播放信息后就能成功地播放视频文件。
DirectUrl 模式
对于习惯使用标准对象存储的用户，视频点播还提供 DirectUrl 模式。在 DirectUrl 模式下，串联各个模块的桥梁是文件路径 FileName。FileName 是媒资对象在点播存储桶中的唯一标识，通过空间名和文件路径可确定唯一的一个对象。
文件路径的格式为：文件前缀/文件名称.文件后缀，例如 development/finance/projects.mp4。具体说明如下：
- 文件前缀：
development/finance/呈现目录结构，在控制台上则体现为多个嵌套的文件夹。 - 文件名称：
projects即文件名称。 - 文件后缀：
.mp4，又称文件拓展名，一般用于指代文件的类型。
全链路能力对比
登录视频点播控制台，进入空间。您可完成媒资上传、进行媒资管理、处理媒体文件、视频分发加速和视频播放等不同模块的操作。
媒资上传
操作说明
对比项 | Vid | DirectUrl |
|---|---|---|
上传入参 | 获取上传地址和凭证时，只需传入媒资的基础信息，如目标空间名、文件类型等。 | 获取上传地址和凭证时，除传入媒资的基础信息外，还需要传入文件路径 FileName |
上传服务端处理 | 点播服务将自动生成随机 32 位字符串作为 Vid。 | 存储用户输入的 FileName |
上传结果 | 将 Vid 作为上传结果的一个参数返回给客户端。 | 将 FileName 作为上传结果的一个参数返回给客户端。 |
存储位置 | 视频点播系统自动生成。点播服务端将把媒资存储在存储桶的固定位置中，以 Vid 命名。 | 视频点播支持自定义设置
|
操作步骤
您可通过以下方式进行媒资上传。
- 点播控制台：单击左侧导航栏媒资管理 > 视频管理，进入视频管理页面。您可根据自身业务需求，切换不同模式，单击上传视频按钮，跳转到媒资上传页面。如下图所示，DirectUrl 模式在上传时需要携带文件路径，具体操作请参见媒资上传。
- OpenAPI 或服务端 SDK：
- Vid 模式：调用 ApplyUploadInfo 接口上传文件，您需要传入
SpaceName、FileType等参数。 - DirectUrl 模式：调用 ApplyUploadInfo 接口上传文件，您需要传入
SpaceName、FileType等参数，同时您还需要传入 FileName。
- Vid 模式：调用 ApplyUploadInfo 接口上传文件，您需要传入
媒资管理
操作说明
对比项 | Vid | DirectUrl |
|---|---|---|
列表索引 | Vid | 文件路径 FileName |
检索 | 根据 Vid 检索 | 根据前缀检索 |
目录结构 | 不支持，需要结合分类管理进行媒资分类。 | 支持，通过目录就可以分类管理。 |
列表顺序 | 上传时间由新到旧 | 上传时间由新到旧 |
操作步骤
- 单击左侧导航栏媒资管理 > 视频管理，进入视频管理页面。
- 您可根据自身业务需求，切换不同模式的页签，查看 Vid 模式和 DirectUrl 模式列表。
媒体处理
操作说明
Vid 模式和 DirectUrl 模式下，转码服务本身没有区别，主要是触发工作流和转码产物存储的规则有如下区别：
- 触发工作流
- Vid 模式：通过 Vid 定位需要转码的媒资。
- DirectUrl 模式：通过空间名和文件路径定位需要转码的媒资。
- 转码产物存储
- Vid 模式：生成转码产物后自动上传，转码产物与片源拥有相同 Vid。
- DirectUrl 模式：支持设置自定义转码产物文件路径的规则，生成转码产物后将按照文件路径存储在相应的位置。
操作步骤
- 登录视频点播控制台，进入空间。
- 单击左侧导航栏媒体处理设置 > 媒体处理模板，进入媒体处理模板页面。您可根据自身业务需求，配置不同的处理模板，具体操作请参见媒体处理模板。
- 单击左侧导航栏媒体处理设置 > 工作流模板，进入工作流模板页面。您可根据自身业务需求，根据页面提示完成参数配置。具体操作请参见配置工作流模板。
- 通过以下方式对已上传的视频发起处理任务。
- 通过以下方式使用已创建好的工作流模板上传视频，在上传时自动触发转码任务：
- 点播控制台：单击左侧导航栏媒资管理 > 视频管理，进入视频管理页面。
- 在 Vid 模式下，进行媒体处理，具体操作请参见 Vid 模式视频处理；
- 在 DirectUrl 模式下，进行媒体处理，具体操作请参见 DirectUrl 模式视频处理。
- OpenAPI 或服务端 SDK：调用 StartWorkflow 接口发起工作流，您需要传入工作流模板 ID 。
说明
文件路径触发不支持水印贴片模板、检测修复模板、智能字幕模板和多媒体 AI 模板。
视频分发加速
操作说明
对比项 | Vid | DirectUrl |
|---|---|---|
下发方式 | 必须通过 |
|
CDN 配置 | 两者一致 | |
操作步骤
- Vid 模式：调用 GetPlayInfo 接口，传入 Vid 参数，下发播放地址。
- DirectUrl 模式：您可通过拼接方式的规则访问播放地址，具体操作请参见签名计算。
视频播放
操作说明
- Vid 模式：在 Vid 模式下，根据使用平台对接点播播放器，完成视频播放。
- DirectUrl 模式：使用 URL 播放方式播放点播视频，需要将播放器的数据源设置为播放地址。播放地址可以是第三方点播地址或火山引擎点播服务中的播放地址。
操作步骤
移动端 SDK
Web 端 SDK
参考 Web 播放器的集成 SDK，完成 Web 端播放器的接入。
回调处理
操作说明
- Vid 模式：您可以从回调的结构体中获取 Vid。
- DirectUrl 模式：您可以从回调的结构体中获取文件路径 FileName。
操作步骤
- 点播控制台：单击左侧导航栏系统设置 > 回调设置，进入回调设置页面，您可根据自身业务需求，进行回调事件的参数配置。具体操作请参见事件通知概述。
- 回调事件：您也可通过 URL 批量拉取上传完成、媒资上传完成事件、工作流执行完成事件等回调事件获取处理结果。