217 lines
10 KiB
HTML
217 lines
10 KiB
HTML
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>FFmpeg piping — 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" />
|
|
<link rel="stylesheet" href="../_static/table_styling.css" type="text/css" />
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '../',
|
|
VERSION: '',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true,
|
|
SOURCELINK_SUFFIX: '.txt'
|
|
};
|
|
</script>
|
|
<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>
|
|
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|
<link rel="search" title="Search" href="../search.html" />
|
|
<link rel="next" title="Design" href="../design.html" />
|
|
<link rel="prev" title="PlayReady" href="playready.html" />
|
|
</head>
|
|
<body>
|
|
<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="right" >
|
|
<a href="../design.html" title="Design"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="playready.html" title="PlayReady"
|
|
accesskey="P">previous</a> |</li>
|
|
<li class="nav-item nav-item-0"><a href="../index.html">Shaka Packager documentation</a> »</li>
|
|
<li class="nav-item nav-item-1"><a href="tutorials.html" accesskey="U">Tutorials</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="../index.html">Table Of Contents</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">FFmpeg piping</a><ul>
|
|
<li><a class="reference internal" href="#piping-data-to-packager">Piping data to packager</a></li>
|
|
<li><a class="reference internal" href="#encoding-capture-command">Encoding / capture command</a><ul>
|
|
<li><a class="reference internal" href="#camera-capture">Camera capture</a></li>
|
|
<li><a class="reference internal" href="#rtp-input">RTP input</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#example-packaging-command-in-dash">Example packaging command in DASH</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="playready.html"
|
|
title="previous chapter">PlayReady</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="../design.html"
|
|
title="next chapter">Design</a></p>
|
|
<div role="note" aria-label="source link">
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="../_sources/tutorials/ffmpeg_piping.rst.txt"
|
|
rel="nofollow">Show Source</a></li>
|
|
</ul>
|
|
</div>
|
|
<div id="searchbox" style="display: none" role="search">
|
|
<h3>Quick search</h3>
|
|
<form class="search" action="../search.html" method="get">
|
|
<div><input type="text" name="q" /></div>
|
|
<div><input type="submit" value="Go" /></div>
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</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="ffmpeg-piping">
|
|
<h1>FFmpeg piping<a class="headerlink" href="#ffmpeg-piping" title="Permalink to this headline">¶</a></h1>
|
|
<p>We can use <em>FFmpeg</em> to redirect / pipe input not supported by <em>packager</em>
|
|
to <em>packager</em>, for example, input from webcam devices, or rtp input. The concept
|
|
depicted here can be applied to other <em>FFmpeg</em> supported device or protocols.</p>
|
|
<div class="section" id="piping-data-to-packager">
|
|
<h2>Piping data to packager<a class="headerlink" href="#piping-data-to-packager" title="Permalink to this headline">¶</a></h2>
|
|
<p>There are two options to pipe data to packager.</p>
|
|
<ul>
|
|
<li><p class="first">UDP socket</p>
|
|
<blockquote>
|
|
<div><p><em>FFmpeg</em> supports writing to a UDP socket and <em>packager</em> supports reading
|
|
from UDP sockets (See <a class="reference internal" href="../options/udp_file_options.html"><span class="doc">UDP file options</span></a>):</p>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span>$ packager 'input=udp://127.0.0.1:40000,...' ...
|
|
$ ffmpeg ... -f mpegts udp://127.0.0.1:40000
|
|
</pre></div>
|
|
</div>
|
|
<p>VP9 cannot be carried in mpegts. Another container, e.g. webm needs to be
|
|
used when outputs VP9. In this case, transcoding has to be started after
|
|
starting packager as the initialization segment is only transmitted in the
|
|
beginning of WebM output.</p>
|
|
</div></blockquote>
|
|
</li>
|
|
<li><p class="first">pipe</p>
|
|
<blockquote>
|
|
<div><p>Similarily, pipe is also supported in both <em>FFmpeg</em> and <em>packager</em>:</p>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span>$ mkfifo pipe1
|
|
$ packager 'input=pipe1,...' ... --io_block_size 65536
|
|
$ ffmpeg ... -f mpegts pipe: > pipe1
|
|
</pre></div>
|
|
</div>
|
|
</div></blockquote>
|
|
</li>
|
|
</ul>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">Option -io_block_size 65536 tells packager to use an io_block_size of 65K
|
|
for threaded io file. This is necessary when using pipe as reading from pipe
|
|
blocks until the specified number of bytes, which is specified in
|
|
io_block_size for threaded io file, thus the value of io_block_size cannot
|
|
be too large.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="encoding-capture-command">
|
|
<h2>Encoding / capture command<a class="headerlink" href="#encoding-capture-command" title="Permalink to this headline">¶</a></h2>
|
|
<div class="section" id="camera-capture">
|
|
<h3>Camera capture<a class="headerlink" href="#camera-capture" title="Permalink to this headline">¶</a></h3>
|
|
<p>Refer to <a class="reference external" href="https://trac.ffmpeg.org/wiki/Capture/Webcam">FFmpeg Capture/Webcam</a>
|
|
on how to use <em>FFmpeg</em> to capture webmcam inputs.</p>
|
|
<p>The example assumes Mac OS X 10.7 (Lion) or later. It captures from the default
|
|
audio / video devices on the machine:</p>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span>$ ffmpeg -f avfoundation -i "default" -f mpegts udp://127.0.0.1:40000
|
|
</pre></div>
|
|
</div>
|
|
<p>The command starts only after packager starts.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">After encoding starts, monitor encoding speed carefully. It should always be
|
|
1x and above. If not, adjust the encoding parameters to recude it.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="rtp-input">
|
|
<h3>RTP input<a class="headerlink" href="#rtp-input" title="Permalink to this headline">¶</a></h3>
|
|
<p>Assume there is an RTP input described by <cite>saved_sdp_file</cite>:</p>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span>$ ffmpeg -protocol_whitelist "file,rtp,udp" -i saved_sdp_file -vcodec h264 \
|
|
-tune zerolatency -f mpegts udp://127.0.0.1:40000
|
|
</pre></div>
|
|
</div>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p>For testing, you can generate an RTP input from a static media file:</p>
|
|
<div class="last highlight-default"><div class="highlight"><pre><span></span>$ ffmpeg -re -stream_loop 100 -i <static.mp4> -vcodec copy -acodec \
|
|
copy -f rtp rtp://239.255.0.1:1234 -sdp_file saved_sdp_file
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<p>The command starts only after packager starts.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">After encoding starts, monitor encoding speed carefully. It should always be
|
|
1x or above. If not, adjust the encoding parameters to increase it.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="example-packaging-command-in-dash">
|
|
<h2>Example packaging command in DASH<a class="headerlink" href="#example-packaging-command-in-dash" title="Permalink to this headline">¶</a></h2>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span>$ packager \
|
|
'in=udp://127.0.0.1:40000,stream=audio,init_segment=live_cam_audio.mp4,segment_template=live_cam_audio_$Number$.m4s' \
|
|
'in=udp://127.0.0.1:40000,stream=video,init_segment=live_cam_video.mp4,segment_template=live_cam_video_$Number$.m4s' \
|
|
--mpd_output live_cam.mpd
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</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="right" >
|
|
<a href="../design.html" title="Design"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="playready.html" title="PlayReady"
|
|
>previous</a> |</li>
|
|
<li class="nav-item nav-item-0"><a href="../index.html">Shaka Packager documentation</a> »</li>
|
|
<li class="nav-item nav-item-1"><a href="tutorials.html" >Tutorials</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer" role="contentinfo">
|
|
© Copyright 2017, Google.
|
|
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.7.
|
|
</div>
|
|
</body>
|
|
</html> |