视频即时处理

最近更新时间:2025-08-27 18:01:31

我的收藏

功能简介

视频转码,可以改变原始视频的编码格式、分辨率和码率等参数,以适应不同终端和网络环境的播放,是最常见的视频处理手段之一。
传统的离线转码是一种异步处理模式,需要对整个音视频预先进行解码和编码,处理耗时往往是原视频时长的 30% 至 50%,用户的等待时间较长。
EdgeOne 的视频即时处理可以实现上传后立即分发转码视频,无需等待。无论视频的长度有多长,都能实现秒级开播,为用户提供全新的媒体处理体验。

计费说明

此功能为收费功能,将根据视频处理时长计费,详见 计费说明

功能特性

优势
详情
简单易用
无需对接 APIs 或 SDK 发起处理任务或接收离线转码任务完成回调,即时转码处理通过给原视频播放地址后加参数便可即时播放转码视频。
耗时极短
使用离线转码需要异步等待转码任务完成。使用即时转码,无论原视频时长多长,都可以在极短时间内播放即时转码后的视频,几乎无需等待。
降低存储成本
传统离线转码功能需要存储处理后新输出的文件内容,但即时转码不需要存储处理输出的视频,支持仅缓存在 EdgeOne 边缘节点,源站存储成本倍数降低。

适用场景

场景
详情
UGC 用户上传视频
即时转码处理的耗时远小于离线处理,几乎在分发时同步完成,UGC 用户场景可以实现上传完成后能立即分发播放的效果,极大提升 UGC 用户体验,增加用户粘性。
线上教育长视频
线上课程长视频文件通常较大,编码后的文件会使存储成本成倍数增长。例如,使用传统方式转码一个原始 MP4 视频需要分别转 720p、1080p、2k 分辨率并封装为 HLS 格式,那么一共需存储 4 个视频文件,然而使用实时转码仅需要存储 1 个原始文件,极大节省存储成本。
广电 OTT
某些视频内容需要持续修改,视频创作者可以只保存视频 MP4 格式便于剪辑,当有终端播放请求时最近版本的视频内容将通过实时转码处理为便于播放的分辨率及封装格式并立即分发,极大提升效率。

准备工作

在边缘安全加速平台 EO 内已添加加速域名,且源站为可支持视频即时处理的源站。目前视频即时处理功能支持的源站范围包括:云点播(VOD)与其他对象存储类源站(包含第三方云厂商对象存储源站)。VOD 源站说明可参考 VOD 源站相关说明



注意:
如果您当前域名已经启用了 Token 鉴权,并且使用的鉴权方式是非 TypeV 鉴权,我们建议您在使用即时转码处理时,将鉴权方式修改为 TypeV,避免视频转码为 HLS 后鉴权无法通过。

使用方式

您可以直接通过在客户端请求 URL 中拼接即时处理相关参数来实现视频处理,可参考以下步骤了解如何使用。
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击多媒体服务 > 音视频处理,找到视频即时处理卡片。
3. 单击视频即时处理的开关,开启该能力。

4. 开启后,您只需要通过在客户端请求 URL 后拼接 /.edgeone-video 等相关参数传递视频处理需求,EdgeOne 将自动根据客户端请求 URL 内的视频处理参数完成视频处理。拼接参数说明参考:如何拼接即时转码 URL

如何拼接即时转码 URL

通过以下规则拼写即时转码后的文件地址可用于分发转码视频,或直接使用 生成转码地址工具 获取转码文件 URL,具体规则如下:
https://www.example.com/video.mp4/.edgeone-video/template={templateID}/media.{ext}
由以下四个部分组成:
1. 原始视频 URL:原始视频的完整 URL,例如:https://www.example.com/video.mp4
2. 视频处理固定参数:固定填写/.edgeone-video 目录,表示使用 EdgeOne 的视频处理功能。
3. 即时转码模板 ID:为即时转码指定一个模板,{templateID} 为模板 ID。
4. 转码后文件名:该参数固定为media 拼上一个后缀 {ext} ,目前后缀可以支持 m3u8 和 mp4 两种,分别代表转出 HLS 和 MP4 两种格式,具体支持的封装格式由 即时转码模板 决定。

即时转码模板

EdgeOne 为您提供了6个即时转码模板。您可以根据希望转出的分辨率,选择下面任意一个转码模板。
注意:
请注意使用转码模板时其对应的音视频输出封装格式。
当使用即时加密 BaseEncryption 模板时,请务必同时开启 Token 鉴权 TypeV
模板名称
模板 ID
转码模板说明
适用封装格式
预制模板-H264-标清-540P
SystemPresetAvcAac540p
视频分辨率:540P,视频编码格式:H.264,视频帧率:25fps,音频编码格式:AAC、双声道
支持 HLS
预制模板-H264-高清-720P
SystemPresetAvcAac720p
视频分辨率:720p,视频编码格式:H.264,视频帧率:25fps,音频编码格式:AAC、双声道
支持 HLS
预制模板-H264-全高清-1080P
SystemPresetAvcAac1080p
视频分辨率:1080P,视频编码格式:H.264,视频帧率:25fps,音频编码格式:AAC、双声道
支持 HLS
预制模板-H264-其余同源
SystemPresetAvcAacSourceResolution
视频分辨率:和原始视频一致,视频编码格式:H.264,视频帧率:25fps,音频编码格式:AAC、双声道
支持 HLS
预制模板-转封装
SystemPresetRemux
仅转封装,即视频分辨率、视频编码格式、音频编码格式、声道数等均和原始视频保持一致
支持 HLS 和 MP4
预制模板-即时加密
BaseEncryption
即时加密模板,对视频分片进行加密处理,提升文件分发安全性
支持 HLS
您还可根据业务需要创建新的视频转码模板,并进行自定义设置,操作步骤如下:
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击多媒体服务 > 音视频处理,找到视频即时处理模板卡片



