GenerateVideoPlaylist_智能媒体管理_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格
  • 调用该接口前,请确保当前 Region 已经存在可用的项目(Project),详见项目管理
  • 使用该接口时,默认只处理一路视频/音频/字幕流,同时支持配置处理的视频/音频/字幕流数量。
  • 该接口同时能支持生成 Media playlist 和 Master playlist,请注意文档参数说明。
  • 该接口为同步接口。播放或预转时才会触发同步或异步转码。可以通过设置 Notification 消息通知参数,通过消息通知获取转码任务结果。
  • 该接口的功能说明参见边转边播
  • OSS 的数据处理能力也提供了生成播放列表功能,但只提供生成 Media Playlist 且参数进行了简化。详情参见 OSS 数据处理能力生成播放列表

流控信息

当前云产品API请求速率暂未透出。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
ProjectNamestring

项目名称,获取方式请参见创建项目

示例值:immtest参考取值来源:
    UpdateProject
    CreateProject
    ListProjects
UserDatastring

用户自定义信息,在异步消息通知中会返回,方便您在系统内对消息通知进行关联处理。最大长度为 2048 字节。

示例值:{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
SourceURIstring

视频的 OSS 地址。展开详情

示例值:oss://test-bucket/test-source-object/video.mp4
SourceStartTimenumber<float>

生成播放列表的起始时间点,单位为秒(s)。取值范围如下:展开详情

示例值:0
SourceDurationnumber<float>

生成播放列表的持续时间。单位为秒(s),取值范围如下:展开详情

示例值:0
SourceSubtitlesarray<object>

添加字幕列表,默认为空。最大支持 2 个。

MasterURIstring

Master Playlist 的 OSS 地址。展开详情

示例值:oss://test-bucket/test-object/master.m3u8
Targetsarray<object>

边转边播播放列表数组,数组长度最大为 6。每个 Target 对应至多一个视频 Media Playlist 和一个或多个字幕 Media Playlist展开详情

Tagsmap<string>

为生成的 ts 文件添加 OSS 对象标签。可以使用标签来控制 OSS 文件的生命周期。

示例值:{"key1": "value1", "key2": "value2"}
CredentialConfigCredentialConfig

链式授权配置对象,一般留空即可。展开详情

NotificationNotification

消息通知对象,支持多种消息中间件,消息格式详情请见异步通知消息格式,请选择其中一种方式接收消息,使用方式如下所示:展开详情

OverwritePolicystring

当 Media Playlist 存在时的覆盖策略,取值范围:展开详情

示例值:overwrite

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:CA995EFD-083D-4F40-BE8A-BDF75FFF*****
Durationnumber<float>

输出视频总时长。

示例值:1082
Tokenstring

Master Playlist 的 Token。

示例值:92376fbb-171f-4259-913f-705f7ee0****
MasterURIstring

Master Playlist 的 OSS 地址。

示例值:oss://test-bucket/test-object/master.m3u8
VideoPlaylistarray<object>

视频 Media Playlist 文件列表。

AudioPlaylistarray<object>

音频 Media Playlist 文件列表。

SubtitlePlaylistarray<object>

字幕 Media Playlist 文件列表。

返回示例

变更历史

变更时间变更内容概要操作
2024-03-26
变更返回参数
2023-04-04
变更请求参数Targets

相关示例