GEMA 360 — Versi 38

PAPARAN TELEFON & JOYSTICK
Panel guru, Ahli, chat, buku dan video disesuaikan untuk telefon menegak dan melintang. Panel panjang boleh ditatal.
Sentuh ruang dunia pada separuh kiri skrin untuk memunculkan joystick di tempat sentuhan. Seret untuk bergerak dan membelok; lepaskan untuk berhenti dan menyembunyikannya.
Sentuhan pada butang atau panel tidak mengaktifkan joystick. Bahagian kanan masih boleh diseret untuk kamera. Ketik kerusi atau alat permainan untuk berinteraksi.
Joystick tidak muncul ketika duduk, bermain, dialog terbuka atau pergerakan dikunci guru semasa persembahan.

KOMUNIKASI SUARA & CHAT (v38)
Selepas masuk Bilik Bersama, tekan ikon mikrofon + speaker untuk kawalan suara. Ikon chat berasingan membuka kotak mesej. Butang yang sama tersedia dalam ruang menunggu dan panel guru.
Chat: taip mesej dan tekan Hantar. Nama pendaftaran dipaparkan. Semua ahli bilik boleh membaca mesej. Maksimum 500 aksara; 50 mesej terkini tersedia dalam sesi.
Suara: tekan Dengar suara pada setiap peranti. Untuk bercakap, tekan Buka mikrofon dan benarkan permintaan mikrofon pelayar. Tiada kamera diminta atau rakaman suara dibuat oleh aplikasi.
Gunakan pautan HTTPS. Fon kepala disarankan bagi mengurangkan gema.

PERATURAN MIKROFON MURID
- Di luar galeri: mikrofon boleh dibuka. Hampiri rakan untuk berbual.
- Dalam galeri: masuk Bulatan Bicara berwarna biru kehijauan di laluan tengah. Dalam mod ringan, ketik penanda Bulatan Bicara untuk berjalan ke situ.
- Dalam dewan: hanya murid yang dipilih guru dan berada di pentas boleh membuka mikrofon. Suara pentas mempunyai jarak dengar lebih luas untuk penonton dewan.
- Di kawasan lain: mikrofon ditutup secara automatik. Setelah kembali ke kawasan dibenarkan, murid perlu menekan Buka mikrofon semula.
- Di ruang menunggu: mikrofon murid ditutup; chat masih tersedia.
- Perbualan biasa semakin perlahan mengikut jarak (sehingga kira-kira 8 unit dunia). Dinding memisahkan suara luar, galeri dan dewan.

KAWALAN GURU
Tekan ikon Ahli di sebelah Menu atau butang Ahli dalam panel guru.
Di sebelah setiap nama, ikon mikrofon membenarkan/menutup mikrofon; Ikut kawasan mengembalikan peraturan biasa.
Ikon speaker mengawal suara perbualan yang didengar murid tersebut, termasuk suara guru. Ini tidak mengubah audio buku, video atau muzik latar.
Klik nama murid untuk kamera guru mengikutnya. Naik Pentas tersedia selepas semua murid duduk di dewan. Turun & Duduk hanya tersedia bagi murid yang sedang membuat persembahan.
Tutup Chat Kelas menutup kotak chat murid dan menyekat penghantaran mesej pada pelayan. Buka Semula Chat Kelas membenarkan mesej semula. Sejarah chat kekal. Butang × hanya menutup kotak pada peranti sendiri.
Benarkan mikrofon memberi pengecualian kawasan, tetapi murid mesti menghidupkannya sendiri; guru tidak boleh menghidupkan perkakasan mikrofon secara senyap.
Tutup semua mikrofon murid menutup mikrofon semua murid. Kembali ikut kawasan mengembalikan peraturan biasa.
Guru boleh bersuara di semua kawasan; suara guru didengar oleh semua ahli yang telah menekan Dengar suara. Guru boleh mendengar murid yang sedang membuka mikrofon tanpa sekatan jarak.
Apabila murid turun dari pentas atau keluar kawasan dibenarkan, mikrofon ditutup. Keluar bilik / Log Keluar / Tamatkan Sesi menutup sambungan suara dan melepaskan mikrofon.

JIKA SUARA BELUM BERFUNGSI
Pastikan semua peranti menggunakan aplikasi dan pelayan v38, kod kelas sama, serta telah menekan Dengar suara.
Benarkan mikrofon dalam tetapan laman, semak kelantangan dan cuba Sambung semula suara.
Aplikasi menggunakan WebRTC langsung dengan STUN. Sesetengah rangkaian sekolah, data mudah alih atau NAT memerlukan pelayan perantara TURN.
Sokongan TURN disediakan pada Worker, tetapi pelayan TURN dan kelayakannya tidak dibekalkan dalam ZIP. Rujuk TETAPAN_SUARA_TURN.txt dalam ZIP pelayan jika rangkaian menghalang suara.
Lebih banyak mikrofon serentak memerlukan lebih banyak sambungan dan kuasa peranti. Uji sesi pada peranti sebenar sebelum digunakan dengan seluruh kelas.

PENGUJIAN KOMUNIKASI
Ujian automatik polisi kawasan, jarak, kawalan guru, identiti chat, pertukaran isyarat terhad kepada ahli, pelepasan mikrofon dan pembatalan kebenaran telah lulus.
Paparan chat, penghantaran/akui mesej dan kawalan mikrofon diuji melalui halaman ujian pelayar dengan pelayan simulasi.
Pertukaran offer/answer WebRTC sebenar berjaya dalam pelayar ujian, tetapi tiada calon ICE disediakan oleh rangkaian pelayar tersebut. Penghantaran audio sebenar antara dua peranti belum disahkan.

