Apple (FPS) SDK 5 Release Notes

This is a feature and maintenance release.

Examples unified in SwiftUI

Rebuild with Python 3.x KOP Patcher and PAK

PRM functionality removed

Better handling of playlist downloads.

get error info from the OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

This was a feature release.

iOS 16 support

Simulator playback (clear content only)

FairPlay licence in binary form

XCFramework support for:
iOS/iPadOS
iOS/iPadOS simulator
tvOS
tvOS simulator 

There were no fixes in this release.

get error info from the OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player. This issue only affects Xcode 12.3.

Quickmark cannot currently be used with the simulator.

This was a feature release.

SSM Kill API error code

Logging in production builds

Thumbnails enhancement

There were no fixes in this release.

get error info from the OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player. This issue only affects Xcode 12.3.

Quickmark cannot currently be used with the simulator.

This release was built with the latest version of Xcode and provides backwards compatibility for Swift.

Support for upgraded QuickMark headend

There were no fixes in this release.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player. This issue only affects Xcode 12.3.

Quickmark cannot currently be used with the simulator.

This was a maintenance release.

Support for Swift v5.6.

There were no fixes in this release.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

Quickmark cannot currently be used with the simulator.

Insight Library issue: When setVODContent or setLiveContent are called immediately after calling stop(), playback content information reported to the backend is null.

This was a feature release.

Statistics API update for React Native Player plugin.

Insight Agent/Wrapper version update.

There were no fixes in this release.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

Quickmark cannot currently be used with the simulator.

Insight Library issue: When setVODContent or setLiveContent are called immediately after calling stop(), playback content information reported to the backend is null.

This was a feature release.

Addition of tokenType support for React Native Player plugin.

There were no fixes in this release.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

Quickmark cannot currently be used with the simulator.

This was a maintenance release.

There were no new features in this release.

How to keep prepared OTVPersistenceAsset instances between app sessions.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS12.4.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

Quickmark cannot currently be used with the simulator.

This was a maintenance and feature release, it included the new iOS/tvOS 15 support and
Secure Session Management update features.

FPS SSM enforcement

Customer SSM

Airplay support with SSM

iOS/tvOS 15 support

Occasional playback failed for repeated FPS license requests.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS 12 iPhone/iPad.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

Quickmark cannot currently be used with the simulator.

This was a maintenance release.

There were no new features in this release.

iOS migration to 5.x - Download To Go

PersistenceAsset.drmMode losing its value in different phases of the download lifecycle

Unable to resume paused download after the app was restarted

How to keep prepared OTVPersistenceAsset instances between app sessions

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS 12 iPhone/iPad.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue; a workaround is detailed in Creating the Player.

This was a maintenance and feature release.

QuickMark support for tvOS.

The licence request notification did not fire for re-download content.

get error info from OTVLicenseDownloadEnded notification.

The same iframe thumbnail is shown anywhere on the seek bar.

A random HTTP 500 error is returned when trying to download multiple downloads at once in quick succession.

Unable to playback downloaded PRM stream on iOS 12 iPhone/iPad.

Integrators may experience a build issue with Framework, where it claims it cannot be included due to containing build for the device and simulator. This is an Xcode settings issue, and a workaround is detailed on the portal in the section Creating the Player.

This release provided new features.

External connection report.

Low latency support.

Backwards compatibility for Swift 5 in QM.

There were no fixes in this release.

Quickmark library cannot support iOS simulators.

This release improved the offline playback feature.

Selecting the download stream.

API to prepare download and return available bitrates and resolutions.

API to select bitrate or resolution for downloading.

There were no fixes in this release.

Quickmark library cannot support iOS simulators.

This release included Nexguard Quickmark Forensic Watermarking v2.x

The latest version of Watermarking with NexGuard.
Integrated NexGuard watermarking technology to protect high-value content against piracy.

There were no fixes in this release.

Quickmark library cannot support iOS simulators.

This release included the improvement of offline playback and HEVC report.

APIs to set licence duration to offline content.

API to return the estimated size of the content before the download finishes.

API to return the real download size during downloading.

API and example code to renew the licence for offline content.

Error notification when playing offline content and the license gets expired.

Example code to get licence duration from SSP stream token.

Example code to select the bitrate for downloading.

Example code to select the resolution for downloading.

Support for restoring unfinished downloading.

