summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorxengineering <me@xengineering.eu>2024-01-14 14:14:45 +0100
committerxengineering <me@xengineering.eu>2024-01-14 14:14:45 +0100
commita7dc6b07781cb7901e9bbcffbe0d5ffa1c690c73 (patch)
tree2a014f55924d93cd9988f99ce32c3a9288a3db5c
parentafe7b5fb9921dd990719e5823a7fd30553d3ed23 (diff)
downloadsoundbox-a7dc6b07781cb7901e9bbcffbe0d5ffa1c690c73.tar
soundbox-a7dc6b07781cb7901e9bbcffbe0d5ffa1c690c73.tar.zst
soundbox-a7dc6b07781cb7901e9bbcffbe0d5ffa1c690c73.zip
doc: Switch to multicast for streaming
This allows to stream to multiple devices at the same time. Nevertheless it still works for a point to point stream.
-rw-r--r--doc/documentation.tex12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/documentation.tex b/doc/documentation.tex
index b374794..1787f50 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -60,10 +60,12 @@ For a simple audio streaming test the following commands from the FFmpeg
streaming
guide\footnote{\href{https://trac.ffmpeg.org/wiki/StreamingGuide\#StreamingasimpleRTPaudiostreamfromFFmpeg}{https://trac.ffmpeg.org/wiki/StreamingGuide\#StreamingasimpleRTPaudiostreamfromFFmpeg}}
can be used. The following command has to be executed on the soundbox to start
-listening on port \texttt{5316} for incoming audio streams:
+listening on port \texttt{5316} of a local multicast IPv4 address for incoming
+audio streams. Since multicast is used, this can be executed on multiple
+soundbox devices to stream to all of them.
\begin{verbatim}
- ffplay rtp://127.0.0.1:5316
+ ffplay rtp://224.0.0.99:5316
\end{verbatim}
As soon as the soundbox is listening the stream can be send from another
@@ -71,15 +73,15 @@ computer in the same network with this command:
\begin{verbatim}
ffmpeg -re -f lavfi -i aevalsrc="sin(400*2*PI*t)" -ar 8000 -f mulaw \
- -f rtp rtp://<soundbox-ip>:5316
+ -f rtp rtp://224.0.0.99:5316
\end{verbatim}
It will send a simple sine wave with 400~Hz to the soundbox device.
-Alternatively a mp3 file can be sent like this:
+Alternatively a MP3 file can be sent like this:
\begin{verbatim}
ffmpeg -re -i <file-path> -acodec copy -ar 11025 \
- -f rtp rtp://<soundbox-ip>:5316
+ -f rtp rtp://224.0.0.99:5316
\end{verbatim}
These commands allow to test the \texttt{soundbox} device setup.