文档

截图

更新时间:

实时媒体处理截图服务支持对直播流进行截图并保存到阿里云OSS中。通过阅读本文,您可以了解截图功能的详情及使用方法。

截图功能说明

功能说明

实时截图可以实时的对原始直播流按照指定频率进行截图,支持存入到阿里云OSS中。实时媒体处理截图功能根据存储规则不同支持以下两种方式:

截图方式

描述

覆盖截图

每次新生成的截图覆盖之前生成的截图文件。

实时截图

每次新生成的截图不覆盖之前生成的截图文件,以UNIX时间戳命名。

使用限制

  • 单账号并发截图任务最多支持100路,如果您有其他需求,请联系您的阿里云客户经理

  • 截图任务输入的直播流当前只支持RTMP协议。

  • 截图仅支持保存至阿里云OSS中,输出格式仅支持JPG。

创建截图模板

通过控制台创建

  1. 登录智能媒体服务控制台

  2. 在顶部左上角根据实际情况选择地域。

  3. 在左侧导航栏选择实时媒体处理 > 模板管理

  4. 截图页签下创建截图模板。

    image

    参数

    描述

    模板名称

    输入截图模板名称。

    截图频率

    输入截图频率,取值范围:[5,3600],单位:秒。

    图片按关键帧获取。

    存储规则

    • 覆盖截图:每次新生成的截图覆盖之前生成的截图文件,命名规则为snapshot/{JobId}.jpg

    • 实时截图:每次新生成的截图不覆盖之前生成的截图文件,命名规则为snapshot/{JobId}/{Sequence}/{UnixTimestamp}.jpg

    说明

    当前仅支持生成JPG格式的截图。

通过OpenAPI创建

调用接口CreateLiveSnapshotTemplate,创建用户自定义模板。

创建截图任务

通过控制台创建

  1. 登录智能媒体服务控制台

  2. 在顶部左上角根据实际情况选择地域。

  3. 在左侧导航栏选择实时媒体处理 > 任务管理

  4. 截图页签下创建实时媒体截图任务。

    image

    参数

    描述

    任务名称

    输入截图任务名称。

    存储地址

    选择截图文件的存储地址,支持存入到阿里云OSS。如果没有可用的存储地址,您可以自行配置,详情请参见配置存储地址

    选择模板

    选择截图模板。

    直播流

    输入正确有效的直播流URL。当前只支持RTMP协议。

    回调地址

    输入回调URL,仅对本次任务有效。如果为空,将使用回调设置中回调URL。

通过OpenAPI创建

调用接口SubmitLiveSnapshotJob提交实时媒体截图任务

查询截图任务详情

通过回调信息查询

通过接收直播截图回调,查询实时媒体截图任务详情。更多信息,请参见回调事件概述

通过OpenAPI查询

调用GetLiveSnapshotJob查询实时媒体截图任务详情。

获取截图文件

当截图任务开始后,可以通过查询截图任务获取截图文件,您可以根据实际需求处理此截图文件。

通过控制台获取

  1. 登录智能媒体服务控制台

  2. 在顶部左上角根据实际情况选择地域。

  3. 在左侧导航栏选择实时媒体处理 > 文件管理

  4. 截图页签下获取直播的截图文件。

通过OpenAPI获取

调用ListLiveSnapshotFiles获取直播的截图文件。

查询截图任务用量

  1. 登录智能媒体服务控制台

  2. 在左侧导航栏选择数据中心 > 用量查询

  3. 实时任务用量页签下直播截图区域查询或明细导出任务的时长用量。

    说明

    为了保证数据安全,导出的下载链接有效期为30分钟。如果超时,请重新刷新页面。

API参考

实时媒体截图相关接口

  • 本页导读 (1)
文档反馈