Skip to content

Lecteur de musique

Le loading screen intègre un lecteur audio complet (play/pause, précédent/suivant, shuffle, boucle, volume, barre de progression cliquable) alimenté par la liste music de config/config.js.

Configuration

js
music: [
    {
        src: "/config/song/Cinematic.mp3",
        trackTitle: "Cinematic",
        duration: "1:49",
    },
    {
        src: "/config/song/Ya_Kuba_Karma.mp3",
        trackTitle: "Ya Kuba - Karma",
        duration: "2:15",
    },
    {
        src: "/config/song/French_Montana_-_Unforgettable.mp3",
        trackTitle: "French Montana - Unforgettable ft. Swae Lee",
        duration: "4:47",
    },
],

Chaque piste est un objet :

ChampDescription
srcChemin du fichier audio dans config/song/
trackTitleTitre affiché dans le lecteur
durationDurée au format M:SS (affichage)

Ajouter une musique

  1. Déposez votre fichier .mp3 dans config/song/.
  2. Ajoutez une entrée dans le tableau music.
  3. Le pattern config/song/* du fxmanifest.lua couvre déjà les nouveaux fichiers — pas besoin de modifier le manifeste.

TIP

Évitez les espaces dans les noms de fichiers (utilisez _ ou -).

Bon à savoir

  • Autoplay : les navigateurs bloquent souvent la lecture automatique avec son. Le script tente de débloquer l'audio à la première interaction ; un clic suffit à lancer la musique.
  • Ordre & shuffle : les pistes sont lues dans l'ordre du tableau, sauf si le bouton shuffle est activé.
  • Boucle : le bouton de boucle rejoue la piste courante en fin de lecture.
  • duration est purement informatif (affichage). La durée réelle de lecture vient du fichier audio lui-même.