Documentazione BeatraPrimi Passi

Primi Passi

Guida completa all'uso del bot musicale Discord Beatra. Dalla configurazione di base alle funzionalità avanzate.

# Avvio Rapido

Aggiungi Beatra al tuo server Discord e inizia a riprodurre musica in pochi minuti.

1
Apri il link di invito, scegli il tuo server Discord e approva le autorizzazioni richieste.
2
Unisciti a un canale vocale, quindi esegui /play con il nome di un brano, un collegamento a una playlist o qualsiasi URL musicale supportato.
3
Controlla la sessione insieme a /queue, /skip, /jump, /loop, /shuffle e /volume. Il volume sale al 100% sul piano gratuito, al 1000% su Premium e al 2000% su Premium Plus.
4
Salva ciò che ti piace: /playlist apre un hub di pulsanti in cui crei playlist e aggiungi la traccia in riproduzione e il messaggio in riproduzione ha un pulsante "Aggiungi alla playlist".
5
Apri beatra.app/dashboard per impostare i ruoli del DJ, i canali bot consentiti, il prefisso dei comandi, la lingua e l'uscita automatica e per controllare la riproduzione dal browser senza digitare comandi.
6
Tieni traccia di ciò che ascolti: /profile per le tue statistiche, /leaderboard per le classifiche globali e del server e /summary per un riepilogo condivisibile.

# Prima di iniziare

Beatra necessita di Connect, Speak, Use Voice Activity, Send Messages, Embed Links e Use Application Commands. Il pulsante di invito concede Administrator per una configurazione con un clic: puoi deselezionarlo e concedere invece solo quelle autorizzazioni.
Unisciti a un canale vocale prima di eseguire comandi musicali. I comandi di riproduzione, salta, volume ed effetti leggono tutti il canale in cui ti trovi.
Utilizza i comandi barra in un canale di testo dove Beatra può leggere e rispondere. Se il server limita Beatra a determinati canali, i comandi altrove vengono rifiutati con un puntatore a quelli consentiti.
Le impostazioni del server (ruolo DJ, canali consentiti, prefisso, lingua, uscita automatica) richiedono l'autorizzazione Manage Server o un ruolo DJ autorizzato.
Gli account gratuiti votano una volta ogni 12 ore per continuare a utilizzare i comandi musicali. Qualsiasi Premium (personale, server o team) rimuove completamente questo passaggio.
I comandi del prefisso sono facoltativi: ogni comando funziona anche come comando di testo con il prefisso del server (predefinito!), ad es. !play invece di /play.

# Comandi barra e comandi prefisso

Ogni comando Beatra esiste due volte: come comando barra (/play) e come comando di testo utilizzando il prefisso del server (!play). Sono lo stesso comando con le stesse autorizzazioni e limiti.
Il prefisso predefinito è ! e può essere modificato in qualsiasi carattere da 1 a 5 con /prefix o dal dashboard. Manage Server è obbligatorio.
I comandi prefisso accettano argomenti dopo uno spazio anziché in una forma: !play nome del brano, !volume 80, !jump 5, coda !loop, !247 abilita.
Gli alias brevi esistono solo nel modulo del prefisso: !np per giocare adesso, !q per la coda, !lb per la classifica, !fx per gli effetti, !pn per giocare dopo, !dc per disconnettersi.
Chiamati senza argomenti, i comandi che hanno menu (!loop, !effect, !playlist, !radio) aprono gli stessi menu di pulsanti delle versioni slash.

# Flusso di lavoro musicale principale

Gioca tramite ricerca

/play Daft Punk One More Time

Cerca prima nel catalogo verificato dall'ISRC di Beatra, poi nelle fonti esterne e avvia la riproduzione nel tuo canale vocale. Se qualcosa è già in riproduzione, la traccia viene invece messa in coda.

Riproduci tramite URL

/play https://open.spotify.com/track/...

YouTube, YouTube Music, Spotify, Apple Music, Deezer, Tidal, SoundCloud, Qobuz, Audius e i collegamenti audio diretti si risolvono tutti attraverso lo stesso motore. I collegamenti ad album, playlist e artisti vengono caricati in blocco.

Scegli dai risultati di ricerca

/search imagine dragons

Restituisce un elenco selezionabile invece di riprodurre automaticamente il primo risultato: il modo più sicuro per ottenere il caricamento esatto che intendevi.

Metti in coda qualcosa dopo

/playnext bohemian rhapsody

Mette una traccia in cima alla coda in modo che venga riprodotta subito dopo quella corrente, senza cancellare nulla.

Riproduci una playlist Beatra

/play https://beatra.app/playlist/<id>

Passa il collegamento della playlist o il suo ID a /play: l'intera playlist viene caricata in coda. Le playlist non vengono aperte per nome: il collegamento o l'ID le identifica.

Gestisci playlist

/playlist

Apre l'hub della playlist: crea, sfoglia, rinomina, elimina, metti mi piace e salva, il tutto con pulsanti e moduli pop-up. Non sono presenti sottocomandi e !playlist apre lo stesso hub.

Guida la coda

/queue 2 → /jump 7 → /shuffle

