GALERI BACAAN MAYA — VERSI 2 Bangunan moden • Satu stesen bacaan • Dewan persembahan PERUBAHAN VERSI INI • Murid bermula di luar bangunan moden, berpandukan gambar rujukan. • Tiada pilihan buku pada muka hadapan. Berjalan masuk untuk memulakan aktiviti. • Satu stesen bacaan membuka koleksi yang boleh terus ditambah oleh guru. • Pintu di dinding belakang menghubungkan galeri dengan dewan persembahan. • Pentas, penonton dan teleprompter teks/video disediakan dalam dewan. • Muzik latar dimainkan berulang sepanjang penerokaan, bacaan dan persembahan. 1. TERBITKAN DI CLOUDFLARE PAGES 1) Log masuk ke papan pemuka Cloudflare. 2) Buka Workers & Pages dan pilih aplikasi Pages dengan Direct Upload / Drag and drop. 3) Namakan projek dan muat naik keseluruhan ZIP ini. 4) Pilih Deploy / Save and Deploy. 5) Selepas selesai, buka pautan pages.dev yang diberikan. ZIP sudah mempunyai index.html di aras utama. Tiada arahan binaan, kunci API, pemasangan npm atau pangkalan data pelayan diperlukan untuk penerbitan ZIP ini. Jika menggunakan Wrangler, ekstrak ZIP dan terbitkan folder hasil ekstrak. Rujukan: https://developers.cloudflare.com/pages/get-started/direct-upload/ 2. BERJALAN DARI LUAR KE DALAM GALERI • Tekan Mulakan perjalanan. Anda masih berada di luar bangunan. • Gunakan W / anak panah atas untuk maju dan S / anak panah bawah untuk undur. • Gunakan A dan D / anak panah kiri dan kanan untuk bergerak ke sisi. • Seret paparan untuk melihat sekeliling. • Pada telefon, tahan anak panah pada skrin untuk berjalan, atau ketik untuk langkah kecil. • Butang Berjalan ke pintu masuk mengikuti laluan secara berjalan, bukan melangkau masuk. • Selepas melalui pintu hadapan, berjalan ke meja bacaan di sebelah kiri laluan tengah. • Butang Berjalan ke stesen bacaan membantu murid mengikuti laluan ke meja itu. • Peta kecil dan label lokasi membantu murid mengetahui kedudukan mereka. • Mula semula mengembalikan murid ke luar bangunan. Pilihan buku hanya muncul selepas murid masuk dan menghampiri stesen bacaan. Mod 3D memerlukan WebGL. Jika WebGL tidak tersedia, mod ringan bergambar digunakan. Mod ringan mengekalkan lokasi, pergerakan, halangan, pintu dan urutan aktiviti yang sama. Versi ini ialah aplikasi pelayar, tanpa mod set kepala WebXR. 3. MEMBACA DAN MENDENGAR AUDIO • Apabila berhampiran stesen, tekan Buka koleksi buku atau buku di stesen. • Pilih sebuah tajuk. Carian tajuk tersedia dalam koleksi. • Gunakan Sebelum / Seterusnya atau kekunci kiri dan kanan untuk menyelak halaman. • A− / A+ menukar saiz tulisan. • Gunakan pemain audio untuk main, jeda, alih kedudukan dan ubah kelantangan bacaan. • Ulang audio memulakan audio semasa dari awal. • Audio khusus halaman digunakan dahulu jika dimasukkan oleh guru. • Audio keseluruhan cerita boleh diteruskan sambil menyelak halaman yang menggunakan rakaman sama. Audio berhenti apabila buku ditutup atau cerita ditukar. • Butang muzik dalam buku menjeda atau menyambung muzik latar secara berasingan. Lima buku ialah kandungan CONTOH. Koleksi tidak dikunci kepada lima buku. Guru boleh menambah buku keenam, ketujuh dan seterusnya. Aplikasi tidak menetapkan kuota tetap bilangan buku. Kapasiti sebenar bergantung pada ruang peranti dan hosting. Halaman terakhir dibaca disimpan dalam pelayar peranti tersebut. Audio contoh ialah suara sintetik Bahasa Melayu dan boleh digantikan oleh guru. 4. PINTU KE DEWAN DAN PERSEMBAHAN • Pintu berlabel DEWAN PERSEMBAHAN berada di tengah dinding belakang galeri. • Berjalan melalui pintu itu atau gunakan Ke dewan untuk mengikuti laluan berjalan. • Dalam dewan, penonton berada di bahagian bawah pentas dan menghadap pentas. • Ikut lorong tengah dan tangga, atau tekan Berjalan naik ke pentas. • Setelah berada di atas pentas, tekan Pilih cerita persembahan / Teleprompter. • Pilih mana-mana buku dalam koleksi untuk dipersembahkan. • Jika guru menambah video, video tersebut boleh dimainkan pada teleprompter. • Jika video belum tersedia, teks daripada buku digunakan sebagai panduan. • Mulakan teks bergerak menggerakkan teks secara automatik; pelaras Kelajuan teks membolehkan murid menyesuaikannya dengan kelajuan bacaan sendiri. • Ulang dari awal mengembalikan teks atau video ke permulaan. • Besarkan panel / Pandangan pentas menukar saiz panel sambil melihat penonton. • Besarkan paparan membuka teleprompter dalam skrin penuh jika disokong. • Tutup teleprompter menamatkan main balik cerita; muzik latar terus bermain. • Ke galeri mengikuti laluan berjalan untuk kembali ke ruang bacaan. 5. MUZIK LATAR BERULANG • Muzik bermula selepas murid menekan Mulakan perjalanan. • Satu lagu instrumental asal dibekalkan sebagai contoh. • Muzik terus dimainkan semasa membaca dan semasa persembahan. • Ulangan dihidupkan secara automatik: lagu bermula semula apabila tamat. • Gunakan Mainkan muzik / Jeda muzik dan pelaras kelantangan pada paparan galeri. • Butang muzik juga tersedia dalam buku dan panel persembahan. • Jika pelayar menolak permulaan audio automatik, tekan Mainkan muzik sekali. Untuk guru: 1) Buka Panel Guru. 2) Kembangkan Muzik latar galeri · ulangan automatik. 3) Tekan Muat naik lagu sendiri dan pilih fail audio. 4) Pilih kelantangan lalai serta sama ada muzik dimainkan semasa aktiviti. 5) Tetapan disimpan pada peranti. Eksport ZIP untuk berkongsi dengan semua murid. 6) Buang lagu memadam pilihan muzik semasa; Guna muzik contoh memulihkan lagu asal. 6. PANEL GURU DAN BUKU TAMBAHAN Panel Guru mengurus draf pada pelayar/peranti semasa. Ia tidak menggunakan akaun atau kata laluan pelayan. Suntingan pada peranti murid tidak mengubah laman yang telah diterbitkan. Guru berkongsi perubahan melalui ZIP terbitan baharu. Tambah buku: 1) Tekan Tambah buku. 2) Isikan tajuk, penulis dan penerangan ringkas. 3) Muat naik gambar kulit buku jika dikehendaki. 4) Isi teks setiap halaman; tambah, susun semula atau padam halaman mengikut keperluan. 5) Tambah ilustrasi dan audio bagi setiap halaman atau audio keseluruhan cerita. 6) Muat naik video teks cerita untuk teleprompter jika tersedia. 7) Tekan Simpan buku. Ubah buku: pilih tajuk, ubah kandungan dan tekan Simpan buku. Buang buku: pilih tajuk, tekan Padam buku dan sahkan tindakan. Gambar, audio atau video boleh dibuang secara berasingan tanpa memadam buku. Satu buku memerlukan sekurang-kurangnya satu halaman; maksimum 200 halaman setiap buku. Gambar: PNG, JPG, WebP atau GIF. Audio: MP3 disyorkan; WAV, OGG, M4A, AAC, WebM dan FLAC turut diterima. Video: MP4 atau WebM. Keserasian media bergantung pada codec peranti/pelayar. Saiz maksimum setiap fail media: 20 MB, sesuai untuk pakej statik Cloudflare Pages. 7. TERBITKAN PERUBAHAN DAN BUAT SANDARAN Simpan buku dan tetapan muzik menyimpan draf pada peranti guru. Untuk membolehkan semua murid melihat perubahan: 1) Selesaikan suntingan buku dan tekan Simpan buku. 2) Tekan Sediakan ZIP Cloudflare. 3) Selepas siap, tekan pautan Muat turun ZIP siap. 4) ZIP membawa aplikasi, semua buku, ilustrasi, audio, video dan muzik yang digunakan. 5) Dalam projek Cloudflare Pages yang sama, pilih Create a new deployment. 6) Muat naik ZIP baharu dan terbitkan ke Production. 7) Murid memuat semula pautan laman untuk mendapatkan versi terkini. Simpan ZIP sebagai sandaran sebelum menukar peranti atau memadam simpanan pelayar. Terbitan baharu mempunyai kod koleksi baharu supaya draf lama tidak mengatasi kandungan yang baru diterbitkan. 8. IMPORT KOLEKSI DAN PINDAH PERANTI • Panel Guru > Import koleksi ZIP. • Pilih ZIP asal atau ZIP yang dieksport oleh aplikasi. • Sahkan penggantian koleksi setempat. • Buku, media, video dan tetapan muzik akan diimport bersama apabila terdapat dalam ZIP. • ZIP versi pertama juga boleh diimport untuk mengambil semula koleksi buku lama. • Selepas import versi lama tanpa muzik, guru boleh menekan Guna muzik contoh. • Import menggantikan draf koleksi setempat; eksport dahulu jika memerlukan sandaran. 9. PENGGUNAAN SETEMPAT Gunakan pelayan web, bukan klik dua kali pada index.html. Jika Python tersedia, buka terminal dalam folder ekstrak: python -m http.server 8000 Kemudian buka http://localhost:8000 dalam pelayar. 10. FAIL DALAM PAKEJ index.html / styles.css — paparan aplikasi dan kawalan app.js — buku, audio, video, muzik, Panel Guru, import dan eksport world.js — bangunan moden, galeri, pintu, dewan dan pentas navigation.mjs — pergerakan, halangan dan laluan berjalan content.mjs — format koleksi dan media catalog.json — kandungan yang diterbitkan package-files.json — senarai fail untuk eksport assets/ — gambar galeri, ilustrasi, audio, lagu dan media vendor/ — Three.js dan JSZip berserta lesen Semua pustaka dan aset asas disertakan. Tiada CDN luaran diperlukan. Gambar bangunan rujukan digunakan dengan arahan pengguna. Latar dalaman dan dewan dijana untuk projek ini. Cerita contoh, ilustrasi vektor dan muzik instrumental contoh disediakan sebagai bahan asal yang boleh digantikan oleh guru.