Skip to main content

Compiling and Using WebRTC

ZLMediaKitAbout 2 min


centos 7.6
gcc version 5.4.0 (GCC)
cmake version 3.20.5

Dependency Preparation

  • Install OpenSSL (version 1.1 or above)

    $ wget
    $ tar -xvzf openssl-1.1.1k.tar.gz
    $ yum install -y zlib zlib-devel perl-CPAN
    $ ./config shared --openssldir=/usr/local/openssl --prefix=/usr/local/openssl
    $ make && make install
    $ echo "/usr/local/lib64/" >> /etc/
    $ echo "/usr/local/openssl/lib" >> /etc/
    $ ldconfig
    $ ln -s /usr/local/openssl/bin/openssl  /usr/local/bin/openssl # 替换系统openssl,非必须
    $ openssl version -a
  • Install libsrtp

    Click hereopen in new window to download and install.

    $ tar -xvzf libsrtp-2.3.0.tar.gz
    $ cd libsrtp-2.3.0
    $ ./configure --enable-openssl --with-openssl-dir=/usr/local/openssl
    $ make -j8 && make install

    For some newer compilation environments (such as GCC 10+), there may be issues when compiling libsrtp-2.3.0. You can consider switching to version 2.5.0 as follows:

    $ wget
    $ tar -xvzf libsrtp-2.5.0.tar.gz
    $ cd libsrtp-2.5.0


  • Download ZLMediaKit source code

    # Chinese users are recommended to download from the mirror site gitee
    git clone --depth 1
    cd ZLMediaKit
    # Do not forget to execute this command
    git submodule update --init
  • Compilation

    $ mkdir build
    $ cd build
    $ cmake .. -DENABLE_WEBRTC=true  -DOPENSSL_ROOT_DIR=/usr/local/openssl  -DOPENSSL_LIBRARIES=/usr/local/openssl/lib
    $ cmake --build . --target MediaServer
    # final result
    [ 96%] Built target test_rtcp_fci
    [ 96%] Building CXX object tests/CMakeFiles/test_rtp.dir/test_rtp.cpp.o
    [ 97%] Linking CXX executable ../../release/linux/Debug/test_rtp
    [ 97%] Built target test_rtp
    [ 97%] Building CXX object tests/CMakeFiles/test_wsServer.dir/test_wsServer.cpp.o
    [ 97%] Linking CXX executable ../../release/linux/Debug/test_wsServer
    [ 97%] Built target test_wsServer
    [ 97%] Building CXX object tests/CMakeFiles/test_server.dir/test_server.cpp.o
    [ 97%] Linking CXX executable ../../release/linux/Debug/test_server
    [ 97%] Built target test_server
    [ 98%] Built target jsoncpp
    [ 98%] Linking CXX executable ../../release/linux/Debug/MediaServer
    [100%] Built target MediaServer

Modify Configuration File

Since WebRTC protocol requires informing the player of the server's IP address, if the IP address is not visible to the player, WebRTC communication will fail. Please modify the rtc.externIP configuration item in the configuration file to the visible IP address of the player. If this configuration item is not set, zlmediakit will retrieve the IP address of the network card (usually an internal IP address), which will prevent cross-domain NAT usage of WebRTC.

# Timeout for RTC streaming and playback
# IP address visible to RTC clients on this machine, generally a public IP address when acting as a server, leave it blank to automatically retrieve the IP address of the network card
# UDP server listening port for RTC, all RTC clients will transmit stun/dtls/srtp/srtcp data through this port,
# This port is multithreaded and supports connection migration caused by client network switching
# Note that if the server is behind NAT and requires port mapping, the external mapped port must be consistent with this port
# Set remb bitrate, closing twcc and enabling remb when non-zero. This setting is effective during RTC streaming and can control the streaming quality


The latest zlmediakit source code comes with a valid SSL certificate default.pem, corresponding to the domain name, which resolves to the IP address To start testing, open in new window in your browser. Please start streaming first before testing playback. If WebRTC playback is not working, please refer to this issueopen in new window.


Q&A(Playback Issues) ?

  • OBS streaming and RTC playback stuttering?

    WebRTC H.264 does not support B-frames, so B-frames need to be removed when using FFmpeg. You can add the -bf 0 parameter or specify the H.264 profile as baseline.

  • RTSP streaming, unsuccessful RTC playback?

    Set directProxy in the zlm configuration file to 0 for RTSP streaming.

  • WebRTC video or audio not playing?

    WebRTC in the web client supports encoding formats such as H.264, opus/48000/2, pcma/8000, pcmu/8000. Check if the encoding format is correct. Usually, the audio is not supported, and you need to use the transcode branch for transcoding (video does not require transcoding).