Listen and control audio through Siri Intents or listen and watch media content from your app with shortcuts.


With the Media domain, users can play and control audio media in your app. Your Intents app extension directs any media-related requests to your app, which then handles the request.

Siri can suggest shortcuts to audio available in your app when the user wants to listen to the content. For example, Siri may suggest a playlist to the user after they connect headphones to their iPhone. These suggestions give the user a convenient way to play the media in your app.

In order for Siri to suggest media content, you should donate an INPlayMediaIntent object to Siri after the user plays the content (see Donating Shortcuts). To have Siri suggest new media that might be of interest to the user, save INPlayMediaIntent shortcuts for the new content to the INUpcomingMediaManager.



Controlling Audio with SiriKit

Control audio playback and handle add media requests using SiriKit Media Intents

Playable Media Intents

Playing Media Through Siri Shortcuts

Play audio and video from your app using media intent shortcuts.

protocol INPlayMediaIntentHandling

The interface an object implements to confirm and handle play media intents.

class INPlayMediaIntent

An intent that contains information about media playable from your app.

class INPlayMediaIntentResponse

Your response to a play media intent.

Add Media

protocol INAddMediaIntentHandling

The handler interface that adds media.

class INAddMediaIntent

A request to add a media item.

class INAddMediaIntentResponse

Your app’s response to an add media intent.

Search for Media

protocol INSearchForMediaIntentHandling

The interface that handles media search requests.

class INSearchForMediaIntent

A request to search for a media item.

class INSearchForMediaIntentResponse

Your app’s response to a search media intent.

Update Media Affinity

protocol INUpdateMediaAffinityIntentHandling

The interface that handles requests to update the user’s preference for a media item.

class INUpdateMediaAffinityIntent

A request to update the user’s affinity for a media item.

class INUpdateMediaAffinityIntentResponse

Your app’s response to an update media affinity intent.

User Context

class INUserContext

An object that provides user information to Siri.

class INMediaUserContext

An object that provides user information to Siri.

Data Objects

class INMediaItem

An object that describes a piece of media content, such as a song, TV show, artist, or podcast playlist.

class INMediaSearch

An object that describes a media type to search for, such as a station name, song name, or album name.

Upcoming Media

class INUpcomingMediaManager

The manager object you use to suggest media to the user.

Resolution Results

class INAddMediaMediaDestinationResolutionResult

A resolution result for the types of destinations when adding media.

class INAddMediaMediaItemResolutionResult

A resolution result for the media item to add.

class INMediaDestinationResolutionResult

A resolution result for the media destination types.

class INMediaItemResolutionResult

A resolution result for media item types.

class INMediaAffinityTypeResolutionResult

A resolution result for the user’s affinity for a media item.

class INPlayMediaMediaItemResolutionResult

A resolution result for the media item to play.

class INPlayMediaPlaybackSpeedResolutionResult

A resolution result that determines the playback speed of a media item.

class INPlaybackRepeatModeResolutionResult

A resolution result for the playback repeat modes of a media item.

class INPlaybackQueueLocationResolutionResult

A resolution result for the requested playback queue location.

class INSearchForMediaMediaItemResolutionResult

A resolution result for the media item for which to search.

class INUpdateMediaAffinityMediaItemResolutionResult

A resolution result for updating the user’s affinity for a media item.

See Also

Siri Domains


Send messages and search the user’s received messages.

Lists and Notes

Create and manage notes and to-do list items.


Start, end, and manage fitness routines.


Send payments between users or pay bills.

VoIP Calling

Initiate calls and search the user’s call history.

Visual Codes

Convey contact and payment information using Quick Response (QR) codes.


Search for and display photos.

Ride Booking

Book rides and report their status.

Car Commands

Manage vehicle door locks and get the vehicle’s status.


Interact with a vehicle’s CarPlay system.

Restaurant Reservations

Create and manage restaurant reservations with help from the Maps app.