# Audio Make your audio app’s actions available to Apple Intelligence and Siri by adopting schemas for common audio playback actions. ## Discussion The `.audio` domain defines app schemas that provide a structured representation for common audio playback actions and content. Apply schemas in the `.audio` domain to make your app’s audio functionality available to Apple Intelligence and Siri. The framework provides the types that describe a person’s audio search and playback request. Your app implements an [`IntentValueQuery`](/documentation/AppIntents/IntentValueQuery) to receive these types, find matching audio content, and return app entities. Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across audio apps. For example, a person can play a song on different apps that support the [`playAudio`](/documentation/AppIntents/AppSchema/AudioIntent/playAudio) schema with the same phrases. The following table maps example phrases that apply to each schema: |Audio intent schemas |Example phrases | |-------------------------------------------------------------------------------------------------|----------------------------------------------------------------------| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/playAudio`` |“Play music.” or “Play hip-hop in the living room.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/addToLibrary`` |“Follow this podcast.” or “Add this song to my library.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/addToPlaylist`` |“Add this song to my running playlist.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/createStation`` |“Create a station based on this song.” or “Play more music like this.”| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/recognizeAudio`` |“What song is this?” or “Shazam.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/AudioIntent/updateAudioAffinity``|“I like this song.” or “I don’t like this song.” | > Tip: Xcode generates a template implementation when you type `audio_` and select a schema from the suggestions list. For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai). ## Topics ### Essentials [Integrating your music app with Apple Intelligence](/documentation/AppIntents/integrating-your-music-app-with-apple-intelligence) Adopt the audio and clock schemas so people can play music and set alarms with Siri. ### Actions [`var addToLibrary: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/addToLibrary) An intent schema that adds an audio item to the person’s library. [`var addToPlaylist: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/addToPlaylist) An intent schema that adds an audio item to a playlist. [`var createStation: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/createStation) An intent schema that starts a station based on the now-playing item. [`var playAudio: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/playAudio) An intent schema that plays an audio item. [`var recognizeAudio: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/recognizeAudio) An intent schema that finds out what audio is playing nearby. [`var updateAudioAffinity: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/updateAudioAffinity) An intent schema that sets the like state of an audio item to liked, unliked, or unset. [`var warmupAudioQueue: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/AudioIntent/warmupAudioQueue) An intent schema that warms up an audio item by setting the queue without starting playback. [`protocol AudioIntent`](/documentation/AppIntents/AppSchema/AudioIntent) Identifies intent schemas in the audio domain. ### Content and parameter types [`var album: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/album) An entity schema for an album. [`var algorithmicRadioStation: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/algorithmicRadioStation) An entity schema for an algorithmic radio station. [`var ambientSound: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/ambientSound) An entity schema for an ambient sound. [`var artist: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/artist) An entity schema for an artist. [`var audiobook: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/audiobook) An entity schema for an audiobook. [`var classicalMusicRecording: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/classicalMusicRecording) An entity schema for a classical music recording. [`var liveRadioStation: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/liveRadioStation) An entity schema for a live radio station. [`var newsBrief: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/newsBrief) An entity schema for news brief. [`var newsProvider: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/newsProvider) An entity schema for news provider. [`var playlist: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/playlist) An entity schema for a playlist. [`var podcastCollection: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/podcastCollection) An entity schema for a podcast collection. [`var podcastEpisode: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/podcastEpisode) An entity schema for a podcast episode. [`var podcastShow: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/podcastShow) An entity schema for a podcast show. [`var radioShow: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/radioShow) An entity schema for a radio show. [`var radioShowEpisode: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/radioShowEpisode) An entity schema for a radio show episode. [`var song: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/song) An entity schema for a song. [`var songCollection: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/songCollection) An entity schema for a song collection. [`var warmupAudioQueueResult: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/AudioEntity/warmupAudioQueueResult) An entity schema for a warmup audio queue result. [`protocol AudioEntity`](/documentation/AppIntents/AppSchema/AudioEntity) Identifies entity schemas in the audio domain. ### Types for static parameters [`var activity: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/activity) An enum schema for an activity parameter. [`var affinityState: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/affinityState) An enum schema for an affinity state parameter. [`var appViewIdentifier: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/appViewIdentifier) An enum schema for an app view identifier parameter. [`var invocationSource: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/invocationSource) An enum schema for an invocation source parameter. [`var playbackAttributes: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/playbackAttributes) An enum schema for a playback attributes parameter. [`var queueInsertionLocation: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/AudioEnum/queueInsertionLocation) An enum schema for a queue insertion location parameter. [`protocol AudioEnum`](/documentation/AppIntents/AppSchema/AudioEnum) Identifies enum schemas in the audio domain. --- 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)