Session handling

SmartLib requires only few calls to have a minimum implementation (nanoCDN Agents discovery, CDN advanced features, player analytics...)

This sample code shows how:

• initialize the lib
• create a streaming session object
• attach a player to enable analytics
• start a streaming session
• stop a streaming session (standard case and error case).

note

You can find fully functional sample apps on our GitHub page:

• ExoPlayer: https://github.com/Broadpeak-tv/smartlib-android-sample-app
• Shaka Player: https://github.com/Broadpeak-tv/smartlib-web-sample-app
• AVPlayer: https://github.com/Broadpeak-tv/smartlib-ios-sample-app

Launch screen

It is recommended to initialize SmartLib once, in the launch screen. Some background tasks has to be done before starting any streaming session.

Android

public class LaunchScreenActivity extends Activity {
    ...
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    
        SmartLib.getInstance().init(this, ...);
    }
    
    ...
}

iOS & tvOS

#import "SmartLib.h"

@interface LaunchScreenController ()

@end

@implementation LaunchScreenController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    [SmartLib initSmartLib:... nanoCDNHost:... broadpeakDomainNames:...];
}

@end

Play content screen

The sample code is generic for any players, please use one of our specific guides to get more details.

Android

public class SomePlayerActivity extends Activity {

    // Your player object
    private Object mPlayer;

    // SmartLib StreamingSession
    private StreamingSession mSession;

    // It is recommended to use a different thread to start a session
    private ExecutorService mExecutor = Executors.newSingleThreadExecutor();

    ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_player);
    
        // Create the player
        mPlayer = PlayerFactory.newInstance();
    
        // Registering to player error events
        mPlayer.setOnErrorEvent(this);
    
        // Create a StreamingSession object
        mSession = SmartLib.getInstance().createStreamingSession();
    
        // Attach the player to the session
        mSession.attachPlayer(mPlayer);
    
        mExecutor.submit(() -> {
            StreamingSessionResult result = mSession.getURL(...);
        
            if (!result.isError()) {
                mPlayer.playURL(result.getURL());
            } else {
                mSession.stopStreamingSession();
            
                showNoSessionCreatedMessage();
            }
        });
    }

    @Override
    public void onPlayerError(PlaybackException error) {
        // If the playback has been canceled because of a player error 
        // (i.e. non-recoverable error), stop the streaming session
        if (error.playbackCanceled) {
            mSession.stopStreamingSession();
    
            showPlayerTriggeredAnErrorMessage();
        }
    }
    
    @Override
    protected void onDestroy() {
        super.onDestroy();
    
        mExecutor.submit(() -> {
            // Stop the streaming session and the playback
            mSession.stopStreamingSession();
            if (mPlayer != null) {
                mPlayer.stop();
            }
        });
    }

    ...
}

iOS & tvOS

#import "SmartLib.h"

@interface AVPlayerDevViewController ()

// Your player object
@property (nonatomic,strong) NSObject *player;

// SmartLib StreamingSession
@property (nonatomic,strong) StreamingSession *session;

@end

@implementation AVPlayerDevViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // Start the session in a different thread, getURL can make requests to the Broadpeak Advanced CDN, nanoCDN...
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^(void) {
        // Create the player
        self.player = [PlayerFactory newInstance];

        // Registering to player error events
        [self.player setOnErrorEvent:self];

        // Create a StreamingSession object
        self.session = [SmartLib createStreamingSession];
        
        // Attach the player to SmartLib
        [self.session attachPlayer:self.player];

        // Start the session
        StreamingSessionResult *result = [self.session getURL:...];
        
        dispatch_async(dispatch_get_main_queue(), ^(void) {
            if (![result isError]) {
                [self.player playURL:[result getURL]];
            } else {
                [self.session stopStreamingSession];

                [self showNoSessionCreatedMessage];
            }
        });
    });
}

- (void)onPlayerError:(PlayerError *)error {
    // If the playback has been canceled because of a player error 
    // (i.e. non-recoverable error), stop the streaming session
    if (error.playbackCanceled) {
        [self.session stopStreamingSession];

        [self showPlayerTriggeredAnErrorMessage];
    }
}

- (void)viewDidDisappear:(BOOL)animated {
    [self.session stopStreamingSession];
    [player stop];
    
    [super viewDidDisappear:animated];
}

@end