Construire un lecteur de musique personnalisé haute performance pour iOS

Le développement d'un lecteur musical personnalisé pour iOS va bien au-delà de l'enveloppage dans un bouton de lecture. Les utilisateurs s'attendent à une lecture transparente de fond, une intégration riche et maintenant en lecture, un support AirPlay et des contrôles réactifs qui se sentent natifs. Ce guide vous guide à travers la création d'un lecteur musical prêt à la production avec des commandes avancées utilisant Swift, UIKit, et des cadres modernes comme .

Architecture de base: Tirer parti de la Fondation AV

Chaque lecteur de musique personnalisé dans iOS commence par AVFoundation. Les classes de lecteur principal sont (pour le streaming et les fichiers locaux) et (pour la lecture audio locale plus simple). Pour un lecteur à haute définition, AVPlayer est le meilleur choix car il prend en charge le streaming, les métadonnées chronométrées et l'intégration avec AirPlay et les modes de fond.

Configuration de l'instance du joueur

Créez une classe de service ou de singleton qui détient l'instance . Cela garantit un état de lecture persistant sur les contrôleurs de vue. Configurez le lecteur avec une URL locale ou distante :

import AVFoundation

class MusicPlayerManager {
 static let shared = MusicPlayerManager()
 let player: AVPlayer

 private init() {
 player = AVPlayer()
 configureAudioSession()
 }

 func play(url: URL) {
 let item = AVPlayerItem(url: url)
 player.replaceCurrentItem(with: item)
 player.play()
 }
}

