What problem does it solve?
Integrating Apple Music and audio recognition into apps is complex: developers must handle catalog search, library access, playback control, subscription checks, authorization flows, and optional ShazamKit matching while respecting platform availability and privacy requirements.
Core Features & Use Cases
- Catalog Search & Fetching: Build MusicCatalogSearchRequest and MusicCatalogResourceRequest flows to find songs, albums, artists, and charts.
- User Library Management: Query and modify the user's MusicLibrary with authorization-aware requests and sorting/filtering.
- Playback Control: Manage in-app playback with ApplicationMusicPlayer or control the system player via SystemMusicPlayer, including queue management and transport state handling.
- Subscription & UI Integration: Detect subscription status, present subscription offer sheets in SwiftUI, and render artwork with ArtworkImage.
- Audio Recognition with ShazamKit: Recognize live audio via SHSession/SHManagedSession, build SHCustomCatalogs for custom matching, and generate signatures with AVAudioEngine/SHSignatureGenerator.
- Privacy & Platform Notes: Includes guidance on required Info.plist keys, API availability across iOS/macos/watchOS/tvOS, and async/await usage patterns.
Quick Start
Use the musickit skill to search the Apple Music catalog for "Taylor Swift" songs and return playable Song objects.