Lecteur de musique

Dispatch.IO a deux lecteurs indépendants :

• Un seul lecteur à la fois par communauté, dans un seul salon vocal : si une radio joue, !play est refusé, et inversement. Utilise !stop pour passer de l'un à l'autre.
• Gratuit : les commandes de musique et de radio marchent dans toutes les communautés, sans offre Premium. Seul le lecteur du tableau de bord est un avantage Premium.
• Le bot rejoint ton salon vocal au premier !play, avec un volume de 100 %.
• Succès : quand les succès sont activés, chaque titre lancé compte pour la catégorie Musique du membre qui l'a demandé (Première note, Mélomane…) et pour le succès de communauté Juke-box.

Ce qui change par rapport à Discord

Le lecteur a les mêmes fonctions que sur Discord, adaptées à ce que Fluxer permet aux bots :

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.
• !play-now place le titre en tête de file et passe directement dessus.
• !next (ou la réaction ⏭️) passe au titre suivant ; !previous (ou ⏮️) redémarre le titre en cours, ou rejoue le titre précédent dans les 10 premières secondes.
• !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) ; !queue shuffle la mélange, !queue clear la vide et !queue <numéro> saute 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 de la communauté.

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 »). Dessous, une ligne de légende et cinq réactions : ⏮️ Précédent, ⏸️ Pause, ▶️ Reprendre, ⏭️ Suivant, ⏹️ Arrêter.
2. Pendant la lecture : le même message est modifié à chaque nouveau titre, à chaque pause ou reprise, quand le volume change et quand la file change. La progression est celle du moment de la mise à jour : elle n'avance pas en direct.
3. File terminée : le message reste, avec le titre « Inconnu », sans légende ni réactions. Le bot reste dans le salon vocal.
4. Arrêt (!stop, réaction ⏹️, salon vocal vide, bot déconnecté) : le message du lecteur est supprimé.

• Clique sur une réaction pour « appuyer » : le bot la retire aussitôt, pour que tu puisses recliquer. Les réactions marchent aussi longtemps que le message est celui du lecteur en cours.
• Les confirmations (« La musique a été mise en pause par… ») sont publiques ; un refus s'affiche 5 secondes dans le salon, avec la mention du membre concerné.
• Si le message du lecteur est supprimé, le bot en publie un nouveau au titre suivant. C'est ce qui se passe dans un salon textuel temporaire : le message du lecteur y est effacé comme les autres après le délai du salon. Lance plutôt la musique depuis un salon ordinaire.
• La confirmation de !play (« Musique ajoutée à la file d'attente ») disparaît d'elle-même au bout de 5 secondes, avec ta commande.

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

1. Être en vocal : !play, !play-now 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, changer le volume, modifier la file, l'arrêter ou utiliser les réactions du lecteur. Si elle a quitté le salon, n'importe quel membre du salon peut le faire.

Un membre qui a la permission Fluxer 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.

Quand la file est terminée, il n'y a plus de demandeur : tout le monde dans le salon peut gérer le lecteur (!stop pour faire partir le bot, !previous pour relancer le dernier titre). Relance un titre avec !play, ou laisse le bot partir quand le salon se vide. Le tableau complet et les messages d'erreur sont sur la page Musique et radio.

1. Un membre tape !play-radio suivi du nom de la station (ou d'une partie : !radio nova).
2. Le bot rejoint son salon vocal et lance le flux.
3. Il répond « Joue maintenant : station » avec une réaction ⏹️ 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. Un nouveau !play-radio depuis le même salon vocal change de station.
5. Quand la radio s'arrête (réaction, !stop, salon vocal vide, bot déconnecté, flux coupé plusieurs fois de suite), le message indique « La lecture de la radio a été arrêtée. » et sa réaction disparaît.

Si le flux coupe, le bot le relance tout seul plusieurs fois avant d'abandonner. !title affiche le nom de la station et !volume règle son volume ; la radio n'a ni file d'attente ni pause.

Dans tous les cas d'arrêt, le message du lecteur est supprimé.

En plus des commandes, tu peux suivre et piloter la musique depuis le site : page Lecteur de musique du tableau de bord (fluxer.dispatchio.xyz/dashboard/music), accessible depuis la barre latérale.

• Il suit ton salon vocal : rejoins un salon vocal dans une communauté où Dispatch.IO est présent, et la page se met à jour toute seule. Si le bot n'est pas encore dans ton salon, lance un titre : il le rejoint.
• En direct : le titre en cours avec sa pochette, sa progression et le nombre d'auditeurs, mis à jour en temps réel.
• Contrôles : lecture, pause, précédent, suivant, répétition, mélange, volume, arrêt.
• File partagée : tout le salon voit la même file. Tu peux chercher des titres et les jouer maintenant, ensuite ou à la fin de la file, monter, descendre ou retirer un titre, vider la file ou l'enregistrer en playlist.
• Radios : les stations du catalogue, classées par genre, à lancer d'un clic.
• Ta bibliothèque : crée tes playlists (jusqu'à 50, de 500 titres chacune), like les titres que tu aimes et rejoue-les dans n'importe quel salon.

Le site applique les mêmes règles que les commandes : il faut être dans le salon vocal du bot, et la règle du demandeur s'applique aux contrôles. Les liens YouTube y sont aussi refusés.

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.
• Boutons, formulaires et réponses sur Fluxer : comment fonctionnent les réactions du bot.
• Salons temporaires : salons où les messages s'effacent tout seuls.
• Succès : les succès de la catégorie Musique.
• Offres Premium et limites : les offres qui incluent le lecteur du tableau de bord.
• Permissions et rôles : les permissions du bot.