X-Git-Url: https://git.sesse.net/?p=cubemap;a=blobdiff_plain;f=cubemap.config.sample;h=e7119ffb62cf529a07024eead7b0ae78c449f8f9;hp=3e836739a6a2525805e4586836a7f3ac6ec28aa8;hb=20e85bd6901355cc40a6cfb4c0deb7232d9aa63f;hpb=061988af511f42da3cd584b4d983177504ddc177 diff --git a/cubemap.config.sample b/cubemap.config.sample index 3e83673..e7119ff 100644 --- a/cubemap.config.sample +++ b/cubemap.config.sample @@ -60,6 +60,27 @@ stream /test.flv.metacube src=http://gruessi.zrh.sesse.net:4013/test.flv encodin # are not like this. A typical example, however, is MPEG-TS. stream /test.ts src=http://gruessi.zrh.sesse.net:4013/test.ts src_encoding=raw +# If your input has PTS Metacube2 blocks (currently only generated by +# Nageru >= 1.7.2 with MP4 output) and is segmentable (in practice MP4 with the +# right tags, again typically generated by Nageru), you can serve HLS fragments +# out of Cubemap's regular backlog, with the playlist served at the given URL +# (in this case, /stream.m3u8). This allows you to serve video directly to +# Mobile Safari (you'll need iOS >= 10 for fMP4 support; older iOS only +# supports TS), and also allow rewinding in the stream if your backlog is large +# enough. As of April 2018, iOS and hls.js seem to work well, while at least +# VLC and mpv appear to be buggy. +# +# hls_frag_duration= sets the maximum fragment size in seconds; the default, 6, +# is Apple's default recommendation. Larger fragments will cause more latency but +# fewer HTTP requests (less chance of performance problems). (Typically, you'll want +# a bit longer backlog than the default of 10 MB, as you won't fit many six-second +# fragments into that.) Setting hls_backlog_margin= makes Cubemap not expose any +# new fragments that are too far, measured in bytes, from the beginning of the +# backlog, in order to reduce the risk of not managing to deliver them before +# they rotate out. The default is zero, but you almost certainly want to change that +# to be some reasonable fraction of your fragment length. +stream /stream.mp4 src=http://gruessi.zrh.sesse.net:9095/test.mp4.metacube hls_playlist=/stream.m3u8 hls_frag_duration=6 backlog_size=20971520 hls_backlog_margin=1048576 allow_origin=* + # UDP input. TS is the most common container to use over UDP (you cannot # take any arbitrary container and expect it to work). # backlog_size= overrides the backlog, which is normally 10 MB.