Sfoglia la coda, salta direttamente a una posizione o randomizza l'ordine. /clear svuota la coda senza interrompere la traccia corrente.

Metti in loop una traccia o l'intera coda

/loop queue

Le modalità sono disattivate, traccia e coda. Chiamato senza modalità, il comando mostra un menu di pulsanti.

Applicare un effetto audio

/effect

Apre il menu preimpostato: potenziamento dei bassi, nightcore, vaporwave, 8D, karaoke, tremolo, vibrato, soft o nessuno per cancellare. Gli account gratuiti ricevono un cambio di effetto pari a 1 al giorno; Premium è illimitato.

Leggi insieme ai testi

/lyrics

Mostra i testi sincronizzati nel tempo per la traccia corrente dove esistono e i testi semplici dove non esistono. Il web player ha una scheda dei testi che scorre automaticamente.

Fai andare avanti la musica da sola

/autoplay lofi

Quando la coda si esaurisce, Beatra continua a riprodurre i brani correlati dal suo motore di consigli. Una discussione di genere guida l'atmosfera; senza uno segue ciò che hai ascoltato.

Ascolta la radio in diretta

/radio

Sfoglia e ascolta in streaming le stazioni radio Internet per nome, genere o paese: un'alternativa continua alla coda.

Rimani nel canale 24/7

/247 enable lofi

Premium mantiene Beatra connesso e in riproduzione continua, anche quando nessuno è in coda. Passa un genere o l'URL di una playlist per scegliere cosa riprodurre.

Sistema il bot con la modalità AFK

/afk

Premium tiene Beatra in un canale vocale a tua scelta. Non esce mai da solo, torna dopo un riavvio e rientra due minuti dopo la fine della musica.

Modificare la velocità di riproduzione

/speed 1.25

Premium, solo DJ o amministratore. Accetta da 0,25× a 3×; 1 lo reimposta.

Configura il server

/settings

Un pannello per il ruolo del DJ, canali bot consentiti, prefisso, lingua e uscita automatica. Richiede Manage Server. Le stesse impostazioni si trovano su beatra.app/dashboard.

Controlla la riproduzione dal browser

beatra.app/dashboard → your server

Il pannello del server rispecchia il lettore Discord: riproduci, metti in pausa, salta, cerca, riordina o rimuovi elementi in coda, modifica volume, loop ed effetti: nessun comando digitato.

Ascolta invece nel browser

beatra.app/dashboard/web-player

Un player autonomo con la propria coda, indipendente da Discord: cerca, incolla qualsiasi collegamento supportato, carica le tue playlist, leggi i testi e guarda il visualizzatore.

Guarda cosa hai ascoltato

/profile · /summary · /leaderboard

Statistiche personali, riepilogo condivisibile, server e classifiche globali. Tutto è anche sul sito web, nella pagina del tuo profilo e su beatra.app/summary.

Riprodurre un’intera playlist

/play-playlist

Apre un selettore: le tue playlist, una ricerca pubblica o un link da un’altra piattaforma. Funziona anche senza nulla in riproduzione.

# Avvio Rapido

Aggiungi Beatra al tuo server Discord e inizia a riprodurre musica in pochi minuti.

Apri il link di invito, scegli il tuo server Discord e approva le autorizzazioni richieste.

Unisciti a un canale vocale, quindi esegui /play con il nome di un brano, un collegamento a una playlist o qualsiasi URL musicale supportato.

Controlla la sessione insieme a /queue, /skip, /jump, /loop, /shuffle e /volume. Il volume sale al 100% sul piano gratuito, al 1000% su Premium e al 2000% su Premium Plus.

Salva ciò che ti piace: /playlist apre un hub di pulsanti in cui crei playlist e aggiungi la traccia in riproduzione e il messaggio in riproduzione ha un pulsante "Aggiungi alla playlist".

Apri beatra.app/dashboard per impostare i ruoli del DJ, i canali bot consentiti, il prefisso dei comandi, la lingua e l'uscita automatica e per controllare la riproduzione dal browser senza digitare comandi.

Tieni traccia di ciò che ascolti: /profile per le tue statistiche, /leaderboard per le classifiche globali e del server e /summary per un riepilogo condivisibile.

# Prima di iniziare

Beatra necessita di Connect, Speak, Use Voice Activity, Send Messages, Embed Links e Use Application Commands. Il pulsante di invito concede Administrator per una configurazione con un clic: puoi deselezionarlo e concedere invece solo quelle autorizzazioni.

Unisciti a un canale vocale prima di eseguire comandi musicali. I comandi di riproduzione, salta, volume ed effetti leggono tutti il canale in cui ti trovi.

Utilizza i comandi barra in un canale di testo dove Beatra può leggere e rispondere. Se il server limita Beatra a determinati canali, i comandi altrove vengono rifiutati con un puntatore a quelli consentiti.

Le impostazioni del server (ruolo DJ, canali consentiti, prefisso, lingua, uscita automatica) richiedono l'autorizzazione Manage Server o un ruolo DJ autorizzato.