PEMASANGAN
1. Ekstrak ZIP aplikasi utama. Dalam folder sokongan, ekstrak pelayan-bilik-v38.zip ke folder baharu.
2. Buka Command Prompt dalam folder pelayan yang mengandungi worker.mjs dan wrangler.jsonc.
3. Jalankan npx wrangler@4 deploy. Jika diminta, taip y. Kunci guru sedia ada kekal.
4. Buka https://galeri-bilik-bersama.izzat310504.workers.dev dan pastikan "version":38.
5. Di Cloudflare > Workers & Pages > membaca, cipta deployment Production dan muat naik ZIP aplikasi utama.
6. Buka https://membaca-7oa.pages.dev, muat semula pada peranti guru dan murid. Pastikan v38 dipaparkan.
7. Tamatkan bilik lama dan cipta kod kelas baharu.

ALIRAN KELAS
Guru log masuk menggunakan kata kunci sedia ada, cipta kod kelas, kongsi kod atau pautan.
Murid mendaftar nama, kelas dan karakter. Semua menunggu sehingga guru menekan Mula.
Guru menggunakan kamera tanpa karakter. Pilih murid untuk diikuti, atau Kamera Bebas untuk bergerak sendiri.
Kamera Bebas tidak naik atau menghadap penonton secara automatik di tangga pentas.
Butang Kumpul pada peta mengumpulkan murid ke Taman, Galeri atau Dewan.

PERSEMBAHAN
Kumpulkan murid di dewan dan tunggu semua murid memilih kerusi dan duduk.
Pilih nama di senarai kiri, kemudian Naik ke Pentas. Karakter menuju ke pentas secara automatik.
Semua kawalan pergerakan murid dikunci sepanjang sesi persembahan, termasuk murid yang membuat persembahan.
Pilih cerita pada teleprompter: kiraan 3, 2, 1, Mula! muncul sebelum teks bergerak.
Video cerita boleh dipilih melalui kawalan Video selepas kiraan berakhir.
Selepas Selesai Persembahan, hanya guru boleh menekan Turun & Duduk untuk mengembalikan murid ke kerusi asal.
Murid tetap tidak boleh bangun atau berjalan. Guru boleh memilih giliran seterusnya selepas murid duduk.
Tekan Tamatkan Sesi Persembahan untuk membenarkan semua murid bergerak semula.
Tamatkan Sesi menutup keseluruhan bilik dan mengeluarkan semua murid.

AUDIO REAKSI
Panel Guru > Hiasan & Muzik > Tepukan & Sorakan.
Muat naik audio tepukan dan sorakan secara berasingan (maksimum 20 MB setiap fail).
Gunakan Pratonton dan pelaras kelantangan, atau Buang audio.
Jika tiada rakaman sendiri, audio contoh gabungan digunakan.
Jika hanya satu rakaman sendiri dimuat naik, rakaman itu digunakan; muat naik kedua-duanya untuk gabungan tepukan dan sorakan sendiri.
Simpan & Terbitkan > Eksport ZIP, kemudian muat naik ZIP baharu ke Pages supaya semua peranti menerima audio tersebut.

VIDEO
Jendela Ilmu: maksimum 100 MB bagi setiap fail video MP4 / WebM.
Laman Hikayat: maksimum 200 MB bagi setiap fail video MP4 / WebM.
Fail yang tepat pada had dibenarkan, fail yang melebihi had ditolak.
Pilih MP4 H.264 / audio AAC untuk keserasian telefon.
Video besar dimasukkan ke dalam ZIP sebagai bahagian media; aplikasi menyambung bahagian tersebut semula ketika menonton. Jangan padam media-index.json atau folder media/chunks.
Murid perlu menunggu video besar selesai dimuat turun. Prestasi bergantung pada sambungan dan memori peranti.
Muat naik disimpan dalam pelayar guru. Eksport ZIP dan terbitkan semula untuk berkongsi dengan murid.
Import ZIP disokong sehingga 500 MB keseluruhan; koleksi lebih besar boleh menggunakan lebih banyak memori pelayar.

HIASAN
Karpet merah di laluan tengah dewan dan tangga menuju pentas.
Bingkai warna, hiasan dinding dan panji dewan ditambah di sisi atau atas ruang.
Jalur kuning pada dinding di hadapan TV Laman Hikayat dibuang.
Nama putih kekal di atas kepala. Emoji dan aksi boleh dipilih pada skrin murid.

BUKU
Muat naik gambar lengkap yang mengandungi grafik dan teks. Kulit depan diikuti pasangan halaman dan kulit belakang.
Buku Bacaan tanpa audio. Buku dengan Audio menyediakan audio di bawah setiap halaman.
PDF boleh ditukar kepada halaman bergambar melalui panel buku Fiksi / Bukan Fiksi.
Teks persembahan diurus dalam bahagian teks teleprompter.

PENGESAHAN
Ujian automatik: had video, pembungkusan/pembinaan semula video 200 MB, kiraan masa dan pembatalan, kunci gerakan, arahan guru, semua 40 laluan kerusi, pembinaan geometri 3D dan simpanan rujukan audio.
Pelayar ujian membuka aplikasi dalam mod ringan; WebGL tidak tersedia di persekitaran ujian. Uji paparan 3D, sentuhan telefon dan sesi berbilang peranti selepas penerbitan.