v2_CN_DVR

DVR

SRS支持将RTMP流录制成flv文件。

Build

DVR的编译选项为--with-dvr，关闭DVR的选项为--without-dvr。

参考：Build

Config

DVR的难点在于写入flv和文件命名，SRS的做法是随机生成文件名，用户可以使用http-callback方式，使用外部程序记录这个文件名，或者改成自己要的文件命名方式。

当然也可以修改SRS代码，这种做法不推荐，c操作文件名比较麻烦。还是用外部辅助系统做会很方便。

DVR的配置文件说明：

    # dvr RTMP stream to file,
    # start to record to file when encoder publish,
    # reap flv according by specified dvr_plan.
    dvr {
        # whether enabled dvr features
        # default: off
        enabled         on;
        # the dvr output path.
        # the app dir is auto created under the dvr_path.
        # for example, for rtmp stream:
        #   rtmp://127.0.0.1/live/livestream
        #   http://127.0.0.1/live/livestream.m3u8
        # where dvr_path is /dvr, srs will create the following files:
        #   /dvr/live       the app dir for all streams.
        #   /dvr/live/livestream.{time}.flv   the dvr flv file.
        # @remark, the time use system timestamp in ms, user can use http callback to rename it.
        # in a word, the dvr_path is for vhost.
        # default: ./objs/nginx/html
        dvr_path        ./objs/nginx/html;
        # the dvr plan. canbe:
        #   session reap flv when session end(unpublish).
        #   segment reap flv when flv duration exceed the specified dvr_duration.
        # default: session
        dvr_plan        session;
        # the param for plan(segment), in seconds.
        # default: 30
        dvr_duration    30;
        # the param for plan(segment),
        # whether wait keyframe to reap segment,
        # if off, reap segment when duration exceed the dvr_duration,
        # if on, reap segment when duration exceed and got keyframe.
        # default: on
        dvr_wait_keyframe       on;
        # about the stream monotonically increasing:
        #   1. video timestamp is monotonically increasing, 
        #   2. audio timestamp is monotonically increasing,
        #   3. video and audio timestamp is interleaved monotonically increasing.
        # it's specified by RTMP specification, @see 3. Byte Order, Alignment, and Time Format
        # however, some encoder cannot provides this feature, please set this to off to ignore time jitter.
        # the time jitter algorithm:
        #   1. full, to ensure stream start at zero, and ensure stream monotonically increasing.
        #   2. zero, only ensure sttream start at zero, ignore timestamp jitter.
        #   3. off, disable the time jitter algorithm, like atc.
        # default: full
        time_jitter             full;
    }

DVR的计划即决定什么时候关闭flv文件，打开新的flv文件，主要的录制计划包括：

• session：按照session来关闭flv文件，即编码器停止推流时关闭flv，整个session录制为一个flv。
• segment：按照时间分段录制，flv文件时长配置为dvr_duration和dvr_wait_keyframe。注意：若不按关键帧切flv（即dvr_wait_keyframe配置为off），所以会导致后面的flv启动时会花屏。
• time_jitter: 时间戳抖动算法。full使用完全的时间戳矫正；zero只是保证从0开始；off不矫正时间戳。
• dvr_path: 录制的路径，规则参考下一章。

参考conf/dvr.segment.conf和conf/dvr.session.conf配置实例。

Custom Path

我们可以自定义DVR的路径和文件名，规则如下：

• 按年月日以及流信息生成子目录。便于做软链，或者避免一个目录的文件太多（貌似超过几万linux会支持不了）。
• 按日期和时间以及流信息生成文件名。便于搜索。
• 提供日期和时间，以及流信息的变量，以中括号代表变量。
• 保留目前的方式，按照时间戳生成文件名，保存在一个文件夹。若没有指定文件名（只指定了目录），则默认使用[stream].[timestamp].flv作为文件名，和目前保持一致。

关于日期和时间的变量，参考了GO的时间格式化字符串，譬如2006代表YYYY这种，比较方便：

2006-01-02 15:04:05.999

DVR支持的变量包括：

1. 年：[2006]，将这个字符串替换为年份。
2. 月：[01]，将这个字符串替换成月份。
3. 日：[02]，将这个字符串替换成日期。
4. 时：[15]，将这个字符串替换成小时。
5. 分：[04]，将这个字符串替换成分。
6. 秒：[05)，将这个字符串替换成秒。
7. 毫秒：[999]，将这个字符串替换成毫秒。
8. 时间戳：[timestamp]，将这个字符串替换成UNIX时间戳，单位是毫秒。
9. 流相关变量，参考转码：[vhost], [app], [stream]

下面的例子说明了替换方式, url是rtmp://ossrs.net/live/livestream，time是2015-01-03 10:57:30.776

1. 没有变量，SRS1.0方式（自动添加[stream].[timestamp].flv作为文件名）：

   • dvr_path ./objs/nginx/html;
   • =>
   • dvr_path ./objs/nginx/html/live/livestream.1420254068776.flv;

2. 按流和年月日分目录，时间作为文件名：

   • dvr_path /data/[vhost]/[app]/[stream]/[2006]/[01]/[02]/[15].[04].[05].[999].flv;
   • =>
   • dvr_path /data/ossrs.net/live/livestream/2015/01/03/10.57.30.776.flv;

3. 按流和年月分目录，日和时间作为文件名：

   • dvr_path /data/[vhost]/[app]/[stream]/[2006]/[01]/[02]-[15].[04].[05].[999].flv;
   • =>
   • dvr_path /data/ossrs.net/live/livestream/2015/01/03-10.57.30.776.flv;

4. 按vhost/app和年月分目录，流名称、日和时间作为文件名：

   • dvr_path /data/[vhost]/[app]/[2006]/[01]/[stream]-[02]-[15].[04].[05].[999].flv;
   • =>
   • dvr_path /data/ossrs.net/live/2015/01/livestream-03-10.57.30.776.flv;

5. 按app分目录，流和时间戳作为文件名（SRS1.0方式）：

   • dvr_path /data/[app]/[stream].[timestamp].flv;
   • =>
   • dvr_path /data/live/livestream.1420254068776.flv;

Bug

关于DVR的bug：

• 文件名规则：#179

Winlin 2015.1