Subject: [Hls-interest] Entitlement for HLS interstitial preview on iOS 14.5 now live

From: Roger Pantos <[email-masked]>
Date: Wed, 24 Feb 2021 09:03:24 -0800

Hello there. As I mentioned on hls-interest earlier, the developer preview of HLS Interstitial support in iOS/tvOS 14.5 requires an entitlement to activate. The entitlement is now live on Apple’s developer portal. Here are the instructions to add it to your app. (As a reminder, HLS Interstitial support currently requires a native AVFoundation client.)

## 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`.

You should see something like this on the portal:

Reach out if you run into problems.

regards,

Roger Pantos
Apple Inc.