Gli account gratuiti votano una volta ogni 12 ore per continuare a utilizzare i comandi musicali. Qualsiasi Premium (personale, server o team) rimuove completamente questo passaggio.

I comandi del prefisso sono facoltativi: ogni comando funziona anche come comando di testo con il prefisso del server (predefinito!), ad es. !play invece di /play.

# Comandi barra e comandi prefisso

Ogni comando Beatra esiste due volte: come comando barra (/play) e come comando di testo utilizzando il prefisso del server (!play). Sono lo stesso comando con le stesse autorizzazioni e limiti.

Il prefisso predefinito è ! e può essere modificato in qualsiasi carattere da 1 a 5 con /prefix o dal dashboard. Manage Server è obbligatorio.

I comandi prefisso accettano argomenti dopo uno spazio anziché in una forma: !play nome del brano, !volume 80, !jump 5, coda !loop, !247 abilita.

Gli alias brevi esistono solo nel modulo del prefisso: !np per giocare adesso, !q per la coda, !lb per la classifica, !fx per gli effetti, !pn per giocare dopo, !dc per disconnettersi.

Chiamati senza argomenti, i comandi che hanno menu (!loop, !effect, !playlist, !radio) aprono gli stessi menu di pulsanti delle versioni slash.

# Flusso di lavoro musicale principale

Gioca tramite ricerca

/play Daft Punk One More Time

Riproduci tramite URL

/play https://open.spotify.com/track/...

Scegli dai risultati di ricerca

/search imagine dragons

Restituisce un elenco selezionabile invece di riprodurre automaticamente il primo risultato: il modo più sicuro per ottenere il caricamento esatto che intendevi.

Metti in coda qualcosa dopo

/playnext bohemian rhapsody

Mette una traccia in cima alla coda in modo che venga riprodotta subito dopo quella corrente, senza cancellare nulla.

Riproduci una playlist Beatra

/play https://beatra.app/playlist/<id>

Passa il collegamento della playlist o il suo ID a /play: l'intera playlist viene caricata in coda. Le playlist non vengono aperte per nome: il collegamento o l'ID le identifica.

Gestisci playlist

/playlist

Apre l'hub della playlist: crea, sfoglia, rinomina, elimina, metti mi piace e salva, il tutto con pulsanti e moduli pop-up. Non sono presenti sottocomandi e !playlist apre lo stesso hub.

Guida la coda

/queue 2 → /jump 7 → /shuffle

Sfoglia la coda, salta direttamente a una posizione o randomizza l'ordine. /clear svuota la coda senza interrompere la traccia corrente.

Metti in loop una traccia o l'intera coda

/loop queue

Le modalità sono disattivate, traccia e coda. Chiamato senza modalità, il comando mostra un menu di pulsanti.

Applicare un effetto audio

/effect

Leggi insieme ai testi

/lyrics

Mostra i testi sincronizzati nel tempo per la traccia corrente dove esistono e i testi semplici dove non esistono. Il web player ha una scheda dei testi che scorre automaticamente.

Fai andare avanti la musica da sola

/autoplay lofi

Quando la coda si esaurisce, Beatra continua a riprodurre i brani correlati dal suo motore di consigli. Una discussione di genere guida l'atmosfera; senza uno segue ciò che hai ascoltato.

Ascolta la radio in diretta

/radio

Sfoglia e ascolta in streaming le stazioni radio Internet per nome, genere o paese: un'alternativa continua alla coda.

Rimani nel canale 24/7

/247 enable lofi

Premium mantiene Beatra connesso e in riproduzione continua, anche quando nessuno è in coda. Passa un genere o l'URL di una playlist per scegliere cosa riprodurre.

Sistema il bot con la modalità AFK

/afk

Premium tiene Beatra in un canale vocale a tua scelta. Non esce mai da solo, torna dopo un riavvio e rientra due minuti dopo la fine della musica.

Modificare la velocità di riproduzione

/speed 1.25

Premium, solo DJ o amministratore. Accetta da 0,25× a 3×; 1 lo reimposta.

Configura il server

/settings

Un pannello per il ruolo del DJ, canali bot consentiti, prefisso, lingua e uscita automatica. Richiede Manage Server. Le stesse impostazioni si trovano su beatra.app/dashboard.

Controlla la riproduzione dal browser

beatra.app/dashboard → your server

Il pannello del server rispecchia il lettore Discord: riproduci, metti in pausa, salta, cerca, riordina o rimuovi elementi in coda, modifica volume, loop ed effetti: nessun comando digitato.

Ascolta invece nel browser

beatra.app/dashboard/web-player

Un player autonomo con la propria coda, indipendente da Discord: cerca, incolla qualsiasi collegamento supportato, carica le tue playlist, leggi i testi e guarda il visualizzatore.

Guarda cosa hai ascoltato

/profile · /summary · /leaderboard

Statistiche personali, riepilogo condivisibile, server e classifiche globali. Tutto è anche sul sito web, nella pagina del tuo profilo e su beatra.app/summary.

Riprodurre un’intera playlist

/play-playlist

Apre un selettore: le tue playlist, una ricerca pubblica o un link da un’altra piattaforma. Funziona anche senza nulla in riproduzione.