2018-02-10 23:37:42 +00:00
2020-01-22 00:59:16 +00:00
<!DOCTYPE html>
2017-09-20 02:35:05 +00:00
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
2020-01-22 00:59:16 +00:00
< meta charset = "utf-8" / >
2017-09-20 02:35:05 +00:00
< title > Stream descriptors — Shaka Packager documentation< / title >
< link rel = "stylesheet" href = "../_static/sphinxdoc_new.css" type = "text/css" / >
< link rel = "stylesheet" href = "../_static/pygments.css" type = "text/css" / >
2020-01-22 00:59:16 +00:00
< link rel = "stylesheet" type = "text/css" href = "../_static/graphviz.css" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/table_styling.css" / >
< script type = "text/javascript" id = "documentation_options" data-url_root = "../" src = "../_static/documentation_options.js" > < / script >
2017-09-20 02:35:05 +00:00
< script type = "text/javascript" src = "../_static/jquery.js" > < / script >
< script type = "text/javascript" src = "../_static/underscore.js" > < / script >
< script type = "text/javascript" src = "../_static/doctools.js" > < / script >
2020-01-22 00:59:16 +00:00
< script type = "text/javascript" src = "../_static/language_data.js" > < / script >
2017-09-20 02:35:05 +00:00
< link rel = "index" title = "Index" href = "../genindex.html" / >
< link rel = "search" title = "Search" href = "../search.html" / >
2020-01-22 00:59:16 +00:00
< / head > < body >
2017-09-20 02:35:05 +00:00
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "nav-item nav-item-0" > < a href = "../index.html" > Shaka Packager documentation< / a > » < / li >
< / ul >
< / div >
< div class = "sphinxsidebar" role = "navigation" aria-label = "main navigation" >
< div class = "sphinxsidebarwrapper" >
2020-01-22 00:59:16 +00:00
< h3 > < a href = "../index.html" > Table of Contents< / a > < / h3 >
2017-09-20 02:35:05 +00:00
< ul >
< li > < a class = "reference internal" href = "#" > Stream descriptors< / a > < / li >
2017-10-24 22:51:02 +00:00
< li > < a class = "reference internal" href = "#drm-related-stream-descriptor-fields" > DRM related Stream descriptor fields< / a > < / li >
2018-12-20 22:38:40 +00:00
< li > < a class = "reference internal" href = "#dash-specific-stream-descriptor-fields" > DASH specific stream descriptor fields< / a > < / li >
2017-09-20 02:35:05 +00:00
< li > < a class = "reference internal" href = "#hls-specific-stream-descriptor-fields" > HLS specific stream descriptor fields< / a > < / li >
< / ul >
< div role = "note" aria-label = "source link" >
< h3 > This Page< / h3 >
< ul class = "this-page-menu" >
< li > < a href = "../_sources/options/stream_descriptors.rst.txt"
rel="nofollow">Show Source< / a > < / li >
< / ul >
< / div >
< div id = "searchbox" style = "display: none" role = "search" >
2020-01-22 00:59:16 +00:00
< h3 id = "searchlabel" > Quick search< / h3 >
< div class = "searchformwrapper" >
2017-09-20 02:35:05 +00:00
< form class = "search" action = "../search.html" method = "get" >
2020-01-22 00:59:16 +00:00
< input type = "text" name = "q" aria-labelledby = "searchlabel" / >
< input type = "submit" value = "Go" / >
2017-09-20 02:35:05 +00:00
< / form >
2020-01-22 00:59:16 +00:00
< / div >
2017-09-20 02:35:05 +00:00
< / div >
< script type = "text/javascript" > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
< / div >
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" role = "main" >
< div class = "section" id = "stream-descriptors" >
< h1 > Stream descriptors< a class = "headerlink" href = "#stream-descriptors" title = "Permalink to this headline" > ¶< / a > < / h1 >
2018-02-10 23:37:42 +00:00
< p > There can be multiple < em > stream_descriptor< / em > with input from the same “file” or
multiple different “files”.< / p >
2017-10-24 22:51:02 +00:00
< p > Stream descriptor is of the form:< / p >
2020-01-22 00:59:16 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "o" > < < / span > < span class = "n" > field< / span > < span class = "o" > > =< < / span > < span class = "n" > value< / span > < span class = "o" > > < / span > < span class = "p" > [,< / span > < span class = "o" > < < / span > < span class = "n" > field< / span > < span class = "o" > > =< < / span > < span class = "n" > value< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > < span class = "o" > ...< / span >
2017-09-20 02:35:05 +00:00
< / pre > < / div >
< / div >
< p > These are the available fields:< / p >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > input (in)< / dt >
< dd class = "field-odd" > < p > input/source media “file” path, which can be regular files, pipes, udp
2017-09-20 02:35:05 +00:00
streams. See < a class = "reference internal" href = "udp_file_options.html" > < span class = "doc" > UDP file options< / span > < / a > on additional options for UDP
2020-01-22 00:59:16 +00:00
files.< / p >
< / dd >
< dt class = "field-even" > stream_selector (stream)< / dt >
< dd class = "field-even" > < p > Required field with value ‘ ’ ‘ ’ ‘ ’
based).< / p >
< / dd >
< dt class = "field-odd" > output (out)< / dt >
< dd class = "field-odd" > < p > Required output file path (single file).< / p >
< / dd >
< dt class = "field-even" > init_segment< / dt >
< dd class = "field-even" > < p > initialization segment path (multiple file).< / p >
< / dd >
< dt class = "field-odd" > segment_template (segment)< / dt >
< dd class = "field-odd" > < p > Optional value which specifies the naming pattern for the segment files,
2017-09-20 02:35:05 +00:00
and that the stream should be split into multiple files. Its presence should
be consistent across streams. See
2020-01-22 00:59:16 +00:00
< a class = "reference internal" href = "segment_template_formatting.html" > < span class = "doc" > Segment template formatting< / span > < / a > .< / p >
< / dd >
< dt class = "field-even" > bandwidth (bw)< / dt >
< dd class = "field-even" > < p > Optional value which contains a user-specified maximum bit rate for the
2017-09-20 02:35:05 +00:00
stream, in bits/sec. If specified, this value is propagated to (HLS)
EXT-X-STREAM-INF:BANDWIDTH or (DASH) Representation@ bandwidth and the
$Bandwidth$ template parameter for segment names. If not specified, the
bandwidth value is estimated from content bitrate. Note that it only affects
the generated manifests/playlists; it has no effect on the media content
2020-01-22 00:59:16 +00:00
itself.< / p >
< / dd >
< dt class = "field-odd" > language (lang)< / dt >
< dd class = "field-odd" > < p > Optional value which contains a user-specified language tag. If specified,
this value overrides any language metadata in the input stream.< / p >
< / dd >
< dt class = "field-even" > output_format (format)< / dt >
< dd class = "field-even" > < p > Optional value which specifies the format of the output files (MP4 or WebM).
2017-09-20 02:35:05 +00:00
If not specified, it will be derived from the file extension of the output
2020-01-22 00:59:16 +00:00
file.< / p >
< / dd >
< dt class = "field-odd" > trick_play_factor (tpf)< / dt >
< dd class = "field-odd" > < p > Optional value which specifies the trick play, a.k.a. trick mode, stream
2017-10-24 22:51:02 +00:00
sampling rate among key frames. If specified, the output is a trick play
2020-01-22 00:59:16 +00:00
stream.< / p >
< / dd >
< / dl >
2017-10-24 22:51:02 +00:00
< / div >
< div class = "section" id = "drm-related-stream-descriptor-fields" >
< h1 > DRM related Stream descriptor fields< a class = "headerlink" href = "#drm-related-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h1 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > skip_encryption=0|1< / dt >
< dd class = "field-odd" > < p > Optional. Defaults to 0 if not specified. If it is set to 1, no encryption
of the stream will be made.< / p >
< / dd >
< dt class = "field-even" > drm_label< / dt >
< dd class = "field-even" > < p > Optional value for custom DRM label, which defines the encryption key
2017-10-24 22:51:02 +00:00
applied to the stream. Typically values include AUDIO, SD, HD, UHD1, UHD2.
2018-02-10 23:37:42 +00:00
For raw key, it should be a label defined in –
2017-10-24 22:51:02 +00:00
DRM label is derived from stream type (video, audio), resolutions, etc.
2020-01-22 00:59:16 +00:00
Note that it is case sensitive.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
2018-12-20 22:38:40 +00:00
< div class = "section" id = "dash-specific-stream-descriptor-fields" >
< h1 > DASH specific stream descriptor fields< a class = "headerlink" href = "#dash-specific-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h1 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > dash_accessibilities (accessibilities)< / dt >
< dd class = "field-odd" > < p > Optional semicolon separated list of values for DASH Accessibility element.
The value should be in the format: scheme_id_uri=value, which propagates
to the Accessibility element in the result DASH manifest. See DASH
(ISO/IEC 23009-1) specification for details.< / p >
< / dd >
< dt class = "field-even" > dash_roles (roles)< / dt >
< dd class = "field-even" > < p > Optional semicolon separated list of values for DASH Role element. The
value should be one of: < strong > caption< / strong > , < strong > subtitle< / strong > , < strong > main< / strong > , < strong > alternate< / strong > ,
< strong > supplementary< / strong > , < strong > commentary< / strong > and < strong > dub< / strong > . See DASH (ISO/IEC 23009-1)
specification for details.< / p >
< / dd >
< / dl >
2018-12-20 22:38:40 +00:00
< / div >
2017-09-20 02:35:05 +00:00
< div class = "section" id = "hls-specific-stream-descriptor-fields" >
< h1 > HLS specific stream descriptor fields< a class = "headerlink" href = "#hls-specific-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h1 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > hls_name< / dt >
< dd class = "field-odd" > < p > Used for HLS audio to set the NAME attribute for EXT-X-MEDIA.
Defaults to the base of the playlist name.< / p >
< / dd >
< dt class = "field-even" > hls_group_id< / dt >
< dd class = "field-even" > < p > Used for HLS audio to set the GROUP-ID attribute for EXT-X-MEDIA.
Defaults to ‘ ’ < / p >
< / dd >
< dt class = "field-odd" > playlist_name< / dt >
< dd class = "field-odd" > < p > The HLS playlist file to create. Usually ends with ‘ ’
2018-02-10 23:37:42 +00:00
relative to hls_master_playlist_output (see below). If unspecified,
defaults to something of the form ‘ ’ ‘ ’
2020-01-22 00:59:16 +00:00
‘ ’ < / p >
< / dd >
< dt class = "field-even" > iframe_playlist_name< / dt >
< dd class = "field-even" > < p > The optional HLS I-Frames only playlist file to create. Usually ends with
2018-02-10 23:37:42 +00:00
‘ ’
only be set for video streams. If unspecified, no I-Frames only playlist is
2020-01-22 00:59:16 +00:00
created.< / p >
< / dd >
< dt class = "field-odd" > hls_characteristics (charcs)< / dt >
< dd class = "field-odd" > < p > Optional colon or semi-colon separated list of values for the
2018-12-20 22:38:40 +00:00
CHARACTERISTICS attribute for EXT-X-MEDIA. See CHARACTERISTICS attribute in
2020-01-22 00:59:16 +00:00
< a class = "reference external" href = "http://bit.ly/2OOUkdB" > http://bit.ly/2OOUkdB< / a > for details.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< / div >
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "nav-item nav-item-0" > < a href = "../index.html" > Shaka Packager documentation< / a > » < / li >
< / ul >
< / div >
< div class = "footer" role = "contentinfo" >
© Copyright 2017, Google.
2020-01-22 00:59:16 +00:00
Created using < a href = "http://sphinx-doc.org/" > Sphinx< / a > 2.3.1.
2017-09-20 02:35:05 +00:00
< / div >
< / body >
< / html >
