Musique et radio

Ce qu'il te faut

1. Être dans un salon vocal. !play, !play-now et !play-radio font venir le bot dans ton salon vocal ; sans salon vocal, le bot répond « Vous devez être dans un salon vocal pour utiliser cette commande. ».
2. Rester dans le même salon que le bot pour contrôler la lecture (pause, volume, file d'attente…). Sinon : « Vous devez être dans le même salon vocal que moi pour utiliser cette commande. ». Le bot ne joue que dans un salon vocal à la fois par communauté : tant qu'il joue quelque part, !play tapé depuis un autre salon vocal reçoit ce même message.
3. Des permissions pour le bot dans le salon vocal : Voir le salon, Se connecter et Parler. S'il lui en manque une, le bot répond « Il me manque la permission Connect, Speak pour faire ça. » pendant 5 secondes.

Musique ou radio, pas les deux

La musique et la radio utilisent deux lecteurs différents qui ne peuvent pas tourner en même temps. Si une radio joue, !play répond « Je joue déjà une radio, veuillez d'abord l'arrêter. » ; si de la musique joue, !play-radio répond « Je joue déjà de la musique, veuillez d'abord l'arrêter. ». Utilise !stop pour passer de l'un à l'autre.

Arrêt automatique

Quand plus aucun membre n'est dans le salon vocal du bot (les bots ne comptent pas), la musique ou la radio s'arrête aussitôt et le bot quitte le salon. C'est aussi le cas si quelqu'un déconnecte le bot.

Après un redémarrage du bot

Si le bot redémarre (mise à jour, maintenance) pendant que de la musique joue, il la reprend tout seul à son retour : même salon vocal, même file d'attente, même position dans le titre, même volume, même boucle, et en pause si elle l'était. Il faut que le redémarrage dure moins de 10 minutes et que quelqu'un soit encore dans le salon vocal. Un nouveau message du lecteur est alors publié. Une radio, elle, ne reprend pas : relance-la avec !play-radio.

Pour éviter qu'un membre coupe la musique d'un autre, certaines actions sont réservées à la personne qui a demandé le titre en cours (le « demandeur »).

¹ Un membre qui a la permission Fluxer Administrateur peut utiliser !next, !loop, !stop et les réactions ⏭️ Suivant et ⏹️ Arrêter sans être dans le salon vocal.

La règle du demandeur : tant que le demandeur du titre en cours est dans le salon vocal du bot, lui seul (ou un membre avec la permission Administrateur) peut le contrôler. S'il a quitté le salon, tout le monde dans le salon peut le faire. Sinon, le bot répond « Vous n'êtes pas la personne qui a demandé cette musique, donc vous ne pouvez pas la contrôler. ».

!play cherche un titre (par son nom ou par un lien) et le lance, ou l'ajoute à la fin de la file d'attente si quelque chose joue déjà. Le bot rejoint ton salon vocal s'il n'y est pas encore, avec un volume de 100 %.

1. Rejoins un salon vocal.
2. Tape !play suivi du nom du titre ou d'un lien : !play Café Lo-Fi Session. Fluxer ne propose pas de suggestions pendant la saisie : le bot joue le premier résultat de la recherche. Ajoute le nom de l'artiste pour tomber juste.
3. Le bot confirme « Musique ajoutée à la file d'attente : titre ». Cette réponse disparaît après 5 secondes, avec ta commande.
4. Le message du lecteur apparaît dans le salon (ou se met à jour) dès que le titre démarre.

Ce que tu peux taper

Jouer tout de suite : !play-now

Sur Discord, /play a un mode « Jouer maintenant ». Sur Fluxer, c'est une commande à part, !play-now :

Comme !play-now coupe le titre en cours, il suit la règle du demandeur quand un titre joue.

Dès que le premier titre démarre, Dispatch.IO publie un message « lecteur » dans le salon où !play a été tapé la première fois. Ce même message est mis à jour à chaque nouveau titre, pause, reprise, changement de volume ou de file d'attente.

Les boutons en réactions

Fluxer n'a pas encore de boutons pour les bots : sous le message du lecteur, une ligne de légende (« ⏮️ Précédent · ⏸️ Pause · ▶️ Reprendre · ⏭️ Suivant · ⏹️ Arrêter ») et les mêmes emojis en réaction les remplacent. Clique sur une réaction pour « appuyer » : le bot la retire aussitôt, pour que tu puisses recliquer. Le bot peut afficher ses propres versions de ces emojis.

Les réactions suivent les mêmes règles que les commandes : elles sont réservées au demandeur du titre en cours. Si tu n'as pas le droit, le bot affiche la raison pendant 5 secondes dans le salon, avec ta mention. Les confirmations (« La musique a été mise en pause par … ») sont publiques. Les réactions marchent aussi longtemps que le message est celui du lecteur en cours, sans limite de durée. Le fonctionnement général des réactions est expliqué dans Boutons, formulaires et réponses sur Fluxer.

Pendant et après la lecture

• Titre illisible : si un titre ne peut pas être lu (supprimé, privé, indisponible), le bot l'indique quelques secondes dans le salon (« Impossible de lire titre : je passe à la suite. ») et lance le suivant.
• Coupure : si la lecture d'un titre est coupée en cours de route, le bot le relance là où il en était.
• File terminée : le message reste affiché avec le titre « Inconnu », sans légende ni réactions, et le bot reste connecté au salon vocal. Ajoute un titre avec !play.
• Message supprimé : si quelqu'un supprime le message du lecteur, le bot en publie un nouveau au titre suivant.
• Lecteur arrêté (!stop, réaction ⏹️, salon vocal vide) : le message du lecteur est supprimé.

!pause et !resume mettent en pause puis relancent le titre en cours. Le message du lecteur passe à l'état « En pause » ou « En lecture ». La radio, elle, ne peut pas être mise en pause : utilise !stop.

!next passe au titre suivant de la file d'attente. !previous dépend du moment où tu le tapes :

!loop active la lecture en boucle, soit du titre en cours, soit de toute la file d'attente.

!loop fonctionne comme un interrupteur : si une boucle est déjà active (quel que soit son mode), la commande la désactive. Pour passer d'un mode à l'autre, lance !loop une première fois pour désactiver, puis une seconde fois avec le nouveau mode.

!queue affiche la file d'attente, la mélange, la vide ou saute à un titre. Elle ne fonctionne qu'avec la musique (pas avec la radio), et il faut être dans le salon vocal du bot.

Quand la file tient sur plusieurs pages, le bot pose ◀️ ▶️ sous sa réponse : toi seul peux tourner les pages, pendant 5 minutes. Le numéro d'un titre est celui affiché dans la liste.

Mélanger, vider ou sauter à un titre change ce que tout le salon entend : ces trois actions suivent la règle du demandeur. L'affichage de la file est ouvert à tout le salon.

!play-radio lance une radio en direct dans ton salon vocal.

1. Rejoins un salon vocal (sans musique en cours).
2. Tape !play-radio suivi du nom de la station : !play-radio France Inter.
3. Le bot rejoint ton salon vocal, lance la radio et répond « Joue maintenant : France Inter », avec la légende ⏹️ Arrêter la radio et la réaction correspondante.

Trouver la station : Dispatch.IO connaît une trentaine de stations (NRJ, France Inter, franceinfo, FIP, Radio Nova, Skyrock, TSF Jazz, Lofi Radio…), les mêmes que la page Radios du lecteur du tableau de bord. Une partie du nom suffit quand elle désigne bien une station : !radio nova lance Radio Nova. Pour une station hors de cette liste, le bot la cherche dans un annuaire de radios en ligne avec le nom que tu as tapé.

La réaction ⏹️ Arrêter la radio ne fonctionne que pour la personne qui a lancé la radio ; celles des autres membres sont retirées sans effet. Tout membre du salon vocal du bot peut aussi l'arrêter avec !stop. Relancer !play-radio depuis le même salon vocal change de station (l'ancien message perd sa réaction). Quand la radio s'arrête (réaction, !stop, salon vocal vide, flux coupé plusieurs fois de suite), son message indique « La lecture de la radio a été arrêtée. » et sa réaction disparaît.

