Come funziona
Se siete interessati ai dettagli tecnici relativi al funzionamento dell'API, ecco un breve diagramma:
Script scritti dall'utente ===> Server API ===> Campagna sandbox <===> Server di sincronizzazione in tempo reale
Il server API Roll20 monitora l'attività della vostra campagna. Quando rileva che le persone stanno utilizzando la tua campagna, avvia una sandbox per la tua campagna e carica tutti gli script Mod (API) che hai scritto nella sandbox. La sandbox può ricevere e inviare dati direttamente al server di sincronizzazione in tempo reale, il che le consente di rispondere agli eventi e apportare modifiche al gioco.
Restrizioni rispetto al normale Javascript
Sebbene gli script Roll20 siano in Javascript, esistono alcune limitazioni di cui è opportuno essere consapevoli se si ha familiarità con la programmazione Javascript per siti web. Gli script Roll20 vengono eseguiti in un ambiente sandbox separato dal sito Roll20. Ciò garantisce un ulteriore livello di separazione e sicurezza per il nostro sistema e per i vostri giocatori. Questo sandbox implica che:
- Non è possibile effettuare richieste HTTP (AJAX).
- Non è possibile caricare script o librerie esterni (ad esempio jQuery).
- L'ambiente è Javascript, ma non si tratta di un ambiente in un browser, quindi non sono presenti DOM, elementi di pagina, CSS,
documenti,finestre, ecc.