Berbagi rekaman
Cara pelajar dapat memberikan rekaman bacaan mereka kepada Quran Lab, apa yang dibagikan, dan apa yang tidak pernah dilihat pengembang.
Pelajar dapat memberikan audio bacaan mereka kepada Quran Lab, untuk membantu model bacaan terbuka mendengar dengan lebih baik: sedekah jariyah bagi yang memilihnya. Tidak ada yang perlu dinyalakan atau dimatikan di aplikasi Anda. Quran Lab memutuskan, untuk setiap aplikasi dan platform, kapan pelajar ditanya, dan SDK bertanya kepada mereka dengan lembarnya sendiri. Tidak ada yang direkam sebelum pelajar setuju, dan Anda tidak pernah melihat rekamannya.
Siapa yang memutuskan
Quran Lab yang memutuskan, dari pihaknya sendiri, di dalam konfigurasi bertanda tangan yang dibaca setiap instalasi: apakah pelajar suatu aplikasi ditanya atau tidak sama sekali, dan di platform mana saja. Tidak ada opsi di kode Anda atau di portal yang menyalakan atau mematikan berbagi untuk aplikasi Anda; setiap pelajar memutuskan sendiri.
Cara pelajar ditanya
Lembar bawaan SDK, dalam bahasa pelajar (Inggris, Arab, Indonesia, Urdu, Turki, Melayu, Prancis, Bengali), muncul setelah sebuah take (satu kali bacaan yang didengarkan SDK dari awal sampai akhir) selesai dan model mendengar ucapan di dalamnya. Lembar ini tidak pernah muncul saat aplikasi pertama kali dijalankan. "Bagikan bacaan saya" dan "Nanti saja" memiliki penekanan yang sama. Pelajar melihat lembar ini paling banyak tiga kali dalam satu instalasi: pelajar yang menjawab "Nanti saja" ditanya lagi paling banyak dua kali, dengan jarak paling sedikit 7 sesi. Pelajar yang setuju tidak pernah ditanya lagi.
Di aplikasi untuk anak-anak (audiens SDK diatur ke anak-anak), lembar bertanya kepada orang tua atau wali. Anda boleh memilih sendiri saatnya (sharing.ask()), dan mengubah tampilan lembar (lihat di bawah). Halaman aplikasi Anda menampilkan lembar ini dalam setiap bahasa.
Apa yang dibagikan
Hanya setelah pelajar setuju, dan selama berbagi tetap aktif, yang dibagikan adalah audio setiap sesi bacaan selama SDK mendengarkan (dikompresi dalam format Ogg Opus), versi model, keluarga perangkat, versi mayor OS, dan tanggalnya, dengan kode kontribusi acak. Tidak ada nama, akun, kontak, lokasi, atau pengenal perangkat yang dibagikan.
Kata-kata di lembar ini adalah paket teks SDK: yang terbaru adalah versi 2026-11-13.1 (persetujuan share-2026-11-09), dan setiap rilis SDK membawa paket teks yang dirilis bersamanya. Saat Quran Lab memperbarui kata-kata itu, pelajar yang sudah setuju tidak ditanya lagi, dan sesi mereka tetap memakai versi yang mereka setujui.
Ke mana rekaman dikirim
Rekaman dikirim langsung dari perangkat ke penyimpanan Quran Lab di Uni Eropa. Rekaman diunggah di latar belakang, dan unggahan dilanjutkan setelah restart. Quran Lab adalah wakaf: model yang dilatihnya gratis dan tidak pernah dijual.
Anda, kunci Anda, dan aplikasi Anda tidak dapat membuka, mengunduh, atau menghapus rekaman. Halaman aplikasi Anda hanya menampilkan jumlah: berapa kali pelajar ditanya, berapa yang berbagi atau menolak, dan menit yang dibagikan, masing-masing tampil mulai 10.
Berhenti dan menghapus
Saat pelajar mematikan sakelar, unggahan langsung berhenti. "Hapus yang saya bagikan" di baris pengaturan SDK langsung menghapus semua yang telah dibagikan dengan kode kontribusi itu dari server Quran Lab. Hanya pelajar yang dapat melakukannya: permintaannya ditandatangani dengan kunci penandatanganan yang tidak pernah keluar dari perangkatnya. Di sdk.quranlab.ai/delete, pelajar yang kehilangan perangkatnya memakai kode pemulihan sekali pakai yang pernah ditampilkan SDK kepadanya.
Di mana berbagi berfungsi
Di setiap SDK. Aplikasi Apple membuktikan instalasinya dengan App Attest, dan aplikasi Android dengan Google Play Integrity. Halaman web serta aplikasi Windows atau Linux tidak dapat membuktikan instalasinya, sehingga keduanya berbagi dengan tingkat kepercayaan lebih rendah: lebih sedikit sesi per hari, per aplikasi dan per pelajar, dan sesinya ditandai agar pelatihan dapat menimbangnya secara terpisah.
Di dalam kode Anda
Berbagi diakses melalui Client, client.sharing, dengan anggota yang sama di setiap SDK (panggilan tf_sharing_ di C):
| Anggota | Arti |
|---|---|
isAvailable |
Konfigurasi Quran Lab mengizinkan berbagi untuk aplikasi ini |
isOn |
Pelajar sudah setuju |
setOn(on) |
Sakelar milik pelajar di pengaturan aplikasi Anda, dan hanya dipanggil dari sakelar itu. Jika dimatikan, unggahan langsung berhenti dan antrean yang belum terkirim dihapus |
ask() |
Bertanya sekarang, pada saat yang Anda pilih sendiri, jika masih diizinkan bertanya |
feed(samples, sampleRate) |
Audio yang sudah ditangkap aplikasi Anda di luar take, agar rekaman yang dibagikan tidak dimulai atau berakhir di tengah kata |
items |
Kotak keluar: status setiap rekaman |
summary() |
Ringkasan pelajar, untuk baris ucapan terima kasih |
delete() |
"Hapus yang saya bagikan" |
recoveryCode |
Kode untuk penghapusan saat perangkat hilang |
setWording(overrides) |
Redaksi Anda sendiri untuk baris mana pun di lembar |
Jika konfigurasi Quran Lab tidak mengizinkan berbagi untuk aplikasi itu, panggilan berbagi gagal dengan galat sharing_unavailable. Periksa isAvailable sebelum Anda menampilkan pengaturan berbagi.
Buat tampilan lembar seperti aplikasi Anda
Ada tiga cara, dan pada ketiganya pilihan pelajar tetap sama. Pertahankan penekanan yang sama pada kedua tombol, dan jangan centang apa pun sejak awal.
Sesuaikan tampilan lembar bawaan. Warna, huruf, dan sudut; kata-kata dan versi persetujuan tidak berubah. Di web, lembar membaca properti kustom CSS:
quranlab-consent {
--ql-bg: #fff; --ql-fg: #1d1d1f; --ql-muted: #6e6e73;
--ql-accent: #0f766e; --ql-accent-fg: #fff;
--ql-radius: 20px; --ql-font: inherit;
}Di Android dan Apple, SharingTheme melakukan hal yang sama untuk lembar dan baris pengaturan milik SDK. Pustaka C tidak menggambar lembar: aplikasi Anda menampilkannya dari paket teks yang diberikan SDK ke callback persetujuannya.
Layar Anda sendiri, yang dibangun dari teks SDK: baris yang sama dalam setiap bahasa yang dibawa SDK. Laporkan ke SDK ketukan yang dilakukan pelajar sendiri. Layar Anda sendiri dihitung sama seperti lembar SDK: pertanyaan yang sama, aturan "Nanti saja" yang sama, dan tidak ada yang direkam sebelum pelajar sendiri setuju.
Redaksi Anda sendiri. setWording menerima kata-kata Anda untuk baris mana pun di lembar, dan disetel setiap kali aplikasi dijalankan. Pelajar kemudian menyetujui kata-kata Anda: setiap sesi yang mereka bagikan membawa versi yang dibuat dari kata-kata itu (custom- diikuti 24 digit heksadesimal) serta SHA-256 dari teks lengkapnya, sehingga Quran Lab melihat dengan tepat apa yang disetujui. SDK memberikan teks dan hash itu kepada Anda; kirimkan keduanya ke Quran Lab untuk ditinjau (asisten pemrograman Anda mencatatnya bersama deklarasi aplikasi Anda). Kata-kata Anda tetap harus menyatakan bahwa audio sesi bacaan dikirim ke Quran Lab, apa lagi yang dikirim, untuk apa, serta cara berhenti dan menghapus. Pelajar yang sudah setuju sebelumnya tidak ditanya lagi dan tetap memakai versi yang mereka setujui.
Nama persisnya untuk versi SDK Anda ada di README-nya.