shaka-packager/docs/source/options
Daniel Cantarín 89376d3c4d
feat: Allow LIVE UDP WebVTT input (#1349)
An updated version of PR #1027

That previous PR was done using 2021 code, and there were many changes
in the codebase from there, so a rebase was needed and also some minor
tweak here and there. But it's the same code, just reimplemented on a
newer codebase.

If you want to take a look at this in action, after building shaka
packager with this PR's code included, try this commands in 3 different
simultaneous bash sessions:

1. Video UDP input: `ffmpeg -f lavfi -re -i
"testsrc=s=320x240:r=30,format=yuv420p" -c:v h264 -sc_threshold 0 -g 30
-keyint_min 30 -r 30 -a53cc 1 -b:v 150k -preset ultrafast -r 30 -f
mpegts "udp://127.0.0.1:10000?pkt_size=1316"`
2. WebVTT UDP input: `for sec in $(seq 0 9999) ; do printf
"%02d:%02d.000 --> %02d:%02d.000\ntest second ${sec}\n\n" "$(( ${sec} /
60 ))" "$(( ${sec} % 60 ))" "$(( (${sec} + 1) / 60 ))" "$(( (${sec} + 1)
% 60 ))" ; sleep 1 ; done > /dev/udp/127.0.0.1/12345`
3. shaka packager command line: `timeout 60
path/to/build/packager/packager
'in=udp://127.0.0.1:10000?timeout=8000000,stream_selector=0,init_segment=240_init.m4s,segment_template=240_$Number%09d$.m4s,bandwidth=150000'
'in=udp://127.0.0.1:12345?timeout=8000000,stream_selector=0,input_format=webvtt,format=webvtt+mp4,init_segment=text_init.m4s,segment_template=text_$Number%09d$.m4s,language=eng,dash_roles=subtitle'
--mpd_output ./manifest.mpd --segment_duration 3.2
--suggested_presentation_delay 3.2 --min_buffer_time 3.2
--minimum_update_period 3.2 --time_shift_buffer_depth 60
--preserved_segments_outside_live_window 1 --default_language=eng
--dump_stream_info 2>&1`

Note the added `input_format=webvtt` to the shaka packager command's
second selector. That's new from this PR. If you don't use that, shaka's
format autodetection will not detect the webvtt format from the input,
as explained in
https://github.com/shaka-project/shaka-packager/issues/685#issuecomment-1029407191.
Try the command without it if you want to.

Fixes #685
Fixes #1017

---------

Co-authored-by: Daniel Cantarín <canta@canta.com.ar>
2024-02-23 16:02:19 -08:00
..
ads_options.rst Add documentation for Ad Insertion 2018-08-16 00:14:07 +00:00
chunking_options.rst Move command line options to Sphinxdoc 2017-09-13 00:09:55 +00:00
dash_options.rst feat(DASH): Add Label element. (#1175) 2024-02-14 10:36:08 -08:00
dash_stream_descriptors.rst feat: HLS / DASH support forced subtitle (#1020) 2024-02-14 20:27:57 -08:00
drm_stream_descriptors.rst [doc] Update raw key tutorial 2017-10-24 21:51:39 +00:00
general_encryption_options.rst Add docs for --playready_extra_header_data. 2020-09-01 17:55:45 +00:00
hls_options.rst feat: Add support for the EXT-X-START tag (#973) 2024-02-15 12:06:06 -08:00
hls_stream_descriptors.rst Support HLS characteristics 2018-11-26 20:02:43 +00:00
mp4_output_options.rst [MP4] Allow not to generate 'sidx' box for single-segment too 2020-12-11 19:08:37 +00:00
playready_encryption_options.rst Update DRM documentations 2018-08-15 17:18:57 -07:00
raw_key_encryption_options.rst Support different IVs for each track (#793) 2020-06-25 20:37:50 -07:00
segment_template_formatting.rst chore: Update URLs after moving projects (#1042) 2022-03-07 11:56:34 -08:00
stream_descriptors.rst feat: Allow LIVE UDP WebVTT input (#1349) 2024-02-23 16:02:19 -08:00
transport_stream_output_options.rst Add offset to tranport streams (MPEG2-TS, HLS Packed Audio) 2018-07-26 23:20:21 +00:00
udp_file_options.rst Add buffer_size UDP file options 2018-06-29 00:19:30 +00:00
widevine_encryption_options.rst Change --additional_protection_systems to --protection_systems 2018-08-14 22:12:55 +00:00