Cara Buat Kuiz Interaktif di TikTok LIVE (Lengkap dengan Prompt AI)

Cara Buat Kuiz Interaktif di TikTok LIVE (Lengkap dengan Prompt AI)
Skrin kuiz TikTok LIVE: soalan, jawapan dan papan markah

Pada 28 Oktober 2026, saya buat ulang kaji Sejarah Tahun 6 secara LIVE di TikTok. Penonton menjawab soalan dengan menaip A, B, C atau D di ruangan komen. Skrin kuiz terus memaparkan siapa yang menjawab, jawapan yang betul, dan papan markah. Seramai 18 orang menyertai set pertama.

Selepas itu ramai cikgu bertanya macam mana saya buat. Artikel ini menerangkan semuanya, termasuk prompt yang boleh cikgu salin dan berikan kepada AI untuk membina kuiz sendiri.

Ringkasan

  • Apa: kuiz di TikTok LIVE. Penonton jawab A, B, C atau D di komen, dan markah dikira secara automatik.
  • Perlu: komputer, Node.js (percuma), TikTok LIVE Studio dan alat AI seperti Claude atau ChatGPT.
  • Masa: kira-kira satu petang untuk membina dan menguji kali pertama.
  • Paling penting: uji pada LIVE sebenar dengan akaun kedua sebelum LIVE dengan murid.

Bagaimana Kuiz Ini Berfungsi

Sistem ini ada tiga bahagian, dan semuanya berjalan di komputer cikgu sendiri:

  1. Pembaca komen. Program kecil di komputer membaca komen LIVE cikgu dan mencari jawapan A, B, C atau D.
  2. Skrin kuiz. Halaman web berbentuk menegak (9:16) yang memaparkan soalan, pemasa dan papan markah. Skrin inilah yang ditangkap oleh TikTok LIVE Studio dan dilihat penonton.
  3. Panel guru. Halaman web berasingan untuk cikgu mengawal kuiz: soalan seterusnya, dedah jawapan, papan markah. Panel ini memaparkan jawapan betul, jadi jangan sekali-kali tangkap panel ke dalam LIVE.
Skrin kuiz semasa soalan dibuka, dengan nama penonton yang telah menjawab

Bila masa tamat, jawapan didedahkan bersama peratus undian dan senarai penjawab betul yang paling pantas:

Skrin kuiz semasa jawapan didedahkan, dengan peratus undian setiap pilihan

Sebelum Mula: Perkara Penting

Baca dahulu bahagian ini

  • Umur murid. Umur minimum akaun TikTok ialah 13 tahun. Jangan minta murid sekolah rendah membuat akaun. Untuk mereka, tayangkan kuiz di kelas, atau jadikan ibu bapa sebagai peserta.
  • Bukan API rasmi. TikTok tidak menyediakan cara rasmi untuk membaca komen LIVE. Kuiz ini menggunakan pakej sumber terbuka yang membaca sahaja dan tidak perlu log masuk. Jika TikTok mengubah sistemnya, pakej ini mungkin berhenti berfungsi. Sentiasa sediakan pelan B: jalankan kuiz dari panel dan baca jawapan di komen sendiri.
  • Privasi penonton. Nama penonton hanya dipaparkan di skrin LIVE. Jangan simpan nama atau komen penonton ke dalam fail.
  • Kelayakan LIVE. Akaun cikgu mesti layak membuat LIVE dan menggunakan LIVE Studio. Syaratnya ditetapkan oleh TikTok dan boleh berubah, jadi semak dalam aplikasi TikTok.

Apa yang Diperlukan

  • Komputer Windows atau Mac. Kuiz berjalan di komputer, bukan telefon.
  • Node.js versi LTS, percuma di nodejs.org. Pasang seperti aplikasi biasa.
  • TikTok LIVE Studio untuk komputer.
  • Alat AI untuk menulis kod. Paling mudah ialah alat yang boleh mencipta fail terus di komputer, seperti Claude Code. ChatGPT atau Claude di browser pun boleh, tetapi cikgu perlu menyalin setiap fail sendiri.
  • Akaun TikTok kedua (contohnya di telefon) untuk menguji komen.

Langkah 1: Bina Aplikasi Kuiz dengan AI

Cipta satu folder kosong, contohnya kuiz-live-tiktok. Kemudian berikan prompt di bawah kepada alat AI cikgu.

Prompt ini panjang kerana ia mengandungi semua pelajaran daripada LIVE sebenar saya. Contohnya, dokumentasi pakej tersebut menyebut teks komen berada dalam medan comment, tetapi dalam versi sebenar ia berada dalam content. Tanpa maklumat ini, kuiz akan senyap dan tidak menerima sebarang jawapan.

