You need to enable JavaScript to run this app.
导航
Vid 模式与 DirectUrl 模式的全链路说明
最近更新时间:2024.06.26 19:43:09首次发布时间: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 命名。

视频点播支持自定义设置

  • 按照 FileName 中的前缀信息,存储在相应的文件夹下。
  • 按照 FileName 中的文件名进行命名。

操作步骤

您可通过以下方式进行媒资上传。

  • 点播控制台:单击左侧导航栏媒资管理 > 视频管理,进入视频管理页面。您可根据自身业务需求,切换不同模式,单击上传视频按钮,跳转到媒资上传页面。如下图所示,DirectUrl 模式在上传时需要携带文件路径,具体操作请参见媒资上传
    图片
  • OpenAPI 或服务端 SDK:
    • Vid 模式:调用 ApplyUploadInfo 接口上传文件,您需要传入SpaceNameFileType 等参数。
    • DirectUrl 模式:调用 ApplyUploadInfo 接口上传文件,您需要传入 SpaceNameFileType 等参数,同时您还需要传入 FileName。

媒资管理

操作说明

对比项

Vid

DirectUrl

列表索引

Vid

文件路径 FileName

检索

根据 Vid 检索

根据前缀检索

目录结构

不支持,需要结合分类管理进行媒资分类。

支持,通过目录就可以分类管理。

列表顺序

上传时间由新到旧

上传时间由新到旧

操作步骤

  1. 单击左侧导航栏媒资管理 > 视频管理,进入视频管理页面。
  2. 您可根据自身业务需求,切换不同模式的页签,查看 Vid 模式和 DirectUrl 模式列表。
    图片

媒体处理

操作说明

图片
Vid 模式和 DirectUrl 模式下,转码服务本身没有区别,主要是触发工作流和转码产物存储的规则有如下区别:

  • 触发工作流
    • Vid 模式:通过 Vid 定位需要转码的媒资。
    • DirectUrl 模式:通过空间名和文件路径定位需要转码的媒资。
  • 转码产物存储
    • Vid 模式:生成转码产物后自动上传,转码产物与片源拥有相同 Vid。
    • DirectUrl 模式:支持设置自定义转码产物文件路径的规则,生成转码产物后将按照文件路径存储在相应的位置。

操作步骤

  1. 登录视频点播控制台,进入空间。
  2. 单击左侧导航栏媒体处理设置 > 媒体处理模板,进入媒体处理模板页面。您可根据自身业务需求,配置不同的处理模板,具体操作请参见媒体处理模板概述
  3. 单击左侧导航栏媒体处理设置 > 工作流模板,进入工作流模板页面。您可根据自身业务需求,根据页面提示完成参数配置。具体操作请参见配置工作流模板
  4. 通过以下方式对已上传的视频发起处理任务。
    • 通过以下方式使用已创建好的工作流模板上传视频,在上传时自动触发转码任务:
    • 点播控制台:单击左侧导航栏媒资管理 > 视频管理,进入视频管理页面。
    • OpenAPI 或服务端 SDK:调用 StartWorkflow 接口发起工作流,您需要传入工作流模板 ID 。

说明

文件路径触发不支持水印贴片模板、检测修复模板、智能字幕模板和多媒体 AI 模板。

视频分发加速

操作说明

对比项

Vid

DirectUrl

下发方式

必须通过 GetPlayInfo 下发

  • 通过 GetPlayInfo 下发
  • 通过自行拼接获取:
    • 无鉴权时:加速域名/FileName
    • 有鉴权时:加速域名/FileName?签名参数

CDN 配置

两者一致

操作步骤

  • Vid 模式:调用 GetPlayInfo 接口,传入 Vid 参数,下发播放地址。
  • DirectUrl 模式:您可通过拼接方式的规则访问播放地址。

视频播放

操作说明

  • Vid 模式:在 Vid 模式下,根据使用平台对接点播播放器,完成视频播放。
  • DirectUrl 模式:使用 URL 播放方式播放点播视频,需要将播放器的数据源设置为播放地址。播放地址可以是第三方点播地址或火山引擎点播服务中的播放地址。

操作步骤

移动端 SDK

  1. 选择左侧导航栏点播 SDK
  2. 单击新建应用按钮,根据提示完成配置。
  3. 参考点播 SDK 文档,完成 SDK 的集成。双端视频播放的接入说明请参见如下链接。

Web 端 SDK

参考 Web 播放器的集成 SDK,完成 Web 端播放器的接入。

回调处理

操作说明

  • Vid 模式:您可以从回调的结构体中获取 Vid。
  • DirectUrl 模式:您可以从回调的结构体中获取文件路径 FileName。

操作步骤