Support for updating download progress event when the application is activated from the background.

HEVC report.

The download progress event OTVAssetDownloadProgressNotification was not always triggered when a download was in progress, and the application was recovered from the background.

The download in progress could not recover if the application was terminated via the App Switcher (for example, on devices with a home button, a double-home-press and slide up).

This release includes support for SSM single workflow, licence removal and one bug fix.

Support for Customer SSM
A new delegate OTVCustomerSSMDelegate is added to accept customer SSM callback.

Support for iOS/tvOS 14
The SDK is built with Xcode 12 to support iOS/tvOS 14.

Removal of Player licence
The Player licence (opy_licence) is no longer required for SDK integration.

HTTP error codes could not be exposed correctly.

The download progress event OTVAssetDownloadProgressNotification is not always triggered when a download is in progress, and the application is recovered from the background.

The download in progress cannot recover if the application is terminated via the App Switcher (for example, on devices with a home button, a double-home-press and slide up).

This release includes support for Objective‑C and PRM, implements missing player statistics APIs and a bug fix.

Objective-C support

PRM support

Implement specific missing Player Statistics API

Playing startover url for live is throwing a playback error.

Get error info from OTVLicenseDownloadEnded notification.

Same iframe thumbnail is shown anywhere on seek bar.

Random HTTP 500 error returned when trying to download multiple downloads at once in quick succession.

This release is to provide bug fixes.

There are no new features in this release.

Playing startover url for live is throwing a playback error.

CDN problem with TWO requests for HLS MASTER playlist.

Downloads are not playing back, and the same stream is unplayable. Playback of some downloaded streams not working on iOS 11.4.

Implement specific missing Player Statistics API.

Get error info from OTVLicenseDownloadEnded notification.

This release includes support for Event Timeline and Server Side Ad Insertion features. It provides a new OTVAVPlayer API for improved support of multiple player instances, and example code to demonstrate Smartlib integration. Bug fixes are also included.

Event Timeline and Analyzer

Server Side Ad Insertion

Zapping to nil and then playing a new stream does not render subtitles().

PRM offline playback crashes the app when trying to play the downloaded file.

Downloads are left in waiting state after killing the app and restarting new downloads.

Playback of some downloaded streams not working on iOS 11.4.

This release is to support Yospace Server Side Adverts, SMPTE‑TT TXT and APIC subtitles.

YoSpace server side ad insertion support

SMPTE‑TT TXT subtitles

APIC subtitles

There are no fixes in this release.

Test certificates have expired for encrypted playback Example apps.

Downloads are left in waiting state after killing the app and restarting new downloads.

This release is provided to improve resilience of SSM handling.

There are no new features in this release.

Improved resilience of SSM handling

Test certificates have expired for encrypted playback Example apps.

Downloads are left in waiting state after killing the app and restarting new downloads.

This release is to support for the skip licence requests and SSM(sync) timeout features.

Skip licence request if an SSM session is not setup at the time of the request.

SSM (sync) setup and teardown to have three second timeout.

There are no fixes in this release.

Test certificates have expired for encrypted playback Example apps.

Downloads are left in waiting state after killing the app and restarting new downloads.

This release is to support removal of unnecessary inheritance of protocols to NSObjectProtocol.

Remove unnecessary inheritance of protocols to NSObjectProtocol.

There are no fixes in this release.

Test certificates have expired for encrypted playback Example apps.

Downloads are left in waiting state after killing the app and restarting new downloads.

This release is to support the SRT subtitles,
SSM sync/Async and Logging features.

SRT subtitles

SSM sync/Async

Logging

Support for iOS/tvOS 13

There are no fixes in this release.

Test certificates have expired for encrypted playback Example apps.

This release is to support Swift 5.1 in Xcode 11/iOS 13.

There are no new features in this release.

There are no fixes in this release.

Watermarking:

• QuickMark watermark does not appear when the device time is not set correctly.

• InvalidURL is not firing when the URL does not connect.

• InvalidURL is not firing when the URL does not start with http:// or https://

This release has been requested by ION to change SSM session setup and teardown to synchronous.

SSM session setup and teardown changed to synchronous.

There are no fixes in this release.

Watermarking:

• QuickMark watermark does not appear when the device time is not set correctly.

• InvalidURL is not firing when the URL does not connect.

• InvalidURL is not firing when the URL does not start with http:// or https://

