Classes

BroadpeakSettings

Create Appium client instance

ChromecastMetadata

Create Appium client instance

ConvivaMetadata

ConvivaSettings

Create IMA client instance

Plugin wrapping Google IMA ads

Create IMA client instance

Create Thumbnails client instance

CastlabsVT

CastlabsVT

Create Youbora client instance

YouboraMetadata

YouboraSettings

BasePlayer implements all properties that are updated from the State and must be synchronised on ‘playerQueue’

Cross-component communication move outside factory

Default handler for phone call interruption

The meta-data class wraps and mandatory and optional meta-data that are send to various analytics backends.

The two parameters that are mandatory in all cases are live and assetId. The live flag needs to be set to true if the content is a live stream. Analytics backends usually require this information before playback starts. The assetId identifies the content uniquely within the analytics system.

The cast settings class wraps common settings for Chromecast appId is mandatory for casting.

Download

MediaDownloadProgress

Synthesized DrmConfiguration object. The configuration will expose either a DRMtoday specific configuration object or a dictionary with license, provisioning, and certificate URLs for the available DRM systems.

Source: https://assets.castlabs.com/api/#DrmTodayConfiguration https://assets.castlabs.com/api/#DrmTodayOnboardConfiguration https://assets.castlabs.com/api/#CustomDrmConfiguration

This is the structure that describes the player configuration for a single asset

ClearKey usage:

guard let url = URL(string: "STREAM-URL") else {
    return
}

let playerConfiguration(with: url, contentType: .hls)
guard let player =  PRESTOplaySDK.shared.playerForContent(playerConfiguration) else {
    print("no player")
    return
}

Fairplay usage:

guard let url = URL(string: "STREAM-URL") else {
    return
}

let playerConfiguration(with: url, contentType: .hls)
playerConfiguration.drmSystem = .fairplay
playerConfiguration.drmConfiguration = DrmConfiguration()
playerConfiguration.drmConfiguration.environment = .production
playerConfiguration.drmConfiguration.userId = "..."
playerConfiguration.drmConfiguration.sessionId = "..."
playerConfiguration.drmConfiguration.merchant = "..."
playerConfiguration.drmConfiguration.assetId = "..."
playerConfiguration.drmConfiguration.variantId = "..."

guard let player =  PRESTOplaySDK.shared.playerForContent(playerConfiguration) else {
    print("no player")
    return
}

Custom RequestModifier usage:

Example showing custom Fairplay URLs

guard let url = URL(string: "STREAM-URL") else {
    return
}

let playerConfiguration(with: url, contentType: .hls)
playerConfiguration.drmSystem = .fairplay
playerConfiguration.drmConfiguration = DrmConfiguration()
playerConfiguration.drmConfiguration.licensingUrl = URL(string: "LICENSING-URL"
playerConfiguration.drmConfiguration.certificateUrl = URL(string: "CERTIFICATE-URL")

// implement custom request modifier to add headers and intercept
// the request
 PRESTOplaySDK.shared.requestModifiers.append(RequestModifier())
 PRESTOplaySDK.shared.responseModifiers.append(ResponseModifier())

guard let player =  PRESTOplaySDK.shared.playerForContent(playerConfiguration) else {
    print("no player")
    return
}

Error Interface

The subtitles settings to customize subtitles rendering.

GridThumbnail

Used to define a request to download images and slice them into multiple thumbnails in a grid pattern. Each image will be sliced into smaller segments based on the gridWidth and gridHeight. E.g. if these are both set to 2, then the image will be divided into a 2 x 2 grid producing 4 equal sized thumbnails per image. The grid cells are ordered from left to right, then top to bottom.

Single or multiple images may be downloaded using this object. If maxIndex is greater than 1 and the pathTemplate contains the token index then multiple image urls can be specified. The final image urls which will be downloaded are specified by the baseUrl + the result of the pathTemplate substitution. The index token in pathTemplate will be substituted with the index 1 up to and including maxIndex. E.g. if pathTemplate where image_$index$.jpg and maxIndex were 3, then image_1.jpg, image_2.jpg, image_3.jpg would be generated from the substitution.

Each thumbnail will be displayed for durationMs with no gabs in between. Therefore thumbnails will cover a total timerange of durationMs multiplied by the total number of thumbnails generated.

Defines a single thumbnail image along with it’s timing information.

mack: I think this should be internal only