Endyfdl
/
MIF_E31222851
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
MIF_E31222851/README_TTS.md

4.4 KiB
Raw Blame History

Fitur TTS (Text-to-Speech) untuk Sistem Antrian Puskesmas

Overview

Fitur TTS telah ditambahkan ke sistem antrian puskesmas untuk memanggil antrian secara otomatis dengan suara. Ketika admin menekan tombol "Panggil", sistem akan memainkan urutan audio berikut:

  1. Attention Sound - Bunyi perhatian
  2. TTS Announcement - "Nomor antrian X, silakan menuju ke [nama poli]"
  3. Attention Sound - Bunyi perhatian lagi

Cara Kerja

1. Admin Panel

  • Admin membuka halaman poli (Umum, Gigi, Jiwa, Tradisional)
  • Klik tombol "Panggil" pada antrian yang menunggu
  • Sistem akan:
    • Update status antrian menjadi "dipanggil"
    • Generate audio TTS sequence
    • Kirim pesan ke halaman display (jika terbuka)
    • Mainkan audio di browser admin sebagai fallback

2. Display Page

  • Halaman display akan menerima pesan TTS
  • Audio sequence akan diputar secara otomatis
  • Urutan: Attention Sound → TTS → Attention Sound

Komponen yang Ditambahkan

1. Service

  • app/Services/TTSService.php - Service untuk mengelola TTS

2. Controller

  • app/Http/Controllers/TTSController.php - Controller untuk endpoint TTS

3. Routes

// Admin TTS Routes
Route::post('/admin/tts/generate', [TTSController::class, 'generateQueueCall']);
Route::post('/admin/tts/audio-sequence', [TTSController::class, 'getAudioSequence']);
Route::post('/admin/tts/play-sequence', [TTSController::class, 'playAudioSequence']);

// Public TTS Routes
Route::post('/tts/play-sequence', [TTSController::class, 'playAudioSequence']);

4. JavaScript

  • TTS Audio Player class di halaman display
  • Browser TTS fallback di halaman admin

Konfigurasi

1. Google TTS API (Opsional)

Untuk kualitas TTS yang lebih baik, Anda bisa menggunakan Google TTS API:

  1. Dapatkan API Key dari Google Cloud Console
  2. Tambahkan ke file .env:
GOOGLE_TTS_API_KEY=your_api_key_here

2. Browser TTS (Default)

Jika Google TTS API tidak tersedia, sistem akan menggunakan browser's built-in Speech Synthesis API.

Testing

1. Tanpa Google TTS API

  1. Biarkan GOOGLE_TTS_API_KEY kosong di .env
  2. Sistem akan menggunakan browser TTS
  3. Buka halaman admin dan klik "Panggil"
  4. Audio akan diputar di browser

2. Dengan Google TTS API

  1. Set GOOGLE_TTS_API_KEY di .env
  2. Sistem akan generate file audio MP3
  3. File disimpan di public/storage/audio/queue_calls/

File Audio

1. Attention Sound

  • Lokasi: public/assets/music/call-to-attention-123107.mp3
  • Digunakan di awal dan akhir sequence

2. TTS Audio Files

  • Lokasi: public/storage/audio/queue_calls/
  • Format: queue_call_{number}_{poli}_{timestamp}.mp3
  • Dibuat otomatis saat menggunakan Google TTS API

Troubleshooting

1. Audio tidak diputar

  • Periksa console browser untuk error
  • Pastikan file attention sound ada
  • Periksa permission folder storage

2. TTS tidak berfungsi

  • Pastikan browser mendukung Speech Synthesis
  • Periksa CSRF token untuk request AJAX
  • Coba refresh halaman

3. Google TTS API error

  • Periksa API key valid
  • Pastikan Cloud Text-to-Speech API aktif
  • Cek quota dan billing

Fitur Tambahan

1. Audio Queue

  • Multiple panggilan akan di-queue
  • Tidak ada overlap audio

2. Cross-page Communication

  • Admin page bisa kirim pesan ke display page
  • Menggunakan postMessage API

3. Fallback System

  • Google TTS → Browser TTS → Silent
  • Memastikan sistem tetap berfungsi

Keamanan

1. CSRF Protection

  • Semua request TTS dilindungi CSRF token
  • Validasi input untuk mencegah injection

2. File Storage

  • Audio files disimpan di public storage
  • Nama file menggunakan timestamp untuk uniqueness

Performance

1. Audio Caching

  • Browser akan cache audio files
  • Mengurangi bandwidth usage

2. Async Processing

  • TTS generation tidak blocking
  • Audio playback asynchronous

Monitoring

1. Console Logs

  • Error dan warning di console browser
  • Debug info untuk troubleshooting

2. Network Tab

  • Monitor request ke TTS endpoints
  • Check audio file downloads

Future Enhancements

1. Multiple Languages

  • Support untuk bahasa lain
  • Configurable voice settings

2. Custom Audio

  • Upload custom attention sounds
  • Per-poli audio customization

3. Volume Control

  • User-adjustable volume
  • Per-device audio settings

4. Audio Analytics

  • Track audio playback success
  • Monitor TTS usage statistics