ferjm / media

Servo Media

Requirements

So far the only supported and default backend is GStreamer. So in order to build this crate you need to install all gstreamer-rs dependencies for your specific platform as listed here.

Android

For Android there are some extra requirements.

First of all, you need to install the appropriate toolchain for your target. The recommended approach is to install it through rustup. Taking arm-linux-androideabi as our example target you need to do:

rustup target add arm-linux-androideabi

In addition to that, you also need to install the Android NDK. The recommended NDK version is r16b. The Android SDK is not mandatory but recommended for practical development.

Once you have the Android NDK installed in your machine, you need to create what the NDK itself calls a standalone toolchain.

 $ ${ANDROID_NDK}/build/tools/make-standalone-toolchain.sh \
   --platform=android-18 --toolchain=arm-linux-androideabi-4.9 \
   --install-dir=android-18-arm-toolchain --arch=arm

The final thing for us to do is tell Cargo where to find the Android linker, which is in the standalone NDK toolchain we just created. To do that we configure the arm-linux-androideabi target in .cargo/config (or in ~/.cargo/config if you want to apply the setting globaly) with the linker value.

[target.arm-linux-androideabi]
linker = "<path-to-your-toolchain>/android-18-toolchain/bin/arm-linux-androideabi-gcc"

This crate indirectly depends on libgstreamer_android_gen: a tool to generate the required libgstreamer_android.so library with all GStreamer dependencies for Android and some Java code required to initialize GStreamer on Android. If you want to generate your own libgstreamer_android.so bundle, check the documentation from that repo and tweak the build script accordingly.

Build

For macOS, Windows, and Linux, simply run:

cargo build

For Android, run:

PKG_CONFIG_ALLOW_CROSS=1 cargo build --target=arm-linux-androideabi

Running the examples

Android

Make sure that you have adb installed and you have adb access to your Android device. Go to the examples/android folder and run:

./setup.sh

This will download and add the required GStreamer code generated by libgstreamer_android_gen required to initialize GStreamer on Android. This step is only required once. After that you can run:

source run.sh