<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/AppSchema/AudioIntent/updateAudioAffinity",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "App Intents",
      "AppIntents"
    ],
    "preciseIdentifier" : "s:10AppIntents0A6SchemaV11AudioIntentPAAE06updateD8AffinityQrvp"
  },
  "title" : "updateAudioAffinity"
}
-->

# updateAudioAffinity

An intent schema that sets the like state of an audio item to liked, unliked, or unset.

```
var updateAudioAffinity: some AppSchemaIntent { get }
```

## Discussion

To make your app’s actions available to Apple Intelligence,
conform your [`AppIntent`](/documentation/AppIntents/AppIntent) to a schema that describes your action to the system.
If your app’s functionality aligns with the `audio` domain
and one of your app’s actions matches the `updateAudioAffinity` schema,
you can generate the properties and protocol conformance the schema requires
for your intent implementation
with the `@AppIntent( .audio.updateAudioAffinity)` Swift macro.
To make your app work with Siri,
see <doc://com.apple.documentation/documentation/AppIntents/apple-intelligence-and-siri-ai>.

The following example shows an intent that conforms to the `updateAudioAffinity` schema:

```swift
@AppIntent(schema: .audio.updateAudioAffinity)
struct UpdateAudioAffinityIntent {
    var affinityState: <#AffinityState#>
    var target: <#AudioItem#>

    func perform() async throws -> some IntentResult {
        <#code#>
    }
}
```

Define a `@UnionValue` enumeration for the `target` parameter, as in the following example,
by typing the first few characters of `audio_audioItem` in Xcode and selecting it from the code-completion suggestions.

```swift
@UnionValue
enum AudioItem {
    case song(<#SongEntity#>)
    case album(<#AlbumEntity#>)
    case artist(<#ArtistEntity#>)
    case playlist(<#PlaylistEntity#>)
    case songCollection(<#SongCollectionEntity#>)
    case classicalMusicRecording(<#ClassicalMusicRecordingEntity#>)
    case liveRadioStation(<#LiveRadioStationEntity#>)
    case algorithmicRadioStation(<#AlgorithmicRadioStationEntity#>)
    case radioShowEpisode(<#RadioShowEpisodeEntity#>)
    case radioShow(<#RadioShowEntity#>)
    case podcastShow(<#PodcastShowEntity#>)
    case podcastEpisode(<#PodcastEpisodeEntity#>)
    case podcastCollection(<#PodcastCollectionEntity#>)
    case audiobook(<#MediaBookEntity#>)
    case ambientSound(<#AmbientSoundEntity#>)
    case newsBrief(<#NewsBriefEntity#>)
    case newsProvider(<#NewsProviderEntity#>)
}
```

> Tip: Keep the cases that your app supports and remove the rest.

The schema supports the following system experiences:

- Siri
- Shortcuts

For more information about the App Intents framework and the experiences it supports,
see <doc://com.apple.documentation/documentation/AppIntents/getting-started-with-the-app-intents-framework>.

---

Copyright &copy; 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)