直播录制

功能介绍

直播录制提供了录制直播内容、录制索引管理、录制文件管理、录制事件回调的功能。

• 录制直播内容

  • 使用场景

    视频直播是通过播放地址以实时流的形式播放推流端的数据，如果想要在直播结束后再次观看或修改直播内容，就必须要使用视频直播的录制功能。

  • 功能介绍

    视频直播录制功能，就是将直播中心接收到的推流数据进行录制，将录制后的数据以HLS协议的封装格式，保存至您指定的存储位置。支持M3U8（同时会有.ts分片文件）、MP4、FLV格式。

    直播录制支持将直播内容录制至VOD或OSS。录制到VOD可以联动使用VOD的云剪辑、媒资管理、播控管理等能力。

  • 使用方法

    请参见直播录制使用方法。

• 录制索引管理

  说明

  您只有将视频存储在OSS中才可使用录制索引功能。

  • 使用场景

    视频直播录制在直播过程中会生成TS文件，但是仅在推流结束180秒后才会生成m3u8索引文件，无法在直播过程中生成，并且该索引文件时间为推流开始到结束，用户无法根据业务需要自定义索引范围。因此，视频直播提供录制索引管理功能，供用户对录制索引m3u8文件进行管理。

  • 功能介绍

    在一次推流结束时，会自动生成本次推流的录制索引文件。同时支持按照指定的录制开始时间和录制结束时间生成自定义录制索引文件。录制索引功能包括查看录制索引和剪辑录制索引两项功能。

    • 查看录制索引：用户可以查看已有的录制索引文件，这里的索引文件包括系统在断流180秒后自动生成的索引文件，以及用户手动创建的索引文件。

    • 剪辑录制索引：用户可以根据现有的录制索引文件进行剪辑，产生新的索引文件，这里的索引文件可以是对之前已有的索引文件进行合并或者拆分。

  • 使用方法

    请参见录制索引管理方法。

• 录制文件管理

  • 功能介绍

    • 查看和管理录制文件

    • 过期删除录制文件

      设置过期时间，超过配置的过期时间后，录制文件即可自动删除。

      说明

      此功能默认不向用户开放，添加AliyunMTSVideoLifecycleRolePolicy授权后，再提交工单申请。关于如何提交工单，请参见联系我们。

  • 使用方法

    请参见录制文件管理方法。

• 录制事件回调

  • 功能介绍

    直播录制回调包括录制状态回调、文件生成回调。

    • 录制状态回调：在文件开始录制与结束录制时发出，主要表示文件已经开始和结束录制。

    • 文件生成回调：在文件生成时发出，主要包括文件名称，开始结束时间与时长信息。

  • 使用方法

    请参见直播录制回调。

直播录制规则

• 直播录制是针对推流的AppName为粒度设置的。您可以设置某个AppName下的所有StreamName的录制规则。并且AppName取值为星号（*）时 ，表示此录制规则适用于该直播域名下的所有推流。推流的AppName需要和配置的AppName相同。也可以针对单路流进行录制。

  说明

  同时配置了AppName级别的录制和单路流录制，单路流录制配置的优先级更高。

• 录制设置仅会对配置完成后的新发起的推流记录生效，当前的推流需中断180秒后重新推流方可生效。

• 录制至VOD时，生成的M3U8和TS文件都存放在视频点播的输入媒体Bucket中。更多详情。请参见添加媒体Bucket。

• 如果使用录制至OSS，您需要事先创建好OSS Bucket。OSS Bucket必须与域名的直播中心同地域，不支持跨地域录制。

• 相同的AppName和StreamName不能同时存储至VOD和OSS。

直播录制使用方法

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = new AddLiveAppRecordConfigRequest();
addLiveAppRecordConfigRequest.setDomainName("<DomainName>");
addLiveAppRecordConfigRequest.setAppName("<AppName>");
addLiveAppRecordConfigRequest.setOssEndpoint("<Endpoint>");
addLiveAppRecordConfigRequest.setOssBucket("<BucketName>");
addLiveAppRecordConfigRequest.setOssObjectPrefix("<ObjectPrefix>");
try {
    AddLiveAppRecordConfigResponse addLiveAppRecordConfigResponse = client.getAcsResponse(addLiveAppRecordConfigRequest);
    System.out.println(addLiveAppRecordConfigResponse.getRequestId());
    // todo something.
} catch (ServerException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
} catch (ClientException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}        

录制索引管理方法

录制文件管理方法

查看和管理录制文件：您可以在控制台进行查看和管理录制文件的操作。

• 录制至VOD

  • 在视频直播控制台查看和管理，请参见录制文件管理。

  • 在视频点播控制台查看和管理

    1. 登录视频点播控制台，在左侧导航栏选择媒资库 > 音/视频。

    2. 选择您存至VOD的录制视频，并单击右侧的管理。

    3. 在基础信息页签中，您可以查看或修改视频的标题、描述、分类、标签、封面等信息。信息编辑完成后，点击保存完成配置。

• 录制至OSS

  • 在视频直播控制台查看和管理，请参见录制文件管理。

  • 在OSS控制台查看和管理：录制文件按照规则存储在OSS中，您可在OSS控制台中找到存储视频文件夹，并获取视频的播放地址。

    1. 登录OSS控制台，在左侧Bucket列表中，选择您存储录制视频的Bucket。

    2. 单击文件管理，选择存储录制视频的文件夹名称。

       视频完整的文件存储在record/{AppName}/{StreamName}下，与TS切片文件存储在一个文件夹中。

    3. 选择您想要查看的录制视频，并单击右侧的详情即可获得录制视频的播放地址。

API和SDK提供DescribeLiveStreamRecordContent接口查询直播录制内容。

过期删除录制文件：由于媒体资源均存放在OSS的Bucket中，需要授权访问才能正常删除录制文件，您可以点击授权进行一键授权。授权后，再提交工单申请，我们会在后台为您配置您需要的过期时间。关于如何提交工单，请参见联系我们。配置过期时间后，录制文件过期删除功能授权操作即为完成。