Panduan Pengguna

1. Pendahuluan

Selamat datang di Aplikasi Tajwid Al-Qur'an — platform pembelajaran interaktif yang mengajarkan hukum-hukum tajwid, memverifikasi pelafalan Anda saat tilawah, menguji hafalan Anda, dan menjawab pertanyaan Anda tentang Al-Qur'an dan hukum tajwid.

Teks Al-Qur'an selalu ditampilkan dalam Rasm Utsmani Arab. Antarmuka aplikasi (tombol, menu, dan penjelasan) diterjemahkan ke lebih dari 68 bahasa sesuai pilihan Anda dari daftar bahasa di bagian atas halaman.

2. Dasbor dan Tab

Saat membuka aplikasi, tiga tab utama akan muncul:

Setiap ubin hukum membuka halaman yang menampilkan ayat-ayat di mana hukum tersebut muncul dengan pewarnaan kata, suara qari referensi, dan terjemahan/tafsir ayat sesuai bahasa tampilan.

3. Bahasa dan Bantuan

Memilih Bahasa

Di kiri atas setiap halaman (atau kanan atas untuk bahasa kanan-ke-kiri) Anda akan menemukan daftar Bahasa. Pilih bahasa Anda — tombol menu, judul, dan penjelasan akan segera berubah. Bahasa default adalah Arab.

Tombol Bantuan

Di samping daftar Bahasa terdapat tombol «Bantuan». Ini akan membuka panduan ini dalam bahasa Anda saat ini di jendela baru. Jika terjemahan bahasa Anda belum tersedia, panduan akan ditampilkan dalam bahasa Arab.

Kembali ke Dasbor

Tombol «Dasbor Hukum Tajwid» di kanan atas halaman akan mengembalikan Anda ke halaman utama dari halaman sub-apapun.

4. Halaman Hukum Tajwid

Setiap halaman hukum menampilkan:

• Definisi hukum dalam bahasa Arab dengan terjemahan/transliterasi dalam bahasa tampilan.
• Tabel atau mushaf yang menyoroti kata-kata yang terpengaruh dengan warna khusus.
• Pilihan qari dan pemutaran audio ayat atau halaman.
• Penyorotan kata selama pemutaran (karaoke): Penyorotan bergerak bersama qari kata demi kata.
• Kolom terjemahan: dari Kalimat.dev atau tafsir lokal sesuai bahasa yang dipilih.

Memutar Audio dan Memilih Kata

• Klik tunggal pada kata: Memilihnya sebagai titik awal (penyorotan biru langit).
• Klik tunggal pada kata lain: Memperluas pilihan menjadi rentang antara dua kata.
• Klik di dalam rentang yang dipilih: Memutar audio hanya untuk rentang yang dipilih dengan pelacakan bacaan (karaoke).
• Klik di luar rentang: Mengatur ulang pilihan ke kata baru yang diklik.
• Klik ganda: Memilih kata dan membacanya secara individual.
• Seret (Sentuh/Seret Mouse): Untuk memilih bagian dengan satu sentuhan dan memutarnya segera setelah dilepaskan.
• Tombol «Dengarkan»: Membaca dari kata yang dipilih hingga akhir ayat (dalam mode ayat dan halaman) dengan pewarnaan karaoke untuk kata-kata.
• Tombol «Ulangi»: Memutar ulang bagian yang dipilih dalam lingkaran untuk latihan.
• Klik di luar area ayat: Membatalkan pilihan sehingga tombol «Dengarkan» kembali membaca ayat dari awal.

5. Tilawah Cerdas (Koreksi Pelafalan)

Halaman /r/recite/ memungkinkan Anda untuk tilawah di depan mikrofon dengan verifikasi kata demi kata menggunakan model transkripsi Al-Qur'an khusus (Whisper).

Tata Letak Layar

Dari atas ke bawah:

1. Area Kontrol: Pemilihan surah, rentang (ayat/halaman/surah), qari, mikrofon, dan ambang batas penerimaan.
2. Bilah Navigasi: Putar/hentikan audio ayat, lalu tombol « » untuk ayat, « › » untuk kata, dan untuk mengulang.
3. Panduan Warna Tajwid: Muncul tepat di atas teks ayat untuk memudahkan referensi selama tilawah.
4. Teks Ayat: Kata-kata yang diwarnai dan disorot untuk kata saat ini.

Memulai Tilawah

1. Pilih surah dan rentang (satu ayat direkomendasikan untuk pemula).
2. Teks ditampilkan secara otomatis saat halaman dibuka atau surah diubah.
3. Masukkan alamat email Anda (disimpan sekali untuk semua halaman).
4. Tekan «Mulai Tilawah» dan izinkan browser mengakses mikrofon.
5. Baca kata yang disorot; jika pelafalan benar, kata akan berubah menjadi hijau dan penyorotan akan berpindah ke kata berikutnya.

Tombol Navigasi

Ambang Batas Penerimaan Kata

Anda dapat menyesuaikan batas kepercayaan minimum (dari 30% hingga 70%) melalui penggeser. Sebuah kata diterima jika pelafalannya mencapai atau melebihi batas ini. Kata di bawah ambang batas akan ditampilkan nilainya dalam warna oranye untuk membantu Anda meningkatkan.

