GstWebRTC - Building GstWebRTC - Yocto

GstWebRTC
WebRTC Fundamentals
GstWebRTC Basics
Signaling 1.Predefined Signaling 2.Custom Signaling 3.API Reference 4.Advance Settings Plugin Elements 1.GstWebRTCBin 2.GstWebRTCBin Properties 3.GstWebRTCBin Features 1.Data Channel
Evaluating GstWebRTC
Getting the code
Building GstWebRTC
x86 Platforms Jetson Platforms: TX1, TX2 and Xavier Yocto Platforms: i.MX6 and i.MX8
Examples
x86 OpenWebRTC PubNub AppRTC MediaSoup iMX6 OpenWebRTC PubNub AppRTC iMX8 OpenWebRTC PubNub AppRTC TX1/TX2/Xavier OpenWebRTC PubNub AppRTC
MCU Demo Application
Contact Us

Building GstRrWebRTC on Yocto

RidgeRun offers a Yocto layer containing RidgeRun commonly used packages. You can download this package from https://github.com/RidgeRun/meta-ridgerun. It contains a recipe to build GstRrWebRTC but you need to purchase a license, from the [RidgeRun Store]

Adding meta-ridgerun to your Yocto build

First you need to copy meta-ridgerun in your sources directory:

cp -r meta-ridgerun $YOCTO_DIRECTORY/sources/

Then add the RidgeRun meta layer to your bblayers.conf file. First go to the build configuration directory

cd $YOCTO_DIRECTORY/build/conf/

Open the bblayers.conf file and add the RidgeRun meta layer path $YOCTO_DIRECTORY/sources/meta-ridgerun to BBLAYERS

Update libnice version

• libnice is a dependence of GstRrWebRTC and it needs 0.1.15 version or greater, but Gstreamer distributions do not have this or a greater version for that reason you need to change this recipe.
• We change the recipe for use libnice 0.1.16 because was the newest for yocto at that moment.

First, you need to change the name of the libnice recipe to libnice_0.1.16.bb, this recipe is in the following path:

cd $YOCTO_DIRECTORY/sources/meta-openembedded/meta-oe/recipes-support/farsight

Finally, you need to change the recipe for looks like the following:

SUMMARY = "Interactive Connectivity Establishment library"
DESCRIPTION = "Libnice is an implementation of the IETF's draft Interactive Connectivity Establishment standard (ICE)."
HOMEPAGE = "http://nice.freedesktop.org/wiki/"
SRC_URI = "http://nice.freedesktop.org/releases/libnice-${PV}.tar.gz"
SRC_URI[md5sum] = "5ad936c43d3c6d33117b2c64982f2fd9"
SRC_URI[sha256sum] = "06b678066f94dde595a4291588ed27acd085ee73775b8c4e8399e28c01eeefdf"

LICENSE = "LGPLv2.1 & MPLv1.1"
LIC_FILES_CHKSUM = "file://COPYING;md5=9c42325015702feda4f4d2f19a55b767 \
                    file://COPYING.LGPL;md5=2d5025d4aa3495befef8f17206a5b0a1 \
                    file://COPYING.MPL;md5=3c617710e51cdbe0fc00716f056dfb1a \
"

DEPENDS = "glib-2.0 gstreamer1.0 gstreamer1.0-plugins-base"

PACKAGECONFIG ??= ""
PACKAGECONFIG[gupnp] = "--enable-gupnp,--disable-gupnp,gupnp-igd"

EXTRA_OECONF += " --enable-compile-warnings"

inherit autotools pkgconfig gtk-doc gobject-introspection

FILES_${PN} += "${libdir}/gstreamer-1.0/*.so"
FILES_${PN}-dev += "${libdir}/gstreamer-1.0/*.la"
FILES_${PN}-staticdev += "${libdir}/gstreamer-1.0/*.a"
FILES_${PN}-dbg += "${libdir}/gstreamer-1.0/.debug"

do_configure_prepend() {
    mkdir ${S}/m4 || true
}

do_compile_append() {
    for i in $(find ${B} -name "*.pc") ; do
        sed -i -e s:${STAGING_DIR_TARGET}::g \
               -e s:/${TARGET_SYS}::g \
                  $i
    done
}

Building GstRrWebRTC

• Once you have access to the repository, please open gst-webrtc_xxx.bb in $YOCTO_DIRECTORY/sources/meta-ridgerun/recipes-multimedia/gstreamer/
• Modify the following line in SRC_URI with the correct gst-webrtc URL by changing <Customer-Directory> with your own.

git://git@gitlab.com/RidgeRun/orders/<Customer-Directory>/gst-webrtc.git;protocol=ssh;branch=${SRCBRANCH};name=base \

• Make sure you have added your ssh key to your GitLab account. For more information: SSH Information

• Finally build recipe:

bitbake gst-webrtc

SSH Information

The recipe will fetch the repository using your ssh key, thus it's necessary to add the key in Gitlab page.
For adding it, go to Settings->SSH Keys and add your key, if don't have one you can find there a link about how to generate it.

SHH Issue
If GitLab key hasn't added to your list of known hosts on the PC, you will have fetch errors when trying to build Gst-WebTRC recipe.
One easy way to add the key is when cloning the repository for the first time from gitlab, it will ask if you want to add the key to your list of known hosts.

Example:

git clone git@gitlab.com:RidgeRun/orders/<Customer-Directory>/gst-webrtc.git