Toujours définir la catégorie de session audio à . playback[ afin que le lecteur continue à fonctionner lorsque le téléphone est verrouillé ou en mode silencieux. Ceci est obligatoire pour toute application musicale.

Gestion des États joueurs

Utilisez KVO (Key-Value Observing) sur S et S pour réagir aux changements d'état de lecture (jouer, faire une pause, attendre le réseau).

Conception de l'interface utilisateur avec SwiftUI

Alors que UIKit est mature, SwiftUI offre une itération plus rapide et une syntaxe déclarative parfaite pour les UIs de lecteur de musique. Créez une mise en page propre avec l'art d'album, les informations de piste, le curseur de progression, le contrôle du volume et les boutons de lecture.

Composantes clés de l'assurance-chômage

  • Album Art View[ – un qui charge des œuvres d'art à partir d'une URL distante ou d'un atout local.
  • Track and Artist Labels – texte dynamique qui met à jour les propriétés dans votre modèle de vue.
  • Progress Slider – une coutume avec des couleurs de piste et de pouce, liée à l'heure actuelle du joueur.
  • Volume Slider – utilisez lors du ciblage du volume du système, ou construisez un curseur personnalisé qui définit (note : le volume du système est préféré pour la cohérence).
  • Jouer/Pause, Dos, Boutons de recul – clairement étiqueté, avec une rétroaction haptique sur le toucher.

Utilisez un pour s'adapter à différentes tailles d'écran, en particulier pour l'album art qui devrait s'adapter à la bonne échelle sur les iPads.

Connexion de l'interface utilisateur au joueur

Laissez votre modèle de vue se conformer à et publiez la piste, le temps de lecture et l'état de lecture. La vue SwiftUI observe ceci:

class PlayerViewModel: ObservableObject {
 @Published var currentTime: TimeInterval = 0
 @Published var isPlaying = false
 @Published var currentTrack: Track?

 // … bindings to MusicPlayerManager
}

Utiliser et ou l'observateur périodique du temps pour mettre à jour en douceur.

Intégration de la télécommande et maintenant Lecture des informations

Un lecteur de musique professionnel doit répondre aux événements de télécommande (écran de verrouillage, centre de commande, Apple Watch, AirPods) et afficher -[Maintenant Lecture d'info. Ceci est fait via MPNowPlayingInfoCenter et MPRemoteCommandCenter.

Configuration des commandes à distance

Dans ou votre gestionnaire de lecteur, configurer le centre de commande distant après l'activation de la session audio:

import MediaPlayer

func setupRemoteCommands() {
 let commandCenter = MPRemoteCommandCenter.shared()

 commandCenter.playCommand.addTarget { [weak self] _ in
 self?.player.play()
 return .success
 }

 commandCenter.pauseCommand.addTarget { [weak self] _ in
 self?.player.pause()
 return .success
 }

 commandCenter.nextTrackCommand.addTarget { [weak self] _ in
 self?.skipToNext()
 return .success
 }

 commandCenter.previousTrackCommand.addTarget { [weak self] _ in
 self?.skipToPrevious()
 return .success
 }

 commandCenter.changePlaybackPositionCommand.addTarget { [weak self] event in
 guard let event = event as? MPChangePlaybackPositionCommandEvent else { return .commandFailed }
 self?.player.seek(to: CMTime(seconds: event.positionTime, preferredTimescale: 1000))
 return .success
 }
}

Activer les modes de fond dans votre projet Xcode : sélectionnez la cible, allez dans Signing & Capabilities, ajoutez --Modes Background, et vérifiez --Audio, AirPlay et Image dans Picture.

Mise à jour des informations

Chaque fois que la piste change ou que la lecture est mise à jour, appelez avec un dictionnaire contenant des clés comme , , , et . Pour les oeuvres d'art, convertissez votre en .

Gestion de l'audio de fond avec les sessions audio

Configurez la session audio une fois au lancement :

func configureAudioSession() {
 do {
 let session = AVAudioSession.sharedInstance()
 try session.setCategory(.playback, mode: .default, policy: .longFormAudio)
 try session.setActive(true)
 } catch {
 print("Failed to set audio session: \(error)")
 }
}

Pour les applications qui enregistrent ou utilisent également la voix, soyez prudent avec la catégorie. Les lecteurs de musique devraient presque toujours utiliser pour assurer la continuité audio en arrière-plan. Tester sur un appareil : verrouiller l'écran et vérifier la lecture continue; le centre de contrôle devrait afficher votre carte --Maintenant Lecture.

Mise en œuvre de contrôles avancés: Equalizer, Playlists et AirPlay

Une fois les bases fonctionnent, différenciez votre joueur avec des fonctionnalités avancées.

Égaliseur graphique

Utilisez avec pour appliquer un égaliseur personnalisé ou 10 bandes. Il faut donc remplacer par une approche basée sur le moteur ou connecter un au moteur. La documentation Apples sur fournit un code d'exemple.

Gestion des listes de lecture

Conservez les listes de lecture dans les données de base ou les données Swift. Chaque liste de lecture contient une liste ordonnée des URL de piste (locale ou distante). Implémentez la réorganisation de glisser-déposer dans un ou .

AirPlay et appareils externes

prend automatiquement en charge AirPlay lorsque la session audio est réglée à et que le parcours est disponible. Pour un contrôle à grain fin, utilisez S route picking ou (iOS 11+).

Essais et optimisation des performances

Les lecteurs de musique doivent être réactifs. Suivez ces conseils pour garder l'application rapide et facile à utiliser.

  • Profil avec Instruments – utilisez les instruments Time Profiler et Core Animation pour détecter les blocages de fils principaux. Évitez les mises à jour lourdes de l'interface utilisateur sur chaque cadre; les mises à jour de curseurs d'accélérateur à ~30 FPS.
  • Stratégie de tampon[ – défini sur pour équilibrer l'utilisation du temps de démarrage par rapport à la mémoire. Une valeur de 10 secondes fonctionne pour la plupart des flux.
  • Gestion des souvenirs – lors du changement de pistes, relâchez les anciens éléments du lecteur et les images d'art. Utilisez pour l'album art.
  • Contexte de la manipulation de la casse – assurez-vous que votre gestionnaire de lecteur ne traite pas pendant le jeu. Utilisez des références fortes et réinitialisez si nécessaire.

Essais sur des appareils réels

Les simulateurs ne peuvent pas tester avec précision l'audio de fond, AirPlay, ou le contrôle du volume. Toujours tester sur les iPhones physiques et iPads utilisant différentes versions iOS. Vérifier que le centre de contrôle met à jour correctement et que l'écran de verrouillage affiche l'art de l'album.

Meilleures pratiques pour le développement de lecteurs de musique iOS

En s'inspirant d'années d'expérience de production, voici des recommandations supplémentaires.

  • Optimiser les performances – utiliser le chargement paresseux pour les grandes playlists et pré-décoder l'œuvre à la taille des vignettes.
  • Concevoir une interface utilisateur intuitive – suivre les lignes directrices sur l'interface humaine d'Apple pour la lecture des médias.
  • Interruptions de la poignée gracieusement – écoutez et faites une pause/résumer en conséquence.
  • Respecter la confidentialité de l'utilisateur – demander la permission du microphone uniquement si vous en avez vraiment besoin (p. ex., commandes vocales).
  • Provide accessibility[ – label tous les boutons, support VoiceOver, et adopte un type dynamique pour les étiquettes.

Conclusion

En utilisant AVFoundation[, MPNowPlayingInfoCenter[, et SwiftUI[, vous pouvez créer une application qui offre une expérience d'écoute polie. Commencez par le lecteur central, ajoutez la lecture de fond, puis couchez sur des fonctionnalités comme les égaliseurs et les playlists. Testez attentivement sur les appareils réels, et votre lecteur de musique se démarquera dans un marché bondé.

Pour plus de détails, explorez Apples AVFoundation Media Playback documentation[, le MediaPlayer framework reference[, et le Audio Interruptions guide[.Ces ressources vous aideront à gérer les boîtiers de bord et à fournir un produit robuste.