This release has been requested by ION for bug fixes.

There are no new features in this release.

Need OPY SDK Library with IOS Simulator support in objectC project

The licence request fails to retry because the SSM token is not ready. SSP token can only be used once.

Watermarking:

• QuickMark watermark does not appear when the device time is not set correctly.

• InvalidURL is not firing when the URL does not connect.

• InvalidURL is not firing when the URL does not start with http:// or https://

This release is to provide support for the new SSM, Container View, Thumbnails I‑frame and Multi Instance features.

Secure Session Management

Container View

Thumbnails I‑frame

Multi Instance

Impression is not always fired when player screen is in the background and brought to the foreground after four hours.

D2G licence download failures are not reported.

Random square is not moving every 60 seconds.

tvOS ref app does not always auto-play streams.

Occasionally watermark is larger than video in multi-instance.

Crash returning to streams list on iOS 11.2.1 after viewing stream with watermarking.

Download to Go of SSP stream crashing on iPad 11.2.1

Download to Go of SSP stream not starting on iPad iOS 11.4

Watermarking:

• QuickMark watermark does not appear when the device time is not set correctly.

• InvalidURL is not firing when the URL does not connect.

• InvalidURL is not firing when the URL does not start with http:// or https://

This release is to provide support for Swift 5.

Swift 5 support

There are no fixes in this release.

Impression is not always fired when the player screen is in the background and brought to the foreground after four hours.

Watermarking:

• Enabling and disabling the watermark causes the player to freeze

• Enabling and disabling watermark causes memory leak

• Watermark cannot display as full screen on iPhoneX

• QuickMark watermark does not appear when the device’s time is not set correctly

• InvalidURL is not firing when the URL does not connect

• InvalidURL is not firing when the URL does not start with http:// or https://

This release provides support for Client-side impressions.

Client-side Impressions
An impression is essentially a video view; when a user sets the source of the OpenTV Player to a content source, this is counted as an impression. Impressions are defined by specific business rules.

Airplay - Refapp crashes on pause/play/seek during airplay.

Impression is not always fired when the player screen is in the background and brought to the foreground after four hours.

Watermarking:

• Enabling and disabling the watermark causes the player to freeze

• Enabling and disabling watermark causes memory leak

• Watermark cannot display as full screen on iPhoneX

• QuickMark watermark does not appear when the device’s time is not set correctly

• InvalidURL is not firing when the URL does not connect

• InvalidURL is not firing when the URL does not start with http:// or https://

The release includes the API rename (from OPYxxx to OTVxxx), support for playback and network analytics, NexGuard watermarking and Resolution capping. Bug fixes are also included.

Analytics
Implementation of network and playback analytics.

Watermarking with NexGuard
Integrated NexGuard watermarking technology to protect high-value content against piracy.

Resolution capping
We now support setting maximum resolution limits for adaptive streaming as an alternative to limiting by bitrate.

SMPTE subtitles sometimes get stuck on the screen while seeking.

Zapping between streams and enabling subtitles resulted in the video not starting from the beginning of the stream.

Watermarking:

• Enabling and disabling the watermark causes the player to freeze

• Enabling and disabling watermark causes memory leak

• Watermark cannot display as full screen on iPhoneX

• QuickMark watermark does not appear when the device’s time is not set correctly

• InvalidURL is not firing when the URL does not connect

• InvalidURL is not firing when the URL does not start with http:// or https://

There are no new features in this release.

The player failed to start

There are no known issues in this release.

Google IMA support
We have included a sample integration of Google’s IMA framework that allows VAST V3, VAST V2 and VMAP 1.0.1 compliant ads. Supported ad types:

• Linear ads

• Nonlinear ads

• Companion ads

• Skippable linear ads

• Ad pods

Sample integrations with Conax and SSP
For ease of integration, we have included sample integrations of our two MDRM backends, complete with demos inside the sample application.

Picture in picture
We have added support for PiP into the player.

PNG ID3 Subtitles
We have added support for PNG subtitles delivered over ID3.

WebVTT subtitles
We have added support for WebVTT subtitles.

Multi-audio
We have added support for multi-audio subtitles as per the HLS v5 spec.

tvOS BETA release
This package contains the first tvOS beta with integrations against Conax and SSP for evaluation.

There are no fixes in this release.

There are no known issues in this release.