Come integrare BigBlueButton con Moodle LMS (passo dopo passo)
In breve: su Moodle 4.0 o versioni successive, normalmente non è necessario installare un plugin separato per l'attività BigBlueButton. Se il tuo sito ha questa opzione disabilitata, abilita l'attività integrata, inserisci l'URL del server BigBlueButton e la chiave segreta condivisa nelle impostazioni del sito, quindi aggiungi un'attività BigBlueButton a un corso e testala sia con un docente che con uno studente iscritto. È necessario disporre di un servizio BigBlueButton funzionante e delle credenziali del provider o dell'amministratore del server; la sola installazione dell'attività Moodle non crea un server per le videoconferenze.
Questa guida illustra l'integrazione standard delle attività di Moodle, non un'implementazione LTI separata. Le etichette e i percorsi di menu riportati di seguito potrebbero variare leggermente a seconda della versione o del tema di Moodle. I pannelli dell'interfaccia sono riferimenti visivi alle impostazioni e al flusso di lavoro, non schermate di un'installazione Moodle in tempo reale.
Devo installare un altro plugin per Moodle?
Di solito no. Moodle ha integrato BigBlueButton come plugin principale in Moodle 4.0. In Moodle dalla versione 4.0 alla 5.2, un amministratore potrebbe doverlo abilitare in Amministrazione del sito > Plugin > Gestisci attività e accettare l'accordo sul trattamento dei dati. La documentazione di Moodle 5.3 afferma che l'attività è abilitata per impostazione predefinita nelle nuove installazioni, ma l'amministratore deve comunque inserire l'URL del server e la chiave segreta condivisa; fino ad allora, il selettore di attività potrebbe mostrare BigBlueButton come non disponibile. Se il tuo sito è precedente a Moodle 4.0, verifica la versione del plugin corrispondente alla tua versione di Moodle prima di installarne una copia separata. Non installare un modulo attività duplicato su un sito più recente. Consulta le note di aggiornamento di Moodle per BigBlueButton per la cronologia del plugin principale e la documentazione di Moodle 5.3 per il comportamento attuale dell'attività.
Cosa devo avere pronto prima dell'installazione?
Un servizio BigBlueButton: si tratta di un server gestito dalla vostra organizzazione oppure di un servizio ospitato che consente l'integrazione con Moodle.
URL del server e segreto condiviso: chiedi al tuo provider o all'amministratore del server. Se gestisci un server BigBlueButton self-hosted compatibile, il suo amministratore può eseguire il comando sudo bbb-conf --secretsu quel server. Il comando visualizza l'URL e il segreto API.
Accesso amministrativo a Moodle: solo un amministratore del sito può modificare le credenziali del server a livello di sito; un docente del corso può aggiungere l'attività dopo che è stata abilitata.
Corso di prova e account di prova: utilizzare un account docente o moderatore e un account studente iscritto al corso.
L'URL è l'indirizzo del server BigBlueButton fornito per l'integrazione API, che in genere termina con /bigbluebutton/. Copia esattamente il valore del provider, inclusi https://e la barra finale, anziché aggiungere un /apipercorso ipotizzato. Il segreto condiviso firma le richieste API da server a server. Mantienilo privato: le linee guida sulla sicurezza API di BigBlueButton raccomandano di non esporre il segreto in JavaScript lato browser o nei contenuti pubblici del corso. Se utilizzi le credenziali di un servizio ospitato, tale provider potrebbe applicare i propri limiti di partecipanti, registrazioni o sessioni.
L'amministratore del server BigBlueButton può eseguire il comando bbb-conf --secret per recuperare l'URL del server e la chiave segreta condivisa; la chiave segreta di esempio è stata oscurata.
Come faccio a collegare Moodle al server di BigBlueButton?
1. Verifica la versione di Moodle e abilita l'attività
Accedi come amministratore del sito e verifica la versione di Moodle nella pagina delle notifiche del sito o delle informazioni di sistema. Se l'attività BigBlueButton è disabilitata, abilitala dalla pagina di gestione delle attività. Nelle versioni di Moodle dalla 4.0 alla 5.2, le note di aggiornamento di Moodle indicano che l'attività principale può essere disabilitata per impostazione predefinita e che l'amministratore deve accettare l'accordo sul trattamento dei dati per abilitarla. In un nuovo sito Moodle 5.3, dovrebbe essere elencata come abilitata, ma la mancanza delle credenziali potrebbe comunque renderla non disponibile nel selettore. La posizione nel menu può variare; utilizza la funzione di ricerca di amministrazione del sito per "BigBlueButton" se le etichette non corrispondono al tuo tema.
Inserisci l'endpoint e la chiave segreta condivisa forniti dal tuo host nelle impostazioni di BigBlueButton su Moodle, quindi salvali.
2. Inserisci l'URL del server e la chiave segreta condivisa
Apri le impostazioni di BigBlueButton dall'amministrazione del sito, solitamente in Plugin o Plugin > Moduli attività . Trova le impostazioni generali per URL del server BigBlueButton e Chiave segreta condivisa di BigBlueButton . Incolla i valori forniti dal tuo provider di servizi o dall'amministratore del server, quindi salva le modifiche. La documentazione di Moodle 5.3 descrive come inserire queste credenziali dalla pagina delle impostazioni di BigBlueButton; l'etichetta di navigazione esatta potrebbe essere diversa nelle versioni precedenti.
Per un servizio self-hosted, confronta i valori di Moodle con l'URL e il segreto riportati sul server BigBlueButton. Non rigenerare o modificare il segreto del server come semplice procedura di risoluzione dei problemi: ogni frontend che utilizza quel server deve essere aggiornato con il nuovo valore. Il segreto non è una password dello studente e non deve essere incluso in un messaggio di benvenuto di un'attività. BigBlueButton spiega come il segreto condiviso convalida le chiamate API nella sua guida alla personalizzazione del server BigBlueButton e nella documentazione sulla sicurezza delle API di BigBlueButton .
3. Aggiungere un'attività di prova a un corso
Apri un corso in cui hai i permessi di modifica e attiva la modalità di modifica. Nella sezione "Destinazione", scegli " Aggiungi un'attività o una risorsa" , quindi seleziona BigBlueButton . Se non è presente, torna ai controlli a livello di sito del passaggio 1 anziché provare ad aggiungere un plugin diverso. Utilizza una sessione temporanea con un nome chiaro, ad esempio "Test di connessione BBB", in modo che gli studenti non la confondano con una lezione programmata.
Nella schermata di selezione delle attività del corso, BigBlueButton appare come attività dopo che l'amministratore del sito l'ha abilitata e configurata.
4. Definisci i dettagli e la pianificazione della riunione
Assegna all'attività un nome riconoscibile e aggiungi una breve descrizione che ne spieghi lo scopo. Un messaggio di benvenuto è facoltativo. Decidi se abilitare l'opzione "Attendi moderatore" : se abilitata, gli studenti attendono l'accesso di un utente con ruolo di moderatore. Se il corso ha un orario di inizio o di fine specifico, imposta la pianificazione e verifica il fuso orario del corso. Evita di rendere accessibile un'attività di prova agli ospiti, a meno che il tuo istituto non lo consenta espressamente; l'accesso per gli utenti iscritti è più facile da controllare in fase di configurazione.
Inizialmente, utilizzare i ruoli predefiniti per i partecipanti. Se il docente deve moderare la stanza, verificare che l'account abbia il ruolo appropriato nel corso Moodle prima di effettuare il test. I link per gli ospiti e l'accesso esterno sono soggetti a condizioni separate a livello di sito e potrebbero non essere disponibili quando il sito Moodle richiede agli utenti di effettuare l'accesso.
Il modulo di attività include un nome e un messaggio di benvenuto facoltativo, un'impostazione per l'attesa del moderatore e i controlli di pianificazione.
Come posso verificare che l'integrazione funzioni per gli studenti?
5. Salva l'attività e verifica che venga visualizzata nel corso.
Salva l'attività e torna alla pagina del corso. Verifica che il nome e l'orario programmato siano corretti. Se l'attività è nascosta, al di fuori del suo intervallo di disponibilità o soggetta a restrizioni di gruppo o di accesso, gli studenti potrebbero non visualizzarla anche se la connessione al server funziona. Prima di diagnosticare un problema con il server BigBlueButton, controlla la visibilità dell'attività e le iscrizioni al corso.
L'attività del Seminario settimanale salvata viene visualizzata nella sezione del corso con i relativi dettagli di programmazione.
6. Accedi come insegnante e verifica l'accesso audio.
Apri l'attività di prova come insegnante o moderatore. Quando la stanza ti chiede di connettere l'audio, scegli Microfono per testare la capacità di parlare e ascoltare, oppure Solo ascolta se stai verificando la riproduzione senza microfono. Consenti al browser di accedere al microfono quando richiesto. Un errore di autorizzazione del browser è diverso da un errore di credenziali di Moodle: se la stanza si apre ma l'audio non funziona, verifica prima le autorizzazioni del sito del browser e il dispositivo audio selezionato.
Al segnale audio, i partecipanti possono scegliere se attivare il microfono o limitarsi ad ascoltare.
7. Iscriviti di nuovo con un account studente già registrato
Utilizza un secondo profilo browser o un dispositivo separato per accedere come studente iscritto e apri la stessa attività. Verifica se lo studente può accedere immediatamente o se visualizza il comportamento previsto di attesa del moderatore. Controlla che il partecipante appaia nella stanza e che una breve chat o un test audio funzionino. Questo test verifica più di un avvio da parte dell'amministratore, poiché la visibilità dello studente, l'iscrizione al corso, le restrizioni di gruppo e le impostazioni del moderatore possono influenzare il risultato.
In una classe virtuale unita, l'area di presentazione può essere visualizzata accanto all'elenco dei partecipanti e al riquadro della chat.
8. Controlla le registrazioni solo se la tua configurazione le supporta.
La registrazione è facoltativa e dipende dal server, dalle impostazioni dell'attività, dalle autorizzazioni e dal piano di servizio. Se la registrazione è abilitata, effettuate una breve registrazione di prova, terminate la riunione correttamente e verificate se il link alla registrazione diventa disponibile per i ruoli Moodle desiderati. La registrazione potrebbe non apparire immediatamente; la documentazione di aggiornamento di Moodle indica che le attività relative ai metadati di registrazione possono essere eseguite in modo asincrono e che, nello scenario di aggiornamento documentato, è necessario che il cron di Moodle sia attivo per l'elaborazione correlata alla registrazione. Per verificare lo stato attuale del cron, consultate lo stato delle attività pianificate di Moodle e le policy di registrazione del vostro provider prima di concludere che l'integrazione stessa sia interrotta.
Una voce relativa alla registrazione può apparire sotto l'attività quando le registrazioni sono abilitate, elaborate e disponibili per quell'utente.
Cosa succede se Moodle non riesce a connettersi o gli studenti non riescono ad accedere?
Sintomo
Prima verifica
BigBlueButton non è presente nel selettore delle attività.
Verifica che l'attività integrata sia abilitata e disponibile per la tua versione di Moodle.
L'attività è disattivata (in grigio) su Moodle 5.3
Completa l'URL del server e la configurazione della chiave segreta condivisa; la documentazione attuale indica che credenziali incomplete rendono il servizio non disponibile.
Moodle segnala che il server non è disponibile o che la stanza non può essere avviata.
Confronta l'URL e la chiave segreta esatte con i valori forniti dal provider; verifica che il server Moodle possa raggiungere l'host di BigBlueButton tramite HTTPS.
L'insegnante può partecipare, ma lo studente no.
Verifica l'iscrizione al corso, la visibilità delle attività, le date di accesso, le restrizioni di gruppo e le impostazioni di attesa del moderatore.
La stanza si apre ma l'audio e il video non funzionano.
Verifica le autorizzazioni del browser e i requisiti multimediali/di rete del servizio BigBlueButton; la sola connettività API non è sufficiente a verificare il percorso multimediale di ciascun partecipante.
Non è presente alcuna registrazione
Verifica che la registrazione sia supportata e abilitata, controlla chi può visualizzarla e rivedi lo stato delle attività pianificate/cron.
Se Moodle segnala di non riuscire ad accedere alla stanza, iniziate verificando l'URL, la chiave segreta condivisa e la raggiungibilità del server. La vecchia pagina di risoluzione dei problemi di Moodle elenca queste come cause comuni; utilizzatela come lista di controllo diagnostica, prendendo le credenziali effettive dal vostro attuale provider anziché copiare i valori del vecchio server di test. Per un server autogestito, l'amministratore di BigBlueButton può anche verificare il servizio dal lato server. Non includete la chiave segreta condivisa in screenshot, post di supporto e log pubblici.
Lista di controllo per la configurazione finale
La versione di Moodle e lo stato del modulo di attività sono noti.
L'endpoint BigBlueButton corretto e la chiave segreta condivisa sono salvati nelle impostazioni del sito.
L'attività è presente nel corso ed è visibile allo studente che svolge il test.
Un insegnante e uno studente iscritto possono partecipare con i ruoli previsti.
L'audio funziona nel browser per almeno un partecipante.
La riproduzione delle registrazioni viene testata separatamente solo se inclusa nel servizio.
Un'integrazione riuscita significa che Moodle può creare e avviare una sessione per gli utenti del corso appropriati, non solo che un'attività BigBlueButton sia presente nel selettore. Se l'avvio da parte dell'insegnante funziona ma studenti, contenuti multimediali o registrazioni non funzionano, è necessario risolvere i problemi relativi a tali autorizzazioni o livelli di servizio separatamente, anziché reinstallare ripetutamente l'attività principale di Moodle.