Il contenuto SEO rimane renderizzato dal server
Intestazioni, guide, FAQ e schemi possono essere visualizzati come HTML mentre il gioco si carica in un frame.
widget di gioco Astro
Widget di gioco Astro per siti statici e ibridi
I siti Astro possono generare pagine veloci e indicizzabili, offrendo comunque un gioco giocabile. Mantieni intestazioni, testo e schema nella pagina Astro, visualizza Games I Know iframe nel corpo e utilizza un piccolo script lato client o un componente isolato solo dove sono necessari gli eventi del browser.
pagine compatibili con i contenuti statici
JavaScript client minimo
Copia indicizzabile
Percorso del frame Iframe
Risposta breve
Utilizza un percorso frame, quindi aggiungi il contesto della pagina.
In Astro, crea una pagina indicizzabile con metadati e contenuti FAQ, quindi embed /embed/{gameSlug}/frame/ nella pagina. Aggiungi uno script client per postMessage quando hai bisogno degli eventi GAME_STARTED o di completamento.
Prova il widget di gioco compatibile con Astro
La demo live riproduce il modello iframe e il registro eventi che è possibile inserire in una pagina di contenuti Astro.
Gli sviluppatori di Astro aggiungono un gioco iframe
Perché Astro funziona bene con i widget di gioco iframe
Astro eccelle nelle pagine ricche di contenuti. Il gioco rimane in un iframe in modo da non dover distribuire la logica di gioco nel pacchetto principale.
Piccola presenza sul territorio
Solo i listener di eventi o gli helper a schermo intero necessitano di JavaScript lato client.
Stesso embed ovunque
Utilizza lo stesso schema URL del frame su Astro, Next.js, WordPress e siti personalizzati.
Flusso di configurazione
Come aggiungere un widget di gioco in Astro
Crea una rotta con metadati frontmatter, inserisci iframe nel template e isola la messaggistica del browser in uno script client.
Passo 1
Crea la pagina Astro
Aggiungi titolo, descrizione, URL canonico e testo utile intorno al posizionamento del gioco.
Passo 2
Eseguire il rendering di iframe
Utilizza l'URL del frame Games I Know con il tuo tenantId nel corpo della pagina o in un piccolo componente parziale.
Passo 3
Aggiungere la messaggistica client se necessario
Utilizzare uno script client:load o un'isola per rimanere in ascolto degli eventi postMessage provenienti da iframe.
Passo 4
Verifica i risultati firmati lato server
Utilizzare una rotta API o un endpoint di backend per verificare il completamento prima di assegnare le ricompense.
Implementazione
Note sull'implementazione di Astro
Considera la pagina Astro come la superficie SEO e iframe come il confine dell'applicazione giocabile.
Non iframe la landing page
Usa /embed/{gameSlug}/frame/ all'interno di iframe. Conserva /embed/{gameSlug}/ come un normale collegamento scansionabile.
Riserva iframe altezza
Imposta un'altezza fissa di circa 640 pixel per ridurre lo spostamento del layout al caricamento della finestra di gioco.
Aggiungi schema FAQ
Lo schema FAQ e HowTo sulla pagina Astro aiuta i motori di ricerca e i sistemi AI a comprendere l'integrazione.
Giochi disponibili
Scegli il gioco più adatto alla pagina
Tic Tac Toe
Embed for same-screen play on your site, or send players to Games I Know to challenge a friend remotely with a room link.
Embed configurazione
Four in a Row
Embed for local two-player drops on one screen, or link friends to play Four in a Row online from anywhere.
Embed configurazione
Bingo
Same-screen Bingo in your embed, or host a remote room so players can join from their own devices.
Embed configurazione
I Know
Quick trivia in your embed on one screen, or run a live room so friends can answer from anywhere.
Embed configurazione
Sudoku
Embed a solo Sudoku puzzle for calm brain breaks on blogs, school pages, and waiting-room screens.
Embed configurazione
Word Search
Embed a solo Word Search puzzle for quick brain breaks on blogs, school pages, and waiting-room screens.
Embed configurazione
FAQ
Domande frequenti su widget di gioco Astro
Qual è la differenza tra /embed/{gameSlug}/ e /embed/{gameSlug}/frame/?
Utilizza /embed/{gameSlug}/frame/ come src di iframe. Questa route è il frame di gioco leggero creato per i embed del sito web e gli eventi postMessage. La route /embed/{gameSlug}/ è la pagina di anteprima pubblica e SEO per gli utenti, non la route da inserire all'interno di un iframe.
I visitatori devono scaricare un'app o creare un account?
No. I visitatori possono giocare all'interno del browser iframe su telefono, tablet, laptop o computer desktop. Un account partner è necessario solo al proprietario del sito web che installa embed.
Posso limitare embed al mio dominio?
Sì. I Games I Know e embed sono progettati per siti web registrati e impostazioni di tenant con restrizioni di dominio, quindi il codice iframe copiato non può essere riutilizzato liberamente su siti non autorizzati.
Quali titoli Games I Know sono attualmente embed disponibili?
Tic Tac Toe, Four in a Row, Bingo e I Know sono disponibili come giochi per browser embed. La documentazione embed utilizza lo stesso modello di eventi per tutti i giochi supportati.
Posso usare Games I Know con l'output statico di Astro?
Sì. Il contenuto della pagina può essere interamente HTML statico. Il iframe carica il gioco dal Games I Know in fase di esecuzione nel browser del visitatore.
Pronti ad aggiungere un gioco al browser?
Crea un account partner, registra il tuo dominio e genera un iframe con restrizioni di dominio per il tuo sito web.