简单 HLS 剪辑--视频点播-火山引擎

文档中心

导航

简单 HLS 剪辑

最近更新时间：2024.09.02 11:25:44首次发布时间：2024.09.02 11:25:44

您可调用 SubmitDirectEditTaskSync 接口实现简单 HLS 剪辑。本文为您介绍简单 HLS 剪辑功能的相关信息。

简单 HLS 剪辑参数

参数	类型	是否必选	示例值	说明
Source	String	是	`vid://v02b6d970000bvg5pi6******`	资源下载地址。支持以下类型：点播 Vid：如果您已将资源上传至视频点播服务并使用 Vid 模式，可通过 `vid://${vid}` 格式指定资源的 Vid。示例：`vid://v02b6d970000bvg5pi6******` 点播 DirectUrl：如果您已将资源上传至视频点播服务并使用 DirectUrl 模式，可通过 `directurl://{fileName}` 格式指定资源的 FileName。示例：`directurl://test.mp3` 点播挂载 TOS：如果您已在视频点播控制台完成挂载对象存储 TOS，可通过 `tos://{bucketName}/{fileName}` 格式指定资源地址。示例：`tos://example/test.mp3` 注意当前仅支持 HLS 格式资源。
CutList	List<CutSlice>	是	`-`	剪辑时间点列表。
WithPlayInfo	Bool	否	`true`	是否返回剪辑任务产物的播放地址： `false`：（默认）不返回播放地址 `true`：返回播放地址注意如需获取剪辑任务产物的播放地址，请在提交剪辑任务前，请完成以下操作：添加点播域名。空间内开启视频自动发布。
Upload	UploadInfo	是	`-`	剪辑任务产物上传配置。

剪辑时间点。

参数	类型	是否必选	示例值	说明
StartTime	Float	是	`10`	剪辑开始时间点，单位为秒。
EndTime	Float	是	`20`	剪辑结束时间点，单位为秒。
AbsoluteTime	Bool	否	`true`	剪辑开始和结束时间点是否为绝对时间戳： `true`：绝对时间戳 `false`：（默认）相对时间戳

参数

类型

是否必选

示例值

说明

StartTime

Float

是

10

剪辑开始时间点，单位为秒。

EndTime

Float

是

20

剪辑结束时间点，单位为秒。

AbsoluteTime

Bool

否

true

剪辑开始和结束时间点是否为绝对时间戳：

剪辑任务产物上传配置。

参数	类型	是否必选	示例值	说明
SpaceName	String	是	`edit_tob`	剪辑任务产物的上传空间。视频剪辑任务完成后输出的产物会被上传至此点播空间。
FileName	String	否	`example.m3u8`	剪辑任务产物的文件路径，即文件在点播存储中的存储位置，等同于传统对象存储的对象键（ObjectKey）概念。对于点播 Vid、点播 DirectUrl 和点播挂载 TOS 三种类型的资源，剪辑任务产物与片源只能位于同一目录下。不支持设置多级目录。假设 `Source` 设为 `tos://####/####/input.m3u8`，`UploadInfo.FileName` 设为 `output.m3u8`，则剪辑任务产物存储位置为 `tos://####/####/output.m3u8`。
VideoName	String	否	`example`	剪辑任务产物在视频点播控制台中的显示名称。需符合正则表达式：`^[\p{Han}.()（）\w\s:-]+$`。最大不超过 2048 字节。说明如果您没有设置 `VideoName`，视频点播控制台中的显示名称为空。
StorageBind	Bool	否	`false`	是否将剪辑生成的 M3U8 文件与其关联的 TS 分片绑定： `true`：绑定。删除了剪辑生成的 M3U8 文件后，其关联的 TS 分片也会被删除。 `false`：（默认）不绑定。删除了剪辑生成的 M3U8 文件后，其关联的 TS 分片不会被删除。

参数	类型	示例值	说明
Vid	String	`v0cd0**56oh0`	剪辑任务产物 Vid。
Uri	String	`tos*7/9ecd6b933/mai*c88c.m3u8`	剪辑任务产物 Uri。
Codec	String	`h264`	剪辑任务产物的编码格式。
Width	Int32	`1440`	剪辑任务产物的宽度，单位为 pixel。
Height	Int32	`810`	剪辑任务产物的高度，单位为 pixel。
Resolution	String	`1080P`	剪辑任务产物的分辨率。
Duration	Float	`299.91`	剪辑任务产物的时长，单位为秒。
Bitrate	Int	`10294956`	剪辑任务产物的码率，单位为 bps。
Md5	String	`8c1a25f11f6***cbec198d8974`	剪辑任务产物的 MD5 值。
Size	Int	`6144`	剪辑任务产物的大小，单位为字节。
PlayUrl	PlayInfo	`-`	剪辑任务产物的播放地址，仅当 `WithPlayInfo` 为 `true` 时返回。

剪辑任务产物的播放地址信息。

参数	类型	示例值	描述
MainPlayUrl	String	`http://video.*.com/oIpB7fCZQ2ttbMe4Iklnvx******`	剪辑任务产物的主播放地址。
BackupPlayUrl	String	`http://video.*.com/oIpB7fCZQ2ttbMe4Iklnvx******`	剪辑任务产物的备播放地址。