Games I Know logoGames I Know
Permainan browser Games I Know ditampilkan sebagai widget permainan Astro.

Widget game Astro

Widget game Astro untuk situs statis dan hibrida.

Situs Astro dapat mengirimkan halaman yang cepat dan mudah diindeks, serta tetap menawarkan permainan yang dapat dimainkan. Pertahankan judul, teks, dan skema di halaman Astro, tampilkan Games I Know iframe di dalam isi halaman, dan gunakan skrip klien kecil atau island hanya di tempat yang membutuhkan event browser.

Halaman yang ramah statis

JavaScript klien minimal

Salinan yang dapat diindeks

Rute bingkai Iframe

Jawaban singkat

Gunakan rute frame, lalu tambahkan konteks halaman.

Di Astro, buat halaman yang dapat diindeks dengan metadata dan konten FAQ, lalu embed /embed/{gameSlug}/frame/ di halaman tersebut. Tambahkan skrip klien untuk postMessage saat Anda membutuhkan event GAME_STARTED atau penyelesaian.

Cobalah widget game yang ramah Astro.

Demo langsung ini mencerminkan pola iframe dan log peristiwa yang dapat Anda tempatkan di halaman konten Astro.

Pengembang Astro menambahkan game iframe

Mengapa Astro bekerja dengan baik dengan widget game iframe

Astro unggul dalam halaman yang kaya konten. Gim ini tetap berada di iframe sehingga Anda tidak menyertakan logika gim dalam bundel utama.

Konten SEO tetap diproses oleh server.

Judul, panduan, FAQ, dan skema dapat ditampilkan sebagai HTML saat game dimuat dalam sebuah frame.

Jejak klien yang kecil

Hanya event listener atau fullscreen helper yang membutuhkan JavaScript di sisi klien.

embed yang sama di mana-mana

Gunakan pola URL frame yang sama di seluruh Astro, Next.js, WordPress, dan situs kustom.

Alur pengaturan

Cara menambahkan widget game di Astro

Buat rute dengan metadata frontmatter, tempatkan iframe di dalam templat, dan isolasi pengiriman pesan browser dalam skrip klien.

  1. Langkah 1

    Buat halaman Astro

    Tambahkan judul, deskripsi, URL kanonik, dan teks yang bermanfaat di sekitar penempatan game.

  2. Langkah 2

    Render iframe

    Gunakan URL frame Games I Know dengan tenantId Anda di dalam isi halaman atau komponen parsial kecil.

  3. Langkah 3

    Tambahkan pesan klien jika diperlukan.

    Gunakan skrip client:load atau island untuk mendengarkan peristiwa postMessage dari iframe.

  4. Langkah 4

    Verifikasi hasil yang ditandatangani di sisi server.

    Gunakan rute API atau endpoint backend untuk memverifikasi penyelesaian sebelum memberikan hadiah.

Pelaksanaan

Catatan implementasi Astro

Anggap halaman Astro sebagai permukaan SEO dan iframe sebagai batas aplikasi yang dapat dijalankan.

Jangan iframe halaman arahan

Gunakan /embed/{gameSlug}/frame/ di dalam iframe. Pertahankan /embed/{gameSlug}/ sebagai tautan biasa yang dapat dirayapi.

Cadangan tinggi iframe

Tetapkan tinggi tetap sekitar 640px untuk mengurangi pergeseran tata letak saat frame game dimuat.

Tambahkan skema FAQ

Skema FAQ dan HowTo pada halaman Astro membantu mesin pencari dan sistem AI memahami integrasi tersebut.

Pertanyaan yang Sering Diajukan (FAQ)

Pertanyaan umum tentang Widget game Astro

Apa perbedaan antara /embed/{gameSlug}/ dan /embed/{gameSlug}/frame/?

Gunakan /embed/{gameSlug}/frame/ sebagai src iframe. Rute tersebut adalah kerangka game ringan yang dibangun untuk embed situs web dan peristiwa postMessage. Rute /embed/{gameSlug}/ adalah halaman pratinjau publik dan SEO untuk orang-orang, bukan rute yang ditempatkan di dalam iframe.

Apakah pengunjung perlu mengunduh aplikasi atau membuat akun?

Tidak. Pengunjung dapat bermain di dalam browser iframe di ponsel, tablet, laptop, atau desktop. Akun mitra hanya diperlukan oleh pemilik situs web yang memasang embed.

Bisakah saya membatasi embed hanya untuk domain saya sendiri?

Ya. Games I Know embed dirancang berdasarkan situs web terdaftar dan pengaturan penyewa yang dibatasi domain, sehingga kode iframe yang disalin tidak dapat digunakan kembali secara bebas di situs yang tidak berizin.

Judul Games I Know mana yang saat ini embed dapat digunakan?

Tic Tac Toe, Four in a Row, Bingo, dan I Know tersedia sebagai game browser yang dapat dimainkan di embed. Dokumentasi embed menggunakan model event yang sama di seluruh game yang didukung.

Bisakah saya menggunakan Games I Know dengan output statis Astro?

Ya. Konten halaman dapat berupa HTML statis sepenuhnya. iframe memuat game dari Games I Know saat dijalankan di browser pengunjung.

Siap menambahkan game browser?

Buat akun mitra, daftarkan domain Anda, dan hasilkan iframe yang dibatasi domain untuk situs web Anda.