3. 单击创建模板,根据需求填写模板参数。
模板名称:仅支持中文、字母、数字、连字符、2-120 个字符。
编码方式:H.264、H265
视频码率:128kbps - 10000kbps
分辨率:视频长边(视频宽度)和视频短边(视频高度)为128px - 1920px
帧率:1fps - 30fps
填充方式:留黑、留白、拉伸、高斯模糊
音频编码:AAC
声道:双声道
4. 创建完成后,返回视频即时处理模板卡片,复制模板 ID 即可用于拼接即时处理 URL。




拼写示例

假设您的视频播放 URL 是:https://www.example.com/video.mp4
如果希望获得即时转码 HLS 输出,选择 SystemPresetAvcAacSourceResolution 模板,拼接后的即时转码 URL 是:https://www.example.com/video.mp4/.edgeone-video/template=SystemPresetAvcAacSourceResolutionia.m3u8
如果希望将该视频转码为 1080P 分辨率的 HLS 格式输出,可以选择 SystemPresetAvcAac1080p 模板,拼写后的 URL 是:https://www.example.com/video.mp4/.edgeone-video/template=SystemPresetAvcAac1080p/media.m3u8
如果希望将该视频转码为 1080P 分辨率的 MP4 格式输出,可以选择 SystemPresetAvcAac1080p 模板,而 URL 中的文件后缀需要改成 mp4,拼写后的 URL 是:https://www.example.com/video.mp4/.edgeone-video/template=SystemPresetAvcAac1080p/media.mp4
如果希望加密视频,可以选择 BaseEncryption 模板,并开启 Token 鉴权TypeV,拼写后的 URL 是: https://www.example.com/video.mp4/.edgeone-video/template=BaseEncryption/media.m3u8?t=68830140&sign=0bea2ce65324daf685131978a34202a7

使用生成转码地址工具

为方便用户快捷获取拼参完成的转码地址,EdgeOne 控制台提供生成转码地址工具,按需填写转码参数后即可获取转码文件 ULR。
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击多媒体服务 > 音视频处理,找到视频即时处理卡片。
3. 单击视频即时处理的开关,开启该能力后,单击生成转码地址工具。



4. 请选择站点内加速域名的源站是 云点播(VOD)或对象存储类源站的域名,并填写准备转码处理的视频路径以及勾选目标转码配置。单击预览可预览原视频和转码视频是否正常播放,单击复制链接可获取转码视频播放地址用于加速分发。
网络协议:支持 HTTP 和 HTTPS,其中 HTTP 协议由于浏览器限制无法在控制台预览转码视频,请前往站外预览播放。
加速域名:请选择已绑定 云点播(VOD)或对象存储类源站的加速域名,如需创建源站请参考VOD源站指引。
视频路径:填写云点播(VOD)或对象存储类源站内音视频文件的访问路径,如:video/test.mp4
即时转码模板:选择预置即时转码模板,各模板适配的输出视频封装格式见 转码模板
封装格式:视频播放推荐选择 HLS 格式,MP4格式仅推荐用于视频下载场景。
预览原视频:如原视频可以正常播放,表明原视频路径合法。反之请检查视频路径是否正确。
预览转码视频:如预览转码视频可以正常播放,表明已经触发成功即时转码功能,如果是 MP4 文件,在控制台上会直接下载,不支持预览。




使用限制

原始视频限制

必须存储在腾讯云 VOD 的存储中,或者对象存储类源站中。
原始视频的视频时长不超过 10 小时,大小不超过 50GB,分辨率最大支持到 2K,视频码率不超 10Mbps,帧率不超过 60fps。
当使用 SystemPresetRemux 进行转封装时,输入视频的视频编码格式必须是 H.264,音频编码格式必须是 AAC。
原始视频支持下面的格式,但要求封装中包含视频和音频的索引。
视频:MOV、MPEG、MP4、AVI、TS、MKV、M3U8、M4V 等。
音频:MP3、M4A、WAV、AAC 等。

转码视频限制

对于 HLS 格式的输出,分片只支持 MPEG-TS。
对于 HLS 格式的输出,如果域名启用 Token 鉴权,仅支持在 TypeV 方式鉴权下的播放。
对于 MP4 格式的输出,文件内容为渐进式编码(部分播放器可能不支持此类型的 MP4 播放),且仅支持使用 SystemPresetRemux 模板。

请求速率限制

视频即时处理对每个域名的默认请求速率限制为每秒 20 个请求。对于访问已缓存的转码视频的请求,速率限制不适用。
若预计请求速率可能超过此限制,建议您提前联系我们,以便为您的业务做好资源准备,避免因请求限制而导致的问题。
对于超过请求速率限制的请求,系统将采取以下措施:
HLS 格式的输出:
请求 M3U8 索引文件时,将返回 302 状态码,并临时重定向至原始视频。
请求 MPEG-TS 视频分片时,将返回 429 状态码,表示请求过多。
MP4 格式的输出:返回 302 状态码,并临时重定向至原始视频。