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-v8a atau armeabi-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 izin RECORD_AUDIO sendiri; di iOS, aplikasi memerlukan NSMicrophoneUsageDescription di ios/Runner/Info.plist. Jika izin ditolak, Anda mendapat galat microphone_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 memiliki decoded.isFinal. Tanpa opsi ini, panggil session.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() dengan Float32List, atau session.pushInt16() dengan Int16List, pada sampleRate dari opsinya (16000 kecuali Anda menetapkan nilai lain, dari 8000 sampai 48000).
  • Tanpa mikrofon. model.listenFrom(model.sampleClips.first) menjalankan klip yang disertakan bersama model melalui jalur yang sama.
  • Event. session.events memberi tahu apa yang terjadi pada take: TajweedSpeechStarted, TajweedSpeechEnded, TajweedInterrupted, TajweedResumed, TajweedBackendChanged, dan TajweedEnded.
  • Galat. Setiap galat berupa TajweedError dengan code yang stabil (konstantanya ada di TajweedErrorCode), message, fix, dan tautan docs ke 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.