# Improving Siri Media Interactions and App Selection Fine-tune voice controls and improve Siri Suggestions by sharing app capabilities, customized names, and listening habits with the system. ## Discussion When the user interacts with Siri to request media, the system may send your app an intent that represents the user’s request. To effectively communicate the user’s request to your app, the system relies on the intents your app supports, the names of media items and performers, and the user’s listening habits. The system also uses this information to make proactive suggestions and provide relevant search results. Your app can contribute to this information with Core Spotlight and Intents to improve the accuracy, relevance, and convenience of playing media. App Selection streamlines voice-driven interactions. As the system learns about the user’s listening habits, it intelligently predicts when the user intends for your app to handle a request, even if the user didn’t mention your app by name. By adopting these Intents and Core Spotlight APIs, your app also helps refine App Selection’s predictions. For information about how Apple protects user privacy when your app shares information with the system, see the Siri section of [Privacy - Features](https://www.apple.com/privacy/features/). > Related Sessions from WWDC20: > Session 10073: [Empower Your Intents](https://developer.apple.com/videos/play/wwdc2020/10073/) > > Session 10087: [Design for Intelligence: Make Friends with “The System”](https://developer.apple.com/videos/play/wwdc2020/10087/) > > Session 10060: [Design High Quality Siri Media Interactions](https://developer.apple.com/videos/play/wwdc2020/10060/) ### Support Media Intents Use [`INPlayMediaIntent`](/documentation/Intents/INPlayMediaIntent) to receive media intents from Siri and Shortcuts. Support other system-defined media intents, such as [`INUpdateMediaAffinityIntent`](/documentation/Intents/INUpdateMediaAffinityIntent) or [`INAddMediaIntent`](/documentation/Intents/INAddMediaIntent), that reflect interactions the user can perform directly in your app. > Tip: > In iOS 14 and later, you can set up handling for ``doc://com.apple.sirikit/documentation/Intents/INPlayMediaIntent`` directly in your app. To continue supporting earlier versions of iOS, resolve and confirm the intent in an extension, then respond with ``doc://com.apple.sirikit/documentation/Intents/INPlayMediaIntentResponseCode/continueInApp`` or ``doc://com.apple.sirikit/documentation/Intents/INPlayMediaIntentResponseCode/handleInApp`` so the system sends the intent to the app to play the media. Tell the system what types of media your app supports in Xcode’s Project editor. In the Supported Intents section of the Project editor, select each Media Category that describes your app’s content. Select `General` if your app plays media that doesn’t fit any of the other categories, like spooky sound effects or white noise. To opt in to Siri media control, you must choose at least one category for your app. With the settings shown here, users can say “Play some music in ControlAudio” to play music in the ControlAudio app. When App Selection is available, they can simply say “Play some music” and Siri intelligently picks the user’s preferred music app with App Selection.  When a user searches for a musician or band on iOS 15 or later, Spotlight may include a suggestion to start listening to content from that artist. To include your app in the list of apps available to listen on, support [`INSearchForMediaIntent`](/documentation/Intents/INSearchForMediaIntent). If the user chooses your app from the list, or if your app is the user’s preferred music app, the system sends your app an intent so you can display content by that artist. The system can also use your app’s [`INPlayMediaIntent`](/documentation/Intents/INPlayMediaIntent) donations to offer personalized audio suggestions on Lock Screen, in Control Center, and in the Home app. To opt-in to these suggestions, you need to explicitly indicate that your app can play media container intents with no additional parameters. If you haven’t already customized the PlayMedia system intent, follow these steps to set that up: 1. If your project doesn’t already have an `.intentDefinition` file, use File > New File and then choose SiriKit Intent Definition File to add one to your project. 2. Open your `.intentDefinition` file. 3. Choose Customize System Intent > Media > Play Media from the + menu at the bottom of the intent definition editor. Once you have the PlayMedia system intent in a SiriKit Intent Definition file, make sure that its list of Supported Combinations includes the entry with “mediaContainer” as the only parameter.  > Note: > The system offers the user audio suggestions based on donations the system can play in an audio-only situation. The system excludes the following media types when generating audio suggestions: ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/news``, ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/musicVideo``, ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/movie``, ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/tvShow``, ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/tvShowEpisode``, and ``doc://com.apple.sirikit/documentation/Intents/INMediaItemType/unknown``. ### Donate Interactions Improve App Selection, Shortcuts, and Shortcut Suggestions by donating interactions from your app. Each time the user starts playing media directly in your app, create and donate an [`INInteraction`](/documentation/Intents/INInteraction) containing an [`INPlayMediaIntent`](/documentation/Intents/INPlayMediaIntent) to tell the system what the user is listening to. Provide as much detail as possible in each donation to help the system interact more accurately with the user in the future. If the user starts a playlist or radio station, donate that information instead of each individual song. > Important: > Suggestions improve as the system accumulates donated interactions. If some media becomes irrelevant or unavailable, use ``doc://com.apple.sirikit/documentation/Intents/INInteraction/delete(with:completion:)-2d1gs`` to remove interactions associated with those specific media items. Don’t call ``doc://com.apple.sirikit/documentation/Intents/INInteraction/deleteAll(completion:)`` unless you really mean to reset what the system has learned about the way the user interacts with your app. ### Set the Current User Context When your app launches, create an [`INMediaUserContext`](/documentation/Intents/INMediaUserContext), add the user’s information, and make the context current. The system uses this information to optimize the user experience for App Selection. The following code listing shows how to set the current context for a user with a paid subscription and a few hundred items in their library: ```swift let context = INMediaUserContext() context.numberOfLibraryItems = 345 context.subscriptionStatus = .subscribed context.becomeCurrent() ``` ### Populate the Spotlight Database Add metadata about playlists and individual media items from the user’s local library to the Core Spotlight database. When the user searches for the item, the system can offer to play the media in your app alongside any other search results. For Swift, choose the level of protection for your Spotlight database so the system can access this information even when your app isn’t running. In Objective-C, choose the level of protection for your Spotlight database so the system can access this information even when your app isn’t running. ```swift let attributes = CSSearchableItemAttributeSet(contentType: .audio) attributes.title = "Some Cool Song Title" attributes.artist = "Hot New Artist" attributes.album = "Hot New Artist's Exclusive Album" attributes.genre = "Pop" attributes.playCount = 5 attributes.lastUsedDate = Date() let item = CSSearchableItem(uniqueIdentifier: "", domainIdentifier: domain, attributeSet: attributes) CSSearchableIndex.default().indexSearchableItems([item]) { ... } ``` > Warning: > If you need to delete items from the index, use . Calling deletes not only the searchable items you’ve added directly to the searchable index, but also every ``doc://com.apple.sirikit/documentation/Intents/INInteraction`` your app has donated or Siri has donated on behalf of your app. ### Define Relevant Vocabulary Define vocabulary for Siri, both specific to the individual user and relevant for all users but exclusive to your app. Providing vocabulary helps Siri match a user’s request to media items you’ve added to the Spotlight database or included in donated intents and interactions. Take care to include terms that include numbers or have other unusual spellings. There are two ways to provide vocabulary, and each one helps Siri interpret and route user requests: - Global vocabulary relevant to all users of your app. - User-specific vocabulary that you update as the user interacts with your app. Define general terms in the . Add an `AppIntentVocabulary.plist` file to your project and provide any vocabulary that’s unique to your app but relevant for all users in the section. For more details, see . Provide additional vocabulary programmatically with [`INVocabulary`](/documentation/Intents/INVocabulary), like names that are unique or particularly important to the user, such as playlist titles. Put terms that are most important for this user or that Siri most often misunderstands first. You should update the vocabulary as needed, such as when the user renames or deletes a playlist, or begins listening to a particular artist more frequently. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)