文档

录制

更新时间:

实时媒体处理录制服务支持将直播流录制到阿里云OSS或VOD,并自动注册到IMS媒资库中。方便用户根据实际需求处理录制内容。通过阅读本文,您可以了解录制功能的详情及使用方法。

录制功能说明

功能说明

实时录制可以实时的将原始直播流录制并封装成M3U8、FLV或MP4格式,支持存入到阿里云OSS或VOD,并自动注册到IMS媒资库中。实时媒体处理录制功能主要特性如下所示:

  • 直播流录制仅修改音视频的封装格式(RTMP转成TS、FLV、MP4),不会修改视频内容,即不会修改编码层内容

  • 录制文件自动注册到IMS媒资库,您也可以通过IMS媒资库检索或根据实际需求处理录制内容。

使用限制

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

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

  • 由于实时录制需要先将直播流切分成TS文件,因此输入直播流的编码格式必须满足TS封装格式要求,根据FLV和ISO/IEC 13818-1标准,实时录制目前仅支持以下编码格式:

    音/视频

    编码格式

    视频

    H.264、HEVC、MPEG-4

    音频

    AAC、MP3

注意事项

  • 建议在提交录制任务前推流,或推流前3分钟内发起录制任务。如果录制任务3分钟后仍无法拉到直播流,录制任务将自动停止,需要重新发起录制任务。

  • 如果直播流正常且录制时间到达指定周期时,生成录制文件并注册到IMS媒资库中。

  • 如果直播流断开且不超过3分钟,录制将继续;如果断流超过3分钟,录制任务自动停止,生成录制文件并注册到IMS媒资库中。

创建录制模板

通过控制台创建

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

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

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

  4. 录制页签下创建录制模板。

    image

    参数

    描述

    模板名称

    输入录制模板名称。

    存储规则

    M3U8

    录制文件名

    输入录制的M3U8文件名称,命名规则为record/{JobId}/{EscapedStartTime}_{EscapedEndTime}

    切片TS名称

    输入切片名称,命名规则为record/{JobId}/{UnixTimeStamp}_{Sequence}

    单个TS时长

    输入单个切片的时长,取值范围:[5,30],单位:秒。

    录制周期

    输入录制周期,取值范围:[15,360],单位:分钟。

    直播时长超过设定的录制周期后,将生成新文件。

    FLV

    录制文件名

    输入录制的FLV文件名称,命名规则为record/{JobId}/{EscapedStartTime}_{EscapedEndTime}

    录制周期

    输入录制周期,取值范围:[15,360],单位:分钟。

    直播时长超过设定的录制周期后,将生成新文件。

    MP4

    录制文件名

    输入录制的MP4文件名称,命名规则为record/{JobId}/{EscapedStartTime}_{EscapedEndTime}

    录制周期

    输入录制周期,取值范围:[15,360],单位:分钟。

    直播时长超过设定的录制周期后,将生成新文件。

通过OpenAPI创建

调用接口CreateLiveRecordTemplate,根据实际需求设置参数Format的值,创建用户自定义模板。

创建录制任务

通过控制台创建

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

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

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

  4. 录制页签下创建实时媒体录制任务。

    image

    参数

    描述

    任务名称

    输入录制任务名称。

    存储地址

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

    选择模板

    选择录制模板。

    直播流

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

    回调地址

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

通过OpenAPI创建

调用接口SubmitLiveRecordJob提交实时媒体录制任务

查询录制任务详情

通过回调信息查询

通过接收直播文件生成直播录制状态的回调,查询实时媒体录制任务详情。更多信息,请参见回调事件概述

通过OpenAPI查询

调用GetLiveRecordJob查询实时媒体录制任务详情。

查看录制文件

当录制任务执行完成后,您可以查看录制文件

通过控制台查看

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

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

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

  4. 录制页签下单击录制任务列表操作列的查看录制文件,查询直播的录制文件。

通过OpenAPI查看

调用ListLiveRecordFiles查看直播的录制文件。DeleteLiveRecordFiles

删除录制文件说明(OSS授权管理

如果您需要同步删除存储在OSS上的录制文件,需要先进行OSS授权。

  1. 登录RAM 访问控制

  2. 创建自定义权限策略。

    1. 在左侧导航栏选择权限管理 > 权限策略

    2. 单击创建权限策略

    3. 脚本编辑页签下创建以下策略,然后单击继续编辑基本信息

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": "oss:DeleteObject",
                  "Resource": "*",
                  "Effect": "Allow"
              }
          ]
      }
      说明

      Resource为实时录制文件在OSS中的储存路径,*表示全部文件。

    4. 输入策略名称,建议命名为AliyunICEMediaRecourcesAccessRole,单击确定

  3. 查找AliyunICEDefaultRole角色并精确授权。

    1. 在左侧导航栏选择身份管理 > 角色

    2. 在搜索框中输入AliyunICEDefaultRole,查找该角色。如果无法找到,则表示您还未开通智能媒体服务,需要先开通此服务。具体操作,请参见开通服务

    3. 单击AliyunICEDefaultRole操作列的精确授权,权限类型选择自定义策略,策略名称填写步骤 2中创建的自定义权限策略名称。

  4. 单击确定,完成配置。

查询录制任务用量

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

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

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

    说明

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

API参考

实时媒体录制相关接口

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