Skip to main content
Skip table of contents

Apple (FPS) SDK 5 Example Code Quick Start

This guide enables you to demonstrate CONNECT Player features and view the example code.

Example code is provided for iOS only.

Prerequisites

Make sure you have the latest version of Xcode installed.

Download the iOS SDK pack, which supplies all the files needed to launch the player and start streaming content.

  • opy-sdk-ios-fps-5.2.x-example-code.zip
    This file contains application projects which demonstrate how to use simple and advanced features; for example, playing clear and encrypted streams.

  • opy-sdk-ios-fps-5.2.x-integration.zip
    This contains the SDK framework files.

You also need a device running iOS 12 or above.

Procedure

  1. Save the SDK pack to your development machine and unzip it. The extracted package contains a zipped set of example code, extract the contents of the example-code.zip file to a suitable location.

  2. Copy the SDK framework folder into the example-code folder.

  3. Start Xcode, and then select the required project from the extracted package. The following projects are available and grouped here for ease of understanding:

    • Basic Playback, UI, layout

      • basic-playback This demonstrates playback of a clear stream with no additional functionality.
      • container-view Manages the view hierarchy for standard playback.
      • track-selection Clear playback with multiple audio tracks and subtitles.
      • resolution-capping Clear playback with resolution capping.
      • objective-c support Code development using Objective-C.
      • thumbnail-seeking-webvtt Thumbnail previews using webvtt.
      • thumbnail-seeking-iframe Thumbnail previews using iFrame.
    • Encrypted Playback
    •  Advertising
      • dynamic-ads-ima Clear playback with Adverts with Google IMA. Pod install is required to generate the XCode workspace, see the README.md file for additional steps.
      • serverside-ad-insertion Demonstrates use of adverts within streams with Server Side Ad Insertion.
      • yospace-controlbar Demonstrates the integration of the Yospace user interface handling of streams with Server Side Ad Insertion. 
    • Diagnostics and Statistics
    • Offline Playback
      • offline-encrypted Downloads an encrypted HLS stream while requesting license and then plays offline content.
      • offline-license-predelivered Prefetches the license before downloading an encrypted HLS stream and then plays offline content.
      • offline-license-renewal Downloads an encrypted HLS stream, fetches the license, plays the offline content and Renews the licence when an license expiry error is received.
      • offline-playback Offline playback of HLS streams.
      • minimumbitrate-for-offline Select minimum bitrate to download for offline playback.
      • minimumresolution-for-offline Select minimum resolution to download for offline playback. (Only available for iOS 14 and above).
      • drm-token-passing Parse the SSP DRM stream token to get the license duration, and set it to offline content.
    • Advanced features
      • multi-instance Provides multiple instances of the player.
      • smart-lib Demonstrates use of Broadpeak SmartBeam.
    • Content Security
      • quickmark-pull-mode Demonstrates use of Forensic Watermarking.
      • quickmark-push-mode The push mode variant of the same.

  4. Connect an Apple device to your machine, and build and run the application.


For full details on integrating the SDK with your application, see the Apple (FPS) SDK 5 Integration Guide. See also the API reference guide provided in the iOS SDK pack.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.