Lecteur de musique

Dispatch.IO a deux lecteurs indépendants :

• Un seul lecteur à la fois par serveur : si une radio joue, /play est refusé, et inversement. Utilise /stop pour passer de l'un à l'autre.
• Gratuit : le lecteur est disponible sur tous les serveurs, sans offre Premium.
• Le bot rejoint ton salon vocal au premier /play, avec un volume de 100 %. Il se met en sourdine : il n'écoute pas ce qui se dit dans le salon.
• Pendant une maintenance du bot (mode récupération), la musique est indisponible : les commandes répondent par un message d'erreur.

La file d'attente contient les titres qui joueront après le titre en cours.

• /play lance le titre si rien ne joue, sinon l'ajoute à la fin de la file. Un lien de playlist ajoute tous ses titres.
• Le mode Jouer maintenant de /play place le titre en tête de file et passe directement dessus.
• /next (ou le bouton Suivant) passe au titre suivant ; /previous (ou Précédent) redémarre le titre en cours.
• /loop répète le titre en cours ou toute la file.
• /queue affiche la file (10 titres par page, avec la durée totale), la mélange ou la vide, et permet de sauter directement à un titre.

Quand le dernier titre se termine, la file est vide : le bot attend un nouveau /play sans quitter le salon vocal (voir plus bas).

Le message du lecteur est publié dans le salon où le premier /play a été tapé, et y reste pendant toute la session d'écoute. Il est écrit dans la langue du serveur.

1. Premier titre : le bot publie le message du lecteur : titre (cliquable vers sa source) et vignette, auteur, progression, volume, demandeur, nombre de titres en attente et état (« En lecture » ou « En pause »), puis quatre boutons : Précédent, Pause/Lecture, Suivant, Arrêter.
2. Pendant la lecture : le même message est modifié à chaque nouveau titre, à chaque pause ou reprise et quand la file change. La progression est celle du moment de la mise à jour : elle n'avance pas en direct.
3. Statut du salon vocal : quand la file change (ajout, mélange, vidage), le bot affiche le titre en cours comme statut du salon vocal. Il l'efface quand la file se termine ou que le lecteur s'arrête.
4. File terminée : le message reste, avec le titre « Inconnu » et des boutons grisés. Le bot reste dans le salon vocal.
5. Arrêt (/stop, bouton Arrêter, salon vocal vide, bot déconnecté) : le message du lecteur est supprimé.

• Les boutons fonctionnent pendant 1 heure à partir du début du titre en cours ; au-delà, utilise les commandes.
• Les confirmations des boutons (« La musique a été mise en pause par… ») sont publiques ; les messages d'erreur ne sont visibles que par toi.
• Si le salon du lecteur est un salon temporaire qui efface les messages, le message du lecteur est protégé et n'est pas effacé. Les autres réponses des commandes de musique, elles, sont effacées comme les autres messages.
• La confirmation de /play (« Musique ajoutée à la file d'attente ») disparaît d'elle-même au bout de 5 secondes.

Les commandes de musique sont ouvertes à tous les membres, sans permission Discord. Pour éviter qu'un membre coupe la musique d'un autre, le bot applique trois règles :

1. Être en vocal : /play et /play-radio demandent d'être dans un salon vocal.
2. Être dans le salon du bot : pour contrôler la lecture (pause, volume, file…), il faut être dans le même salon vocal que le bot.
3. La règle du demandeur : tant que la personne qui a demandé le titre en cours est dans le salon vocal du bot, elle seule peut le mettre en pause, le reprendre, le passer, revenir en arrière, le répéter ou utiliser les boutons du lecteur. Si elle a quitté le salon, n'importe quel membre du salon peut le faire.

Un membre qui a la permission Discord Administrateur n'est pas concerné par la règle du demandeur, et il peut utiliser Suivant, Arrêter, /next, /loop et /stop sans être dans le salon vocal.

Le tableau complet et les messages d'erreur sont sur la page Musique et radio.

1. Un membre tape /play-radio et choisit une station dans les suggestions.
2. Le bot rejoint son salon vocal, lance le flux et affiche le nom de la station comme statut du salon vocal.
3. Il répond « Joue maintenant : station » avec un bouton Arrêter la radio, utilisable seulement par la personne qui a lancé la radio. Tout membre du salon vocal du bot peut aussi l'arrêter avec /stop.
4. Quand la radio s'arrête (bouton, /stop, salon vocal vide, bot déconnecté, flux coupé), le message indique « La lecture de la radio a été arrêtée. » et son bouton est grisé.

/title affiche le nom de la station et /volume règle son volume.

Dans tous les cas d'arrêt, le message du lecteur est supprimé et le statut du salon vocal est effacé.

Le bot a aussi besoin de ses permissions de base, listées sur la page Permissions et rôles.

Les autres messages d'erreur sont expliqués sur la page Musique et radio.

• Musique et radio : chaque commande de musique en détail.
• Salons temporaires : salons où les messages s'effacent tout seuls.
• Permissions et rôles : les permissions du bot.
• Événements Discord : ce qui se passe quand un membre quitte un salon vocal.