Pendant une radio, !title affiche son nom et !volume règle son volume. La radio ne se met pas en pause.

!title affiche ce qui joue : la fiche complète du titre pour la musique, ou le nom de la station pour une radio.

Pour la musique, la fiche reprend les informations du message du lecteur (titre, auteur, progression à jour, volume, demandeur, file d'attente, état) et ajoute un lien vers la source quand elle est reconnue : Écouter sur YouTube ou Écouter sur SoundCloud.

!volume règle le volume de la musique ou de la radio, de 0 à 100 %. Pour la musique, la ligne Volume du message du lecteur est mise à jour. Le réglage s'applique à tout le monde dans le salon vocal.

• Musique : le volume suit la règle du demandeur, comme !pause ou !next.
• Radio : tout membre du salon vocal du bot peut le régler.

!stop arrête ce qui joue et déconnecte le bot du salon vocal.

• Musique : suit la règle du demandeur ; un membre avec la permission Administrateur peut le faire de n'importe où. Le message du lecteur est supprimé et la file d'attente est perdue.
• Radio : n'importe quel membre du salon vocal du bot peut l'arrêter. Le message de la radio indique qu'elle a été arrêtée.

Pour d'autres soucis, consulte la page Dépannage.

• Lecteur de musique : le fonctionnement du module de musique et le lecteur du tableau de bord.
• Boutons, formulaires et réponses sur Fluxer : comment fonctionnent les réactions du bot.
• Permissions et rôles : les permissions dont le bot a besoin.
• Toutes les commandes : la liste complète des commandes.