Saya seorang guru dan bukan pengaturcara. Bina aplikasi kuiz untuk TikTok LIVE yang berjalan di komputer saya menggunakan Node.js. Penonton menjawab soalan dengan menaip A, B, C atau D di ruangan komen LIVE.

KEPERLUAN TEKNIKAL
1. Server Node.js (fail server.mjs) yang hanya mendengar di 127.0.0.1, port 4321.
2. Baca komen LIVE menggunakan pakej npm tiktok-live-connector versi 2.x, disambung menggunakan nama akaun TikTok saya. PENTING: dalam versi 2.x, teks komen berada dalam data.content (bukan data.comment seperti dalam dokumentasi), nama penonton dalam data.user.nickname, dan id penonton dalam data.user.uniqueId atau data.user.id.
3. Jika sambungan terputus semasa LIVE, cuba sambung semula setiap 10 saat sehingga LIVE tamat.
4. Dua halaman web yang dikemas kini secara langsung melalui WebSocket:
 a. Skrin kuiz (/): saiz tetap 1080x1920 (menegak 9:16), diskalakan ikut saiz tetingkap. Skrin ini ditangkap ke dalam LIVE. Papar soalan, empat pilihan A-D dalam grid 2x2 berwarna, pemasa, bilangan penonton yang telah menjawab dan nama mereka. SEMUA kandungan penting mesti berada dalam 65% atas skrin, kerana komen TikTok menutup bahagian bawah skrin telefon penonton.
 b. Panel guru (/panel.html) untuk saya sahaja: medan nama akaun TikTok dan butang Sambung, pilih set soalan, masa setiap soalan (lalai 40 saat), butang Soalan Seterusnya (kekunci N), Dedah Jawapan (D), Papan Markah (P) dan Skrin Pembukaan (L). Panel memaparkan jawapan betul supaya saya tahu, jadi panel TIDAK boleh ditangkap ke dalam LIVE.
5. Peraturan jawapan: hanya jawapan PERTAMA setiap penonton dikira bagi setiap soalan. Terima komen seperti "b", "B!", "C 🔥" dan "jawapan d". Tolak komen yang meneka semua pilihan seperti "A B C D", dan perkataan biasa seperti "Bagus" atau "Assalamualaikum".
6. Markah: jawapan betul = 100 mata ditambah bonus pantas sehingga 50 mata mengikut baki masa. Jawapan salah = 0.
7. Bila jawapan didedahkan: tunjuk jawapan betul, penerangan ringkas, peratus undian setiap pilihan, dan senarai penjawab betul mengikut kepantasan.
8. Papan markah 10 teratas.
9. Soalan dibaca daripada fail JSON dalam folder soalan/ (format di bawah). Setiap fail menjadi satu set soalan. Kocok susunan pilihan setiap sesi supaya jawapan betul tidak sentiasa di huruf yang sama.
10. Jangan simpan sebarang data penonton ke dalam fail. Markah disimpan dalam memori sahaja.
11. Mod uji tanpa LIVE: butang di panel yang menghantar 12 komen palsu dengan nama rawak, supaya saya boleh menguji tanpa TikTok.
12. Sediakan fail "Mula Kuiz.bat" untuk Windows yang memasang pakej kali pertama, menghidupkan server dan membuka panel dalam browser.

FORMAT FAIL SOALAN
{
"tajuk": "Sejarah T6 Unit 7",
"soalan": [
  {
    "soalan": "Siapakah Perdana Menteri Malaysia yang pertama?",
    "pilihan": ["Tunku Abdul Rahman", "Tun Abdul Razak", "Tun Hussein Onn", "Tun Dr. Mahathir"],
    "jawapan": "A",
    "penerangan": "Tunku Abdul Rahman ialah Perdana Menteri pertama dan digelar Bapa Kemerdekaan."
  }
]
}

REKA BENTUK
Gunakan fon yang jelas dan profesional (contohnya Inter), teks besar dan kontras tinggi supaya mudah dibaca di skrin telefon.

Selepas siap, terangkan cara menjalankan aplikasi ini langkah demi langkah dalam Bahasa Melayu yang mudah.

Bila AI selesai, jalankan aplikasi mengikut arahan yang diberikan (biasanya klik dua kali Mula Kuiz.bat, atau taip npm start). Panel guru akan terbuka dalam browser.

Panel guru untuk mengawal kuiz, dengan pratonton skrin LIVE di sebelah kanan

Langkah 2: Uji Tanpa LIVE Dahulu

Sebelum menyentuh TikTok, pastikan kuiz berfungsi dengan mod uji:

  1. Dalam panel, pilih set soalan dan tekan Soalan Seterusnya.
  2. Tekan butang mod uji. Nama palsu sepatutnya muncul di skrin kuiz dalam beberapa saat.
  3. Tekan Dedah Jawapan, kemudian Papan Markah.

