## Introduce This PR adds support for viewing streams via the RTSP protocol. Note that it only supports viewing streams, not publishing streams via RTSP. Currently, only publishing via RTMP is supported, which is then converted to RTSP. Further work is needed to support publishing RTC/SRT streams and converting them to RTSP. ## Usage Build and run SRS with RTSP support: ``` cd srs/trunk && ./configure --rtsp=on && make -j16 ./objs/srs -c conf/rtsp.conf ``` Push stream via RTMP by FFmpeg: ``` ffmpeg -re -i doc/source.flv -c copy -f flv rtmp://localhost/live/livestream ``` View the stream via RTSP protocol, try UDP first, then use TCP: ``` ffplay -i rtsp://localhost:8554/live/livestream ``` Or specify the transport protocol with TCP: ``` ffplay -rtsp_transport tcp -i rtsp://localhost:8554/live/livestream ``` ## Unit Test Run utest for RTSP: ``` ./configure --utest=on & make utest -j16 ./objs/srs_utest ``` ## Regression Test You need to start SRS for regression testing. ``` ./objs/srs -c conf/regression-test-for-clion.conf ``` Then run regression tests for RTSP. ``` cd srs/trunk/3rdparty/srs-bench go test ./srs -mod=vendor -v -count=1 -run=TestRtmpPublish_RtspPlay ``` ## Blackbox Test For blackbox testing, SRS will be started by utest, so there is no need to start SRS manually. ``` cd srs/trunk/3rdparty/srs-bench go test ./blackbox -mod=vendor -v -count=1 -run=TestFast_RtmpPublish_RtspPlay_Basic ``` ## UDP Transport As UDP requires port allocation, this PR doesn't support delivering media stream via UDP transport, so it will fail if you try to use UDP as transport: ``` ffplay -rtsp_transport udp -i rtsp://localhost:8554/live/livestream [rtsp @ 0x7fbc99a14880] method SETUP failed: 461 Unsupported Transport rtsp://localhost:8554/live/livestream: Protocol not supported [2025-07-05 21:30:52.738][WARN][14916][7d7gf623][35] RTSP: setup failed: code=2057 (RtspTransportNotSupported) : UDP transport not supported, only TCP/interleaved mode is supported ``` There are no plans to support UDP transport for RTSP. In the real world, UDP is rarely used; the vast majority of RTSP traffic uses TCP. ## Play Before Publish RTSP supports audio with AAC and OPUS codecs, which is significantly different from RTMP or WebRTC. RTSP uses commands to exchange SDP and specify the audio track to play, unlike WHEP or HTTP-FLV, which use the query string of the URL. RTSP depends on the player’s behavior, making it very difficult to use and describe. Considering the feature that allows playing the stream before publishing it, it requires generating some default parameters in the SDP. For OPUS, the sample rate is 48 kHz with 2 channels, while AAC is more complex, especially regarding the sample rate, which may be 44.1 kHz, 32 kHz, or 48 kHz. Therefore, for RTSP, we cannot support play-then-publish. Instead, there must already be a stream when playing it, so that the audio codec is determined. ## Opus Codec No Opus codec support for RTSP, because for RTC2RTSP, it always converts RTC to RTMP frames, then converts them to RTSP packets. Therefore, the audio codec is always AAC after converting RTC to RTMP. This means the bridge architecture needs some changes. We need a new bridge that binds to the target protocol. For example, RTC2RTMP converts the audio codec, but RTC2RTSP keeps the original audio codec. Furthermore, the RTC2RTMP bridge should also support bypassing the Opus codec if we use enhanced-RTMP, which supports the Opus audio codec. I think it should be configurable to either transcode or bypass the audio codec. However, this is not relevant to RTSP. ## AI Contributor Below commits are contributed by AI: * [AI: Remove support for media transport via UDP.](755686229f) * [AI: Add crutial logs for each RTSP stage.](9c8cbe7bde) * [AI: Support AAC doec for RTSP.](7d7cc12bae) * [AI: Add option --rtsp for RTSP.](f67414d9ee) * [AI: Extract SrsRtpVideoBuilder for RTC and RTSP.](562e76b904) --------- Co-authored-by: Jacob Su <suzp1984@gmail.com> Co-authored-by: winlin <winlinvip@gmail.com>
281 lines
8.5 KiB
Bash
Executable File
281 lines
8.5 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
# output variables:
|
|
# SRS_AUTO_HEADERS_H: the auto generated header file.
|
|
|
|
SRS_AUTO_HEADERS_H="${SRS_OBJS}/srs_auto_headers.hpp"
|
|
|
|
# write user options to headers
|
|
echo "// auto generated by configure" > $SRS_AUTO_HEADERS_H
|
|
echo "#ifndef SRS_AUTO_HEADER_HPP" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_AUTO_HEADER_HPP" >> $SRS_AUTO_HEADERS_H
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
|
|
echo "#define SRS_PACKAGER \"${SRS_AUTO_PACKAGER}\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_BUILD_TS \"`date +%s`\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_BUILD_DATE \"`date \"+%Y-%m-%d %H:%M:%S\"`\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_UNAME \"`uname -a`\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_USER_CONFIGURE \"${SRS_AUTO_USER_CONFIGURE}\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_CONFIGURE \"${SRS_AUTO_CONFIGURE}\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
|
|
function srs_define_macro()
|
|
{
|
|
macro=$1 && file=$2
|
|
echo "#define $macro" >> $file
|
|
echo "#define ${macro}_BOOL true" >> $file
|
|
}
|
|
|
|
function srs_define_macro_value()
|
|
{
|
|
macro=$1 && value=$2 && file=$3
|
|
echo "#define $macro $value" >> $file
|
|
echo "#define ${macro}_BOOL true" >> $file
|
|
}
|
|
|
|
function srs_undefine_macro()
|
|
{
|
|
macro=$1 && file=$2
|
|
echo "#undef $macro" >> $file
|
|
echo "#define ${macro}_BOOL false" >> $file
|
|
}
|
|
|
|
#####################################################################################
|
|
# generate auto headers file, depends on the finished of options.sh
|
|
#####################################################################################
|
|
# auto headers in depends.
|
|
if [[ $SRS_HDS == YES ]]; then
|
|
srs_define_macro "SRS_HDS" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_HDS" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_SRT == YES ]]; then
|
|
srs_define_macro "SRS_SRT" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SRT" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_CXX11 == YES ]]; then
|
|
srs_define_macro "SRS_CXX11" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_CXX11" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_CXX14 == YES ]]; then
|
|
srs_define_macro "SRS_CXX14" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_CXX14" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_BACKTRACE == YES ]]; then
|
|
srs_define_macro "SRS_BACKTRACE" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_BACKTRACE" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_RTC == YES ]]; then
|
|
srs_define_macro "SRS_RTC" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_RTC" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_RTSP == YES ]]; then
|
|
srs_define_macro "SRS_RTSP" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_RTSP" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_FFMPEG_FIT == YES ]]; then
|
|
srs_define_macro "SRS_FFMPEG_FIT" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_FFMPEG_FIT" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_FFMPEG_OPUS == YES ]]; then
|
|
srs_define_macro "SRS_FFMPEG_OPUS" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_FFMPEG_OPUS" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
# H.265/HEVC support is always enabled
|
|
srs_define_macro "SRS_H265" $SRS_AUTO_HEADERS_H
|
|
|
|
if [[ $SRS_SIMULATOR == YES ]]; then
|
|
srs_define_macro "SRS_SIMULATOR" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SIMULATOR" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_HTTPS == YES ]]; then
|
|
srs_define_macro "SRS_HTTPS" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_HTTPS" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_GB28181 == YES ]]; then
|
|
srs_define_macro "SRS_GB28181" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GB28181" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_APM == YES ]]; then
|
|
srs_define_macro "SRS_APM" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_APM" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_UTEST == YES ]]; then
|
|
srs_define_macro "SRS_UTEST" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_UTEST" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
# whatever the FFMPEG tools, if transcode and ingest specified,
|
|
# srs always compile the FFMPEG tool stub which used to start the FFMPEG process.
|
|
if [[ $SRS_FFMPEG_STUB == YES ]]; then
|
|
srs_define_macro "SRS_FFMPEG_STUB" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_FFMPEG_STUB" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_GPERF == YES ]]; then
|
|
srs_define_macro "SRS_GPERF" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GPERF" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_GPERF_MC == YES ]]; then
|
|
srs_define_macro "SRS_GPERF_MC" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GPERF_MC" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_GPERF_MD == YES ]]; then
|
|
srs_define_macro "SRS_GPERF_MD" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GPERF_MD" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_GPERF_MP == YES ]]; then
|
|
srs_define_macro "SRS_GPERF_MP" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GPERF_MP" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_GPERF_CP == YES ]]; then
|
|
srs_define_macro "SRS_GPERF_CP" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_GPERF_CP" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [ $SRS_SANITIZER == YES ]; then
|
|
srs_define_macro "SRS_SANITIZER" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SANITIZER" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [ $SRS_SANITIZER_LOG == YES ]; then
|
|
srs_define_macro "SRS_SANITIZER_LOG" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SANITIZER_LOG" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [ $SRS_VALGRIND == YES ]; then
|
|
srs_define_macro "SRS_VALGRIND" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_VALGRIND" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
#####################################################################################
|
|
# for embeded.
|
|
#####################################################################################
|
|
# for log level compile settings
|
|
if [[ $SRS_LOG_VERBOSE == YES ]]; then
|
|
srs_define_macro "SRS_VERBOSE" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_VERBOSE" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_LOG_INFO == YES ]]; then
|
|
srs_define_macro "SRS_INFO" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_INFO" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_LOG_TRACE == YES ]]; then
|
|
srs_define_macro "SRS_TRACE" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_TRACE" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_SINGLE_THREAD == YES ]]; then
|
|
srs_define_macro "SRS_SINGLE_THREAD" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SINGLE_THREAD" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_SIGNAL_API == YES ]]; then
|
|
srs_define_macro "SRS_SIGNAL_API" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_SIGNAL_API" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_LOG_LEVEL_V2 == YES ]]; then
|
|
srs_define_macro "SRS_LOG_LEVEL_V2" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_LOG_LEVEL_V2" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_CROSS_BUILD == YES ]]; then
|
|
srs_define_macro "SRS_CROSSBUILD" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_CROSSBUILD" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_CYGWIN64 == YES ]]; then
|
|
srs_define_macro "SRS_CYGWIN64" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_CYGWIN64" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
if [[ $SRS_OSX == YES ]]; then
|
|
srs_define_macro "SRS_OSX" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_OSX" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_DEBUG == YES ]]; then
|
|
srs_define_macro "SRS_DEBUG" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_DEBUG" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_DEBUG_STATS == YES ]]; then
|
|
srs_define_macro "SRS_DEBUG_STATS" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_DEBUG_STATS" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
if [[ $SRS_DEBUG_NACK_DROP == YES ]]; then
|
|
srs_define_macro "SRS_DEBUG_NACK_DROP" $SRS_AUTO_HEADERS_H
|
|
else
|
|
srs_undefine_macro "SRS_DEBUG_NACK_DROP" $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
# prefix
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_PREFIX \"${SRS_PREFIX}\"" >> $SRS_AUTO_HEADERS_H
|
|
echo "#define SRS_DEFAULT_CONFIG \"${SRS_DEFAULT_CONFIG}\"" >> $SRS_AUTO_HEADERS_H
|
|
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
|
|
#####################################################################################
|
|
# generated the contributors from AUTHORS.txt
|
|
#####################################################################################
|
|
if [[ -f AUTHORS.md ]]; then
|
|
RTMP_SIG_SRS_AUTHORS=$(cat AUTHORS.md|grep "^-"|awk -F '`' '{print $2}')
|
|
echo "#define RTMP_SIG_SRS_AUTHORS \"\\" >> $SRS_AUTO_HEADERS_H
|
|
for CONTRIBUTOR in $RTMP_SIG_SRS_AUTHORS; do
|
|
echo "${CONTRIBUTOR} \\" >> $SRS_AUTO_HEADERS_H
|
|
done
|
|
echo "\"" >> $SRS_AUTO_HEADERS_H
|
|
else
|
|
echo "#define RTMP_SIG_SRS_AUTHORS \"ossrs\"" >> $SRS_AUTO_HEADERS_H
|
|
fi
|
|
|
|
# new empty line to auto headers file.
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
|
|
#####################################################################################
|
|
# auto header EOF.
|
|
#####################################################################################
|
|
echo "#endif" >> $SRS_AUTO_HEADERS_H
|
|
echo "" >> $SRS_AUTO_HEADERS_H
|
|
|