Introduction

The following page is about how to integrate and use GStreamer with Apple's iOS. This will allow us take advantage of the multimedia capabilities of GStreamer for mobile applications (in this case for iOS). First we will cover how to integrate the GStreamer framework and after that how to use it in XCode.

Note: If you don't have XCode installed, follow this short guide.

GStreamer integration

You have different ways to do the integration of GStreamer with iOS; one is download the precompiled packages from the GStreamer's site and the other is build our own package of GStreamer using Cebero.

Download GStreamer's source

You can download the precompiled GStreamer packages for iOS from here: https://gstreamer.freedesktop.org/data/pkg/ios/. In that page you have the different version of GStreamer and the file that you have to download is the gstreamer-1.0-devel-<GST_VERSION>-ios-universal.pkg.

Use Cerbero

Cerbero is a GStreamer SDK build system. Based on this guide. Download the Cerbero repository from here: https://github.com/GStreamer/cerbero/tree/master

Before start using Cerbero in Mac OS X, you have to install the following:

Xcode
CMake

After install the above software, do the following:

Check that you environment have the needed configuration

$ ./cerbero-uninstalled -c config/cross-ios-universal.cbc bootstrap

Build GStreamer

$ ./cerbero-uninstalled -c config/cross-ios-universal.cbc package gstreamer-1.0

After the process is completed, gstreamer-1.0-devel-<GST_VERSION>-ios-universal.pkg is generated.

Use of GStreamer in XCode

Use of the GStreamer's template for XCode

Once that you have installed GStreamer for iOS, when you are creating a new iOS project, go to the Templates section and chose of the the GStreamer's template.

Fix of some issues of the GStreamer's template

There is a issue with the GStreamer's templates and, in order to fix them, follow these steps:

At the beginning of the gst_ios_init.m file add:

#import <Foundation/Foundation.h>

Go to the project's build settings and search for the C++ Standard Library option and the set it as libstdc++ (GNU C++ standard library)

Go to the project' build phases and in 'Link Binary With Libraries' section add the following:
- libstdc++.6.tbd
- libiconv.tbd

Examples

To test you GStreamer installation, implement one of the following examples: iOS GStreamer examples

Take in count the following:

You have to edit gst_ios_init.h to include the plugins that you need.
x_overlay has been changed to video_overlay
You need GLKView to display videos.

❯