Mulai cepat Flutter
Plugin Flutter untuk Android dan iOS segera hadir. Sampai plugin itu ada di pub.dev, panggil SDK Android dan SDK Apple dari kode platform aplikasi Anda.
Plugin Flutter quranlab_tajweedformer segera hadir. Plugin ini belum ada di pub.dev: jangan menambahkannya ke pubspec.yaml, dan jangan mengarahkan dependensi git atau path ke plugin ini. Halaman ini akan memuat baris pemasangannya pada hari plugin itu dirilis.
Plugin ini adalah satu API Dart untuk Android dan iOS. Plugin ini membungkus SDK Android (ai.quranlab:tajweedformer di Maven Central) dan SDK Apple (paket Swift di github.com/Quran-Lab/tajweedformer-apple), dan tidak berisi salinan dari keduanya.
Sampai plugin dirilis
Gunakan SDK dari kode platform aplikasi Anda. SDK Android ditempatkan di folder android dan SDK Apple di folder ios: Mulai cepat Android dan Mulai cepat Apple berisi baris pemasangan, tempat menaruh kunci, dan empat panggilan untuk masing-masing sisi. Kode Dart Anda menjangkau keduanya melalui platform channel (sebuah MethodChannel, ditambah sebuah EventChannel untuk potongan-potongannya). Asisten pemrograman yang disiapkan dengan skill Quran Lab dapat menulis jembatan itu bersama Anda, dan plugin akan menggantikannya setelah dirilis.
Yang dibutuhkan plugin
- Flutter 3.41 atau yang lebih baru.
- Android 8.0 (API 26) atau yang lebih baru, pada
arm64-v8aatauarmeabi-v7a. Emulator x86-64 menjalankan mesin CPU. - iOS 15 atau yang lebih baru pada Apple silicon, di-build dengan Xcode 16 atau yang lebih baru.
- Swift Package Manager untuk build iOS. SDK Apple hanya dirilis sebagai paket Swift, jadi plugin ini tidak mendukung CocoaPods. Swift Package Manager adalah bawaan Flutter sejak 3.44; pada versi Flutter yang lebih lama, jalankan
flutter config --enable-swift-package-manager. - Koneksi internet, cukup sekali. Model (56,5 MB) diunduh sebelum sesi pertama dan setiap berkasnya diverifikasi. Setelah itu, model berjalan secara offline.
Kunci
Gunakan kunci apps untuk kedua platform. Aplikasi dikenali dari applicationId di Gradle untuk Android dan dari bundle id-nya untuk iOS. Simpan kunci di luar repositori Anda.
Sampai plugin dirilis, setiap sisi membaca kunci seperti yang ditunjukkan panduan mulai cepatnya: local.properties di Android, Secrets.xcconfig di iOS.
Di iOS, tambahkan capability App Attest ke target Runner: dengan capability ini aplikasi Anda membuktikan instalasinya, dan rekaman yang dibagikan pelajar tidak diunggah tanpanya (berbagi rekaman).
Pratinjau: empat panggilan di Dart
Pratinjau, belum dirilis. Inilah API yang direncanakan untuk plugin ini, agar Anda dapat melihat arahnya. Tidak ada apa pun di halaman ini yang dapat dipasang hari ini, dan sebuah nama masih dapat berubah sebelum rilis.
import 'package:quranlab_tajweedformer/quranlab_tajweedformer.dart';
Future<void> quickStart(void Function(String heard) show) async {
// your key; one client per process
final client = await TajweedClient.create('qlk_v1_...');
// the first run downloads and verifies the model
final model = await client.model(onProgress: (done, total) => print('$done / $total'));
// asks for the microphone itself; ends 1.5 s after the learner stops
const options = TajweedSessionOptions(endOnSilenceMs: 1500);
final session = await model.listen(options: options);
// every chunk: what the model heard so far
await for (final chunk in session.chunks) {
show(chunk.decoded.text);
}
}Inilah empat panggilan yang dimiliki setiap SDK Quran Lab.
- Mikrofon.
model.listen()memakai mikrofon milik SDK sendiri. Di Android, SDK meminta izinRECORD_AUDIOsendiri; di iOS, aplikasi memerlukanNSMicrophoneUsageDescriptiondiios/Runner/Info.plist. Jika izin ditolak, Anda mendapat galatmicrophone_denied. - Akhir take. Dengan
endOnSilenceMs, take (satu kali bacaan yang didengarkan SDK dari awal sampai akhir) selesai dengan sendirinya setelah ucapan disusul hening selama durasi itu: potongan terakhir memilikidecoded.isFinal. Tanpa opsi ini, panggilsession.finish(), yang mengembalikan head dari take itu, yaitu keluaran mentah jaringan (heads.decoded()). - Audio Anda sendiri.
model.session()menerima audio yang didorong aplikasi Anda:session.push()denganFloat32List, atausession.pushInt16()denganInt16List, padasampleRatedari opsinya (16000kecuali Anda menetapkan nilai lain, dari8000sampai48000). - Tanpa mikrofon.
model.listenFrom(model.sampleClips.first)menjalankan klip yang disertakan bersama model melalui jalur yang sama. - Event.
session.eventsmemberi tahu apa yang terjadi pada take:TajweedSpeechStarted,TajweedSpeechEnded,TajweedInterrupted,TajweedResumed,TajweedBackendChanged, danTajweedEnded. - Galat. Setiap galat berupa
TajweedErrordengancodeyang stabil (konstantanya ada diTajweedErrorCode),message,fix, dan tautandocske halaman Galat. - Berbagi rekaman. SDK bertanya kepada pelajar dengan lembar milik Quran Lab sendiri: di Android, plugin menampilkannya di atas activity Flutter; di iOS, SDK menampilkannya di atas view controller yang berada paling depan. Tidak ada yang perlu dinyalakan atau dimatikan di aplikasi Anda.
client.sharing.openSettings()membuka layar pengaturan SDK, untuk sebuah baris di pengaturan aplikasi Anda (berbagi rekaman).
Setiap potongan berisi chunk.decoded (text, tokens, words, settled, isFinal) dan chunk.heads (keluaran mentah yang Anda pilih). Bangun umpan balik sendiri menjelaskan masing-masing.
Nama-namanya menjadi final di README paket pada hari paket itu dirilis.