Subject: [Hls-interest] Adding HLS Interstitials entitlement to a iOS or tvOS app

From: Roger Pantos <[email-masked]>
Date: Fri, 19 Feb 2021 11:55:03 -0800

Hello hls-interest,

On Wednesday I mentioned that a developer preview of Interstitial support was available in the iOS and tvOS 14.5 seeds, but that it requires a special test entitlement to activate. That entitlement is "com.apple.developer.coremedia.hls.interstitial-preview”.

Depending on how you are signing and running your app, you may be able to just add this to the entitlements.plist file in your Xcode project. Some (most?) build configurations will need new support from the developer portal. We are setting that up right now; I’ll let you know when it goes live. Once it does, you’ll be able to follow these instructions:

## Adding the entitlement to your app

Your app must carry the `com.apple.developer.coremedia.hls.interstitial-preview ` entitlement in order to enable interstitial playback. To add the entitlement to your app, you must: enable the capability, generate a new provisioning profile for your app which includes the additional entitlement, switch to manual code signing, select this new provisioning profile, and include the entitlement string in your entitlements file.

### Enabling the capability:
	• Go to <https://developer.apple.com/account <https://developer.apple.com/account>>, sign in to your developer account, and select "Certificates, Identifiers & Profiles" from the Overview pane.
	• Select Identifiers from the sidebar, Click the (+) on the top-left to create a new App ID or select an existing App ID that should use this feature
	• Under Capabilities, select "HLS Interstitial Previews" and click Save on the top-right

### Generating a New Provisioning Profile with Additional Entitlements:
	• Go to <https://developer.apple.com/account <https://developer.apple.com/account>>, sign in to your developer account, and select "Certificates, Identifiers & Profiles" from the Overview pane.
	• Select Profiles form the sidebar, Click the "+" button to begin the process of generating a new provisioning profile.
	• Proceed through the steps to generate your Provisioning Profile, select the App ID enabled for this feature, and download once complete.

### Selecting Your Provisioning Profile in Manual Code Signing:
	• In the General settings of your Xcode Project file, uncheck "Automatically manage signing", then click the "Provisioning Profile" dropdown menu.
	• Import or download your provisioning profile which has the "HLS Interstitial Previews" entitlement.

### Adding the Entitlement to Your Entitlements File:
	• If your project does not already have an entitlements file, create a new Property List file and change its file extension from .plist to .entitlements.
	• In the Build Settings of your Xcode Project file, set the value of Code Signing Entitlements to the path to your .entitlements file.
	• Add the following key to your entitlements file com.apple.developer.coremedia.hls.interstitial-preview with the boolean value `true`.

regards,

Roger Pantos
Apple Inc.