Progetta nuvole di parole e mappe personalizzate

Scegli la pagina iniziale giusta

Scegli wordcloud.html per parole ripetute o map.html per le posizioni degli spettatori. Entrambi necessitano di qualcosa di più di uno sfondo statico: il renderer posiziona elementi guidati dai dati. Conserva la cartella sorgente completa, inclusa quella aggiuntiva della mappa thirdparty/map/ set di dati.

Scaricare e conservare la struttura del file

1. Scarica lo ZIP sorgente ed estrarlo. Queste guide utilizzano l'origine beta; mantenere insieme i file di un download.
2. Copia wordcloud.html a my-wordcloud.html accanto all'originale. Se scegli una pagina o un tema diverso, conserva la copia nella cartella originale del file.
3. Apri l'HTML copiato e il relativo CSS/JS di riferimento nel tuo editor o strumento AI. Aggiungi grafica/caratteri forniti allo stesso progetto e utilizza i percorsi relativi. Inizia con le sostituzioni CSS; includere il renderer quando si modifica il markup generato.

I file seguenti aiutano a trovare la progettazione e il comportamento. Questo è un elenco di lettura, non un pacchetto di dipendenze completo: mantieni intatta la cartella estratta, incluse immagini, caratteri, script ed eventuali file di dati.

Collega la tua copia e aprila in OBS

Avvia SSN e fai funzionare prima l'URL di sovrapposizione generato originale. Il session= si connette a quella sessione SSN; non è il nome del tuo canale o il nome di questo file. Mantieni SSN, la funzionalità pertinente e le relative origini dati in esecuzione.

1. Trascina il file HTML modificato in Chrome o Edge. Copia il suo indirizzo dalla barra degli indirizzi; inizia con file:///.
2. Copia tutto da ? in poi nel collegamento in sovrapposizione SSN funzionante e aggiungilo alla fine dell'indirizzo del file. Conserva tutte le impostazioni, inclusa la sessione, la password e altro # fine.
3. Aprire il risultato in un browser, quindi impostare una sorgente browser OBS URL allo stesso indirizzo con File locale deselezionato. Abbina le dimensioni di origine al progetto previsto.

Per il file iniziale sopra, l'indirizzo locale è simile a questo; il tuo collegamento effettivo potrebbe contenere ulteriori opzioni richieste:

file:///C:/SSN/social_stream-beta/my-wordcloud.html?session=YOUR_SESSION

Utilizza l'indirizzo file effettivo sul tuo computer. OBS lo salva con il sorgente; mantieni la cartella scaricata nello stesso posto. Dopo aver salvato le modifiche al design, aggiorna la sorgente del browser. Il guida di configurazione condivisa include esempi Mac e un launcher opzionale per la casella di controllo File locale.

Dove modificare il design

Per la nuvola di parole, modifica i caratteri, la tavolozza, lo sfondo, la spaziatura e la mappatura tra frequenza e dimensione. Preserva il filtraggio e l'accumulo dei conteggi. La sua modalità predefinita accetta messaggi di una sola parola; allwords modifica questo comportamento, quindi mantieni l'opzione scelta dall'operatore.

Per la mappa, iniziare con i controlli esistenti di stile mappa, regione, etichetta e colore. Modifica lo stile dell'indicatore/pannello senza sostituire la corrispondenza o il conteggio della posizione. Per semplici modifiche allo stile, utilizza il collegamento alla mappa ospitata con OBS CSS personalizzato. I suoi file di dati JSON separati possono essere bloccati quando vengono aperti dal disco; per una copia HTML modificata, chiedi all'IA di includere tali dati nella pagina in modo che si apra direttamente.

Copia questo prompt AI

Fornisci all'intelligenza artificiale i file sorgente copiati e la grafica di riferimento. Sostituisci i dettagli tra parentesi. Conservare le istruzioni di sicurezza dell'input nel prompt.

Customize my-wordcloud.html, copied from wordcloud.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].

Customize [wordcloud.html / map.html] as [design]. Preserve word/location parsing, counts, identity/change rules, reset controls, and the existing simulation/projection. Keep packaged libraries and JSON datasets in their current relative paths. Style the visualization without inventing sample participants or coordinates in the live display.

Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.

Testare questo tipo di overlay

Utilizzare prima un'anteprima o una configurazione di prova. Il guida al messaggio di prova spiega come inviare payload fittizi tramite SSN; un test inviato alla sessione di produzione può attivare le sue automazioni esistenti.

1. Per i word cloud, invia messaggi semplici ripetuti di una parola, quindi una frase con tutte le parole abilitate solo se questa è la modalità prevista.
2. Per le mappe, utilizzare la sintassi della posizione configurata e testare una posizione nota, una posizione non riconosciuta e la seconda voce dello stesso visualizzatore.
3. Ripristino del test, etichette lunghe, visualizzazione occupata e regione scelta. Controlla gli errori di rete del browser se la mappa non ha geografia.

Eseguire anche il file controlli di rendering dell'input rispetto ai percorsi di rendering modificati. Dopo aver salvato le modifiche, aggiorna la sorgente del browser OBS tra le prove e ripeti l'interazione visibile. Le anteprime del browser non stabiliscono l'acquisizione dal vivo o il comportamento di OBS.

Altri riferimenti: Altri strumenti di partecipazione del pubblico · Campi del carico utile · Riferimento degli eventi · Risoluzione dei problemi di configurazione locale.