实时音视频 SPARKRTC-合流录制:实现步骤
实现步骤
- 请参见OBS帮助中心创建桶。若已有OBS桶,请直接执行步骤2。
创建的OBS桶所在区域必须为华北-北京四。
- OBS桶授权。
- 登录 实时音视频 控制台。
- 在左侧导航树中选择“云资源授权”,进入桶授权页面。
- 在对应的OBS桶行单击“授权”,完成桶授权。
- 配置录制规则。
- 登录实时音视频控制台。
- 在左侧导航树中选择 ,进入应用管理页面。
- 在需要创建录制规则的应用行单击“录制配置”,进入录制配置页面。
- 在“录制规则”页签,单击“添加”,进入添加录制规则页面。
一个应用ID仅支持创建一个录制规则。
- 请您按照实际需求配置录制参数,参数说明如表1所示。
表1 录制参数说明 参数名
描述
存储-桶
存储录制文件的OBS桶。
目前录制文件仅支持存储到华北-北京四的OBS桶中。
区域
OBS桶所在的区域。
存储-路径
存储录制文件的OBS桶路径。
录制格式
录制文件的格式,支持HLS和MP4文件格式。
HLS规则
m3u8命名规则
录制m3u8文件的存储路径和文件的前缀。
默认命名格式:{app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time}
上述特殊变量的含义如下:
- app_id:应用ID。
- record_format:录制格式。
- stream:流名。
- file_start_time:文件生成时间。
录制周期
录制时长支持0-720分钟,最小录制周期为1分钟,最大录制周期为12小时,超过12小时,系统将按照命名规则生成新文件。如果录制周期为0,则整个流录制为一个文件。
最大断流合并时长
支持如下三种配置:
- 断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。
- 断流后不生成新文件:是指录制的直播流中断后,会和之前录制的文件合并为一个文件。最大断流合并时长为30天。
- 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。
MP4规则
mp4命名规则
录制mp4文件的存储路径和文件的前缀。
默认命名格式:{app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time}
上述特殊变量的含义如下:
- app_id:应用ID。
- record_format:录制格式。
- stream:流名。
- file_start_time:文件生成时间。
录制周期
录制时长支持1-180分钟,最小录制周期为1分钟,最大录制周期为3小时,超过3小时,系统将按照命名规则生成新文件。
最大断流合并时长
支持如下两种配置:
- 断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。
- 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。
- 单击“确定”,在录制规则列表中会增加一条新的录制规则。
图2 录制规则
- 您可以在录制规则列表中,根据实际需求选择是否开启自动录制功能。自动录制功能开启后,若该应用下有新创建的房间,则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。
自动录制功能开启后,仅对同一应用下新创建的房间生效,自动录制功能开启前已创建的房间不生效。
- 加入房间。
录制规则配置完成后,您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动,SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。
若配置录制规则时,未开启自动录制功能,则加入SparkRTC房间后,您需要调用实时音视频API开启云端录制任务,SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。
- 回放录制文件。
录制完成后,您可以在OBS控制台中或通过回调消息查看录制文件。