Jika ada yang tidak kena, ceritakan apa yang berlaku kepada AI. Contoh:

Saya tekan butang mod uji tetapi tiada nama muncul di skrin kuiz. Panel menunjukkan soalan sedang dibuka. Semak kod yang menerima komen dan kod yang menghantar keadaan ke skrin kuiz melalui WebSocket. Terangkan puncanya dahulu, kemudian baiki.

Langkah 3: Sediakan Soalan dengan AI

Soalan yang baik ialah separuh daripada kejayaan kuiz. Lampirkan teks atau PDF buku teks bagi unit berkenaan, kemudian gunakan prompt ini:

Anda penggubal soalan [SUBJEK] Tahun [TAHUN] KSSR. Berdasarkan teks buku teks yang saya lampirkan SAHAJA, tulis 20 soalan objektif untuk kuiz TikTok LIVE.

SYARAT
- Setiap soalan mempunyai 4 pilihan dan SATU jawapan betul sahaja.
- Semua fakta mesti datang daripada teks yang dilampirkan. Jangan tambah fakta dari luar.
- Soalan pendek, maksimum 20 perkataan, kerana penonton membaca di skrin telefon dalam masa 40 saat. Setiap pilihan maksimum 6 perkataan.
- Campurkan aras: 50% mengingat, 30% memahami, 20% mengaplikasi.
- Elakkan soalan menghafal tahun atau angka, kecuali tarikh yang sangat penting.
- Jangan gunakan pilihan "Semua di atas" atau "Tiada di atas".
- Pilihan salah mesti munasabah, tetapi jelas salah menurut buku teks.
- Agihkan jawapan betul secara sama rata antara A, B, C dan D.
- Sertakan penerangan satu ayat bagi setiap jawapan, merujuk buku teks.

Keluarkan JSON sahaja dalam format ini, tanpa teks lain:
{
"tajuk": "[SUBJEK] T[TAHUN] Unit [N]",
"soalan": [
  { "soalan": "...", "pilihan": ["...", "...", "...", "..."], "jawapan": "A", "penerangan": "..." }
]
}

Simpan hasilnya sebagai fail .json dalam folder soalan/, kemudian mulakan semula aplikasi.

Jangan terus guna soalan yang dijana AI. Semak dahulu dengan sesi AI yang baharu, supaya ia menyemak tanpa terikat dengan jawapan yang ditulisnya sendiri:

Bertindak sebagai penyemak soalan yang teliti. Semak setiap soalan dalam fail JSON ini berbanding teks buku teks yang saya lampirkan.

Laporkan:
1. Jawapan yang salah.
2. Soalan yang mempunyai lebih daripada satu jawapan betul.
3. Fakta yang tiada dalam buku teks.
4. Bahasa yang tidak tepat atau janggal.
5. Soalan atau pilihan yang terlalu panjang untuk dibaca di skrin telefon.

Jangan ubah fail. Senaraikan setiap isu dengan nombor soalan, sebab, dan cadangan pembetulan.

Dalam pengalaman saya, penyemak bebas menemui 7 isu dalam 75 soalan PSV yang saya jana. Soalan peperiksaan sebenar pun boleh mengandungi soalan yang cacat, contohnya soalan yang ada dua jawapan betul. Jadi langkah semakan ini wajib.

