Overview (tvOS)

👍
This is a beta offering.
By using this documentation, you are agreeing to abide by the terms of the JWP Beta Program Agreement.

The JWPlayerTVKit for tvOS is built upon the native player framework, AVFoundation. Apps built with this SDK integrate with video hosting, streaming, and analytics services. These services allow you to incorporate media playback experiences, monetize your app, and discover ways to increase viewer engagement.

You can also use this SDK with video content that is hosted with non-JWP services.

Key Features

Advertising

Google DAI
Google IMA
VAST

Monitoring

Analytics
Ability to monitor and set video and audio qualities
API design that enables native control creation or customization
Player, playlist, playback, and content state monitoring

Playback

Fullscreen video playback
AirPlay
DRM
HLS, SmoothStreaming, and MP4 playback

UX

Rich configuration options including playlists, content title, and poster image
Predictable interface familiar to users on Apple's platform
Caption support (.vtt, .srt, .ttml)
Picture in Picture
Thumbnail previews
Related content support
External metadata support

Requirements

General

Item	Notes
Xcode 13+	Download and install Xcode.
tvOS 14.0+	Your app must be leveraging at least this minimum OS version.
JWPlayerTVKit	Follow these instructions to download the SDK.
JWP License Key	1. From your Player Downloads & Keys page, scroll down to the Downloads section. 2. In the Downloads section, copy the LICENSE KEY for the JWP SDK for iOS. NOTE: If you have more than one property in your account, select the property from the dropdown menu at the top of the page. Each property has a unique set of license keys.

Dependencies

Each version of this SDK has been built to work with a specific dependency version. Use the following table to ensure that you are referencing the correct dependency version in your app. The JWPlayerTVKit version listed shows when the minimum dependency support version was first updated.

JWPlayerTVKit	Google IMA SDK
1.0.0	3.14.3

Documentation

This developer guide provides best practice approaches for implementing this SDK. We also provide comprehensive documentation for each class in our SDK reference.

Intended audience

This guide assumes that you have experience developing applications using tvOS and Swift. Before attempting to create a tvOS application using JWPlayerTVKit, you should be familiar with using Xcode and Apple's latest development tools.

Known Issue

When using a simulator, backgrounding the application while content is playing can lead to a known audio issues, such scratchiness and skips. Although this is undesirable, this issue only occurs when using a simulator. This issue does not occur when playing content on a physical device, such as an AppleTV.

This issue can be duplicated with AVPlayer as well. So, Apple may resolve this issue in a future version of Xcode.

Terms of service

By adding the JWP tvOS SDK to your app, you agree to the JWP Terms of Service.