How it Works
The library maintains two independent playback systems, each with its own reciters, URLs, and mechanisms:
| System | Description | Reciters | Sources |
|---|---|---|---|
Surah (SurahAudioController) |
One MP3 per full surah | 21 | quranicaudio.com, mp3quran.net, tarteel.ai |
Ayah (AyahAudioController) |
One MP3 per ayah | 12 | cdn.islamic.network, everyayah.com |
They share a single AudioPlayer via a coordination layer (AudioEngine). When one system takes control, the other is automatically stopped and its state is reset.
- Auto-advance: Ayahs play sequentially (playlist + windowing); surahs auto-advance to the next (1→114) on completion.
- Smart controls:
pause()/resume()/next()/previous()execute on whichever system is currently active. - Direct access: For advanced use, the controllers are exposed via
QuranAudio.surahControllerandQuranAudio.ayahController.