About AirPlay

Explains how to prepare video content, websites, and apps to work with AirPlay.

At a Glance

Using AirPlay, users redirect audio and video to either an Apple TV or to an AirPlay-enabled sound system or remote speakers. AirPlay is user controlled. As a content provider, your primary role is to ensure that your media is AirPlay compatible and that your app or website works correctly with AirPlay. You might also want to provide high-definition video or surround-sound audio when your content is being redirected to a home theater system.

As an app developer, you can enhance the user’s AirPlay experience in several ways:

Provide an AirPlay output device picker.

Provide audio metadata that the AirPlay-enabled output device can display.

Listen for and respond to remote events from the AirPlay output device, such as play/pause.

Use the iOS-based device’s built-in display independently when a second display is active.

Choose the Best Option for Media Playback

You can deliver AirPlay-compatible audio and video to iOS-based devices in four distinct ways:

Embed audio or video in your website using the HTML5 <audio> and <video> tags. Media delivered this way works on iOS-based devices through the Safari browser or in apps that use a web view.

Stream audio and video directly to your app, playing the media using AV Foundation, the MPMoviePlayerController class, or the UIWebView class.

Store the media locally on an iOS-based device.

Make your content available through iTunes, either commercially or as a podcast.

AirPlay is compatible with media delivered by progressive downloading or HTTP Live Streaming, but HTTP Live Streaming is preferred. To prepare your media for playback through AirPlay, make sure that it’s in a supported format—for example, H.264 video and AAC or MP3 audio. No special server configuration is required, apart from associating the correct MIME types with the file extensions used to send the media. To enrich the user’s AirPlay experience, you can also provide alternative audio and video streams that take advantage of a home theater system’s capabilities.

Relevant chapter: Preparing Your Media and Server for AirPlay

You Can Opt Into or Out of AirPlay for Video

AirPlay is user initiated and, generally speaking, user controlled. Audio content (other than system sounds) can always be redirected by the user to an AirPlay-enabled sound system, and so can iTunes content, whether audio or video. If you provide video from your website or display it from within your app, however, you can choose to opt into AirPlay, enabling user redirection, or opt out of AirPlay, restricting your video to the device on which it is received.

In iOS 5.0 and later (including Safari in iOS 5.0), AirPlay is enabled by default and you must explicitly opt out of AirPlay if you want to prevent users from redirecting your video to Apple TV.

Relevant chapter: Opting Into or Out of AirPlay

Provide a Great AirPlay User Experience in Your App

You can include an AirPlay picker in your app’s user interface, allowing the user to select an AirPlay device for output without leaving your app.

If your app’s audio or video is being redirected to an AirPlay-enabled device that has its own controls, you can provide metadata—such as a song title and album artwork—to enhance the user’s experience. In addition your app should respond to remote events, such as play/pause or next-track requests.

Relevant chapter: Enriching the AirPlay Experience in Your App

Protect Your Media Using Encryption and Authentication

If you deliver your audio and video using HTTP Live Streaming, there is built-in support for encryption, with automatic generation of encryption keys and initialization vectors on a periodic basis (see HTTP Live Streaming Overview for details). If you deliver the keys over HTTPS and use authentication, however, your app is responsible for the initial authentication handshake.

Relevant chapter: Encryption and Authentication

About AirPlay

At a Glance

See Also