Pewarnaan Hukum Tajwid

Aktifkan «Pewarnaan Hukum Tajwid» untuk melihat warna petunjuk pada kata-kata (قلقلة (Qalqalah), غنة (Ghunnah), إخفاء (Ikhfāʾ), إظهار (Iẓhār), لام الجلالة (Lām al-Jalālah)…). Ini dapat dimatikan jika Anda menginginkan mushaf tanpa warna.

Penilaian Hukum Tajwid (Opsional)

Saat «Penilaian Hukum Tajwid» diaktifkan, المد (Madd), الغنة (Ghunnah), dan القلقلة (Qalqalah) juga akan diperiksa secara akustik — kepercayaan audio saja tidak cukup.

Pencarian dengan Tilawah

Tekan «Pencarian dengan Tilawah» dan baca beberapa kata; aplikasi akan menampilkan ayat-ayat yang cocok. Pilih sebuah ayat untuk membukanya secara langsung.

Nilai Kata dan Hapus

Saat kembali ke ayat yang sudah dibaca, nilai Anda akan muncul pada setiap kata. Gunakan «Hapus Nilai Rentang» untuk menghapus nilai ayat/halaman/surah dan mencoba lagi.

6. Ujian Hafalan (Tasmi')

Halaman /r/hifz/ menguji hafalan Anda: ayat dimulai kosong, dan setiap kata muncul saat diucapkan dengan benar.

• Tekan «Mulai» dan baca dari ingatan; kata-kata yang benar akan muncul secara bertahap.
• Kesalahan pelafalan akan menghasilkan nada peringatan tanpa mengungkapkan kata tersebut.
• Anda dapat «Tampilkan Kata» atau «Tampilkan Ayat» secara manual sebagai petunjuk.
• Transisi ke ayat berikutnya manual kecuali jika Anda menyelesaikan seluruh ayat dengan benar.
• Nilai kumulatif untuk surah dan seluruh Al-Qur'an akan dicatat dan terkait dengan email Anda.

7. Asisten Cerdas

Dari tab «Asisten Cerdas» atau halaman /r/chatbot/ Anda dapat mengajukan pertanyaan tentang:

• Hukum tajwid (Apa itu الإخفاء (Ikhfāʾ)? Di mana letaknya di سورة (Surah) …?)
• Teks Al-Qur'an (Berapa ayat dalam Juz Amma? Ayat-ayat yang mengandung kata …)
• Pencarian berdasarkan akar kata, pengulangan, atau Rasm Imlai/Utsmani

Asisten menggunakan basis pengetahuan tajwid dan database Al-Qur'an dengan Gemini-2.5-flash untuk menjawab dalam bahasa Anda. Anda dapat:

• Memperluas kotak pertanyaan (seret tepi bawah atau ketik beberapa baris dengan Shift+Enter).
• Membuka percakapan baru, mengarsipkannya, menghapusnya, atau mengunduhnya dalam format PDF/Markdown.
• Menggunakan pertanyaan sampel untuk memulai dengan cepat.

8. Nilai dan Laporan

Masukkan email Anda sekali — ini akan digunakan untuk tilawah, hafalan, dan ujian tajwid. Nilai disimpan dalam database dan Anda dapat:

• Melihat nilai kumulatif untuk surah dan Al-Qur'an di bilah status.
• Meninjau percobaan Anda sebelumnya untuk setiap ayat.
• Meminta «Kirim Laporan PDF Saya» untuk mengirim laporan terperinci ke email Anda (rata-rata, tertinggi, terendah, tanggal).

9. Pengaturan Audio

Dari tombol «Audio» di halaman tilawah atau hafalan:

• Mikrofon: Pilih perangkat input jika ada lebih dari satu.
• Speaker: Pilih perangkat output (didukung di Chrome/Edge; mungkin tidak berfungsi di Safari).
• Indikator Level: Bilah hijau yang menunjukkan kekuatan suara Anda saat tilawah.
• Diagnostik: Log teknis untuk memecahkan masalah transkripsi (tambahkan ?debug=1 ke tautan).

10. Pertanyaan Umum

Mengapa aplikasi mengharapkan kata-kata yang tidak saya ucapkan (seperti Basmalah)?

Beberapa qari memulai dengan Basmalah sebelum «الم» atau «آلم» di awal surah. Kami telah memperbaikinya dengan mendeteksi pembukaan dan menyelaraskan kembali. Jika masalah berlanjut, gunakan diagnostik atau coba lagi setelah tiga percobaan gagal, aplikasi akan secara otomatis berpindah.

Apakah berfungsi di ponsel?

Ya — Chrome di Android dan Safari di iOS. Anda mungkin perlu klik pertama untuk mengaktifkan audio (kebijakan browser).

Apakah data saya pribadi?

Nilai terkait dengan email Anda dan terisolasi antar pengguna. Rekaman audio tidak dibagikan dengan pihak ketiga — hanya diproses di server untuk verifikasi.

Dari mana terjemahan ayat-ayat berasal?

Kalimat.dev, database lokal, atau Tafsir Jalalain yang diterjemahkan melalui Gemini untuk bahasa yang tidak didukung — bukan terjemahan langsung teks Al-Qur'an oleh kecerdasan buatan.