Langkah 4: Sambung ke TikTok LIVE Studio

  1. Buka TikTok LIVE Studio dan pilih mod menegak (portrait).
  2. Tambah sumber Window Capture dan pilih tetingkap skrin kuiz (alamat http://localhost:4321/). Bukan tetingkap panel.
  3. Besarkan sumber itu sehingga memenuhi kanvas 9:16.
  4. Mula LIVE.
  5. Dalam panel, taip nama akaun TikTok cikgu dan tekan Sambung. Tunggu sehingga status menunjukkan bersambung.
  6. Pilih set soalan, dan mulakan kuiz.

Kenapa kandungan perlu berada di 65% atas skrin?

Di telefon penonton, komen LIVE dipaparkan di bahagian bawah skrin dan menutup kira-kira satu pertiga bawah. Jika pilihan jawapan diletakkan di bawah, penonton tidak dapat membacanya. Sebab itu skrin kuiz meletakkan soalan dan pilihan di bahagian atas.

Langkah 5: Uji pada LIVE Sebenar

Ini langkah yang paling kerap dilangkau, dan paling penting. Mod uji tidak membuktikan bahawa komen TikTok sebenar boleh dibaca.

  1. Mula LIVE di komputer (boleh tetapkan sebagai LIVE ujian atau buat pada waktu sunyi).
  2. Dari telefon, buka LIVE itu menggunakan akaun kedua.
  3. Taip a, B! dan Bagus di komen.
  4. Pastikan nama akaun kedua muncul di skrin kuiz, dan Bagus tidak dikira sebagai jawapan.
  5. Lihat skrin LIVE di telefon. Pastikan soalan dan pilihan tidak ditutup oleh komen.

Jika panel menunjukkan “bersambung” tetapi tiada jawapan diterima, gunakan prompt ini:

Panel menunjukkan kuiz sudah bersambung ke LIVE TikTok saya, tetapi komen penonton tidak dikira sebagai jawapan. Tambah log sementara yang mencetak SELURUH objek data bagi komen pertama yang diterima, supaya kita boleh melihat nama medan sebenar untuk teks komen dan nama penonton. Selepas saya hantar hasil log, baiki kod mengikut medan sebenar dan buang log tersebut.
Papan markah 10 teratas selepas tiga soalan

Pelajaran daripada LIVE Pertama Saya

  • Masa 20 saat terlalu pendek. Penonton perlu membaca soalan, membuka papan kekunci dan menaip. 40 saat lebih sesuai.
  • Kocok pilihan jawapan. Bank soalan lama saya mempunyai kira-kira 75% jawapan A. Tanpa kocokan, penonton cepat sedar dan terus menaip A.
  • Papar semua nama yang menjawab. Penonton suka melihat nama sendiri muncul di skrin. Ini menggalakkan mereka terus menjawab.
  • Tambah elemen permainan. Selepas LIVE pertama, saya tambah rentetan 🔥 untuk jawapan betul berturut-turut, soalan bonus dua kali ganda mata, dan skrin Juara di akhir kuiz.
  • Simpan keadaan kuiz. Jika aplikasi terpaksa dimulakan semula di tengah LIVE, markah dan sambungan TikTok perlu pulih secara automatik.

Jika cikgu mahu ciri-ciri ini, gunakan prompt berikut selepas versi asas berfungsi:

Kuiz asas sudah berfungsi. Tambah ciri berikut tanpa mengubah cara jawapan dibaca dari komen:

1. Rentetan: penonton yang menjawab betul berturut-turut mendapat ikon 🔥 dan bilangan rentetan di sebelah nama mereka.
2. Soalan bonus: tandakan soalan tertentu sebagai bonus (mata x2), dengan label BONUS yang jelas di skrin.
3. Dedah automatik: bila masa tamat, papar "Masa tamat!" selama 2.5 saat, kemudian dedah jawapan secara automatik. Sediakan suis di panel untuk menghidupkan atau mematikannya.
4. Papan markah automatik setiap 5 soalan, dan skrin Juara (3 teratas) selepas soalan terakhir.
5. Simpan keadaan kuiz (set soalan, nombor soalan, markah) ke fail setiap kali ia berubah, dan pulihkan secara automatik jika server dimulakan semula dalam masa 2 jam. Nama fail keadaan mesti mengikut nombor port, supaya server ujian tidak menimpa keadaan LIVE.

Uji setiap ciri menggunakan mod uji, dan terangkan kepada saya cara mengujinya.

Masalah Lazim

MasalahPunca biasaPenyelesaian
Gagal sambung, akaun “tidak LIVE”LIVE belum dimulakanMula LIVE dahulu, kemudian tekan Sambung
Bersambung tetapi tiada jawapanMedan komen salahGuna prompt log di Langkah 5
Penonton tidak nampak pilihanKandungan terlalu ke bawahPastikan kandungan dalam 65% atas skrin
Penonton nampak jawapan betulPanel ditangkap ke LIVETangkap tetingkap skrin kuiz sahaja
Sambungan putus di tengah LIVERangkaian atau perubahan TikTokTunggu sambung semula automatik, atau teruskan secara manual dari panel

Penutup

Kuiz ini mengubah ulang kaji yang biasanya sehala menjadi permainan. Murid dan ibu bapa boleh menyertai dari rumah, dan cikgu nampak dengan serta-merta soalan mana yang ramai salah.

Jika cikgu mencuba dan tersangkut di mana-mana langkah, kongsikan di ruangan komen di bawah.

Iklan
Iklan
Iklan

Komen

Kongsi pendapat cikgu, atau soalan lain yang berkaitan.

Cikgu Aime

Cikgu Aime

Guru Sekolah Rendah di SK Putrajaya Presint 5(1). Pembina aplikasi pendidikan — e-Rekod, RPH Assist. Suka berkongsi pengalaman dari bilik darjah ke dunia luar.

Lebih lanjut tentang saya →