1. Getting Started

Using the THEOplayer iOS SDK is possible through the following steps:

  1. In the target's General tab, in the Embedded Binaries click (+) and select the THEOplayerSDK.framework
  2. Import the framework in your view controller
    #import <THEOplayerSDK/THEOplayerSDK-Swift.h>
  3. Declare a player variable and initialize it
    THEOplayer *player =  [[THEOplayer alloc] initWithConfiguration:nil];
  4. Position and size your player
    [player setBounds:CGRectMake(0, 0, 320, 180)];
    CGSize screenBounds = UIScreen.mainScreen.bounds;
    [player setCenter:CGPointMake(screenBounds.width/2, screenBounds.height/2)];
  5. Add the player to your controller's view hierarchy
    [player addAsSubviewOf:controller.view];
  6. Set a source to the player
    [TypedSource *typedSource = [[TypedSource alloc] initWithSrc:@"https://www.examples.com/index.m3u8" type:@"application/x-mpegurl"];
    SourceDescription *source = [[SourceDescription alloc] initWithSources:typedSource ads:NULL textTracks:NULL poster:NULL analytics:NULL metadata:NULL];
    player.source = source;


2. Interoperability Swift/Objective-C

Since THEOplayer iOS SDK is a Swift framework, it is possible to integrate it into an Objective-C project. To be accessible and usable in Objective-C a Swift class must be a descendant of an Objective-C class. Except for Swift-only features such as Generics, Non-Int Enumerations, Structures, etc. That's why the complete THEOplayer iOS SDK API is not accessible and usable directly in Objective-C.

However, you can still use the complete THEOplayer API in your Objective-C project through Swift code thanks to the the mix and match feature. From Apple documentation: "Using mix and match, you can implement part of your app’s functionality using the latest Swift features and seamlessly incorporate it back into your existing Objective-C codebase."

Listen to events in an Objective-C app

Adding event listeners is one of the features that are not available in Objective-C code. Here's an example of how you can listen to an event in your Objective-C app through Swift code.

  1. Create a Swift file that contains a Swift class with a THEOplayer property. This class should be available in Objective-C, so it should extend an Objective-C class, here NSObject.
    @objc class SwiftCode : NSObject {
        var player : THEOplayer
        init(player : THEOplayer) {
            self.player = THEOplayer()
  2. Create a method to add some event listeners.
    func addEventListeners() {
         _ = player.addEventListener(type: PlayerEventTypes.PLAY, listener: handleEvent)
         _ = player.addEventListener(type: PlayerEventTypes.PAUSE, listener: handleEvent)
    func handleEvent (event : CurrentTimeEvent) {
         // Do something with the event
        print("Received \(event.type) event")
  3. Import the Xcode-generated header file for your Swift code into any Objective-C .m file you want to use your Swift code from.
    #import "YourProductName-Swift.h"
  4. Finally, in your Objective-C code, instanciate the Swift class and its addEventListeners method.
    var swiftCode = [[SwiftCode alloc] init];
    [self.swiftCode addEventListeners];


You can learn more about Interopability and Swift type compatibility on the Apple documentation.