Documentazione
Parametri base
Questi sono i parametri di base da configurare, indispensabili per far funzionare la videoconferenza.
Tipo istanza: Tramite questo parametro è possibile scegliere a quale istanza connettere il modulo. JooJitsi Conferencing può essere connesso al server gratuito di Jitsi-Meet, ad un'istanza privata (un tuo server) oppure al server "Jitsi as a Service (JaaS)".
Recentemente, il team di Jitsi ha annunciato un cambiamento significativo riguardante l'integrazione di Jitsi-Meet nelle applicazioni web. A partire dal 24 aprile 2023, la versione più recente di meet.jit.si non permette più l'utilizzo a tempo illimitato dell'incorporamento nelle applicazioni web (le videoconferenze si interrompono dopo 5 minuti).
Il team di Jitsi consiglia agli utenti di considerare l'utilizzo di Jitsi as a Service (JaaS). JaaS è un servizio a pagamento che offre molte più funzionalità rispetto a meet.jit.si, tra cui web hooks, branding, registrazioni lato server e molti altri. L'utilizzo di JaaS è gratuito fino a 25 endpoint* al mese, dopodiché inizia a essere a pagamento con un prezzo di circa $0.33 per endpoint* al mese raggruppati in diversi pacchetti.
*Un utente attivo mensile (MAU) è definito come un utente unico che ha partecipato ad almeno una riunione, con almeno un altro utente, nello stesso mese. Per determinare un utente unico, viene memorizzato un identificatore nella memoria locale del dispositivo (nel browser utilizzato), che rimarrà invariato finché l'utente utilizzerà lo stesso browser e lo stesso dispositivo e non cancellerà i dati della cache locale.
Se il vostro sito Joomla utilizza attualmente il modulo JooJitsi per incorporare Jitsi-Meet, vi consigliamo di iniziare a pianificare la transizione a Jitsi as a Service (JaaS). Potete trovare maggiori informazioni su JaaS sul sito web di JaaS.
A seconda dell'istanza scelta, i successivi parametri da configurare sono differenti:
- Istanza "Free"
Nome server: Server dell'istanza Jitsi Meet gratuita a cui connettere il modulo. L'indirizzo del server pubblico gratuito Jitsi è già impostato di default.
Jitsi API URL: Indirizzo URL delle API di Jitsi. Anche questo parametro è già settato di default con l'indirizzo dell'istanza del server pubblico gratuito Jitsi. Dovrai modificarlo solo se intendi connettere il modulo ad una tua istanza privata di Jitsi.
- Istanza "Custom"
Nome server custom: Server della tua istanza privata a cui connettere il modulo.
Custom API URL: Indirizzo URL delle API di Jitsi. Dovrai inserire l'indirizzo URL delle API del tuo server privato.
iss: Inserisci qui il parametro "iss" della configurazione del tuo server privato.
aud: Inserisci qui il parametro "aud" della configurazione del tuo server privato.
sub: Inserisci qui il parametro "sub" della configurazione del tuo server privato.
Encoding mode: La modalità 1 crea e codifica le intestazioni utilizzando l'algoritmo HS256 e crea e codifica la firma utilizzando l'algoritmo hmac. La modalità 2 crea e codifica le intestazioni utilizzando l'algoritmo RS256 e il parametro "kid" e crea e codifica la firma usando openssl.
Private key: Inserisci qui la chiave privata della tua istanza. Inserisci il contenuto "grezzo" della chiave, senza modificarla.
- Istanza "JaaS"
Nome server JaaS: Server dell'istanza JaaS a cui connettere il modulo. L'indirizzo del server standard di 8x8 è già impostato di default.
JaaS API URL: Indirizzo URL delle API di Jitsi. L'indirizzo delle API standard di 8x8 è già impostato di default.
API Key ID: Inserisci qui la API Key ID della configurazione del tuo account JaaS.
Nota bene: deve essere del tipo vpaas-magic-cookie-62f63b141x9d4172anfacc8474c66798/b754ea e deve essere presente anche la parte finale, quella dopo lo slash (che abbiamo indicato in rosso nell'esempio), altrimenti non funzionerà!
Private key: Inserisci qui la chiave privata della tua istanza. Inserisci il contenuto "grezzo" della chiave, senza modificarla. Anche le linee "-----BEGIN PRIVATE KEY-----" e "-----END PRIVATE KEY-----" devono essere incluse.
Gli altri parametri da configurare sono comuni a tutte le istanze:
Nome stanza: Questo è il nome che avrà la stanza della tua videoconferenza. Questo nome farà parte del link principale che permette la connessione di tutti i partecipanti. Pertanto, per limitare il rischio di visitatori indesiderati nella tua conferenza, cerca di scegliere un nome più articolato possibile per la tua stanza! Gli spazi tra le parole saranno automaticamente sostituiti da trattini bassi.
Soggetto stanza: Soggetto della stanza della conferenza. Si tratta di una semplice descrizione che, se vuoi, può essere visibile ai partecipanti.
Lingua di default: Se necessario, puoi modificare qui la lingua predefinita dell'interfaccia della tua coneferenza. Sono ammessi solo codici di lingua a 2 cifre (come ad esempio: en, it, es, de, ecc...)
Carica jQuery: Serve per caricare la libreria jQuery nel caso in cui non dovesse essere già caricata dal template in uso. Se la conferenza non dovesse aprirsi, prova ad abilitare questo parametro.
jQuery fix: Se la conferenza non dovesse aprirsi, prova ad abilitare anche questo parametro. Talvolta alcuni template di Joomla caricano la libreria jQuery dopo gli script di JooJitsi Conferencing. Questo parametro permette di invertire tale ordine e risolvere eventuali problemi di questo tipo.
