@capgo/capacitor-twilio-voice

Panoramica

Il plugin Capacitor Twilio Voice abilita funzionalità di chiamate VoIP di alta qualità in applicazioni iOS e Android utilizzando l’API Voice di Twilio. Questo plugin fornisce gestione completa delle chiamate, autenticazione e controlli audio per creare esperienze di chiamata professionali.

Chiamate VoIP

Chiamate vocali di alta qualità via internet utilizzando l’API Twilio Voice 📞

Gestione chiamate

Effettua, accetta, rifiuta e termina chiamate con controllo completo del ciclo di vita 🎛️

Controlli audio

Disattiva audio, attiva vivavoce e opzioni di routing audio 🎤

Supporto piattaforma

Implementazione nativa iOS e Android con notifiche push 📱

Installazione

npm install @capgo/capacitor-twilio-voice
npx cap sync

Metodi API principali

Autenticazione

• login(options: { accessToken: string }) - Autentica con Twilio utilizzando token di accesso
• logout() - Termina sessione utente e cancella stato chiamata
• isLoggedIn() - Verifica stato autenticazione corrente

Gestione chiamate

• makeCall(options: { to: string }) - Avvia chiamata in uscita al numero specificato
• acceptCall(options: { callSid: string }) - Accetta chiamata in arrivo
• rejectCall(options: { callSid: string }) - Rifiuta chiamata in arrivo
• endCall(options?: { callSid?: string }) - Termina chiamata attiva
• muteCall(options: { muted: boolean, callSid?: string }) - Disattiva/riattiva audio chiamata
• setSpeaker(options: { enabled: boolean }) - Attiva/disattiva output vivavoce

Event Listener

Il plugin fornisce gestione completa degli eventi per:

• Eventi di registrazione per stato connessione
• Cambiamenti stato chiamata (connessa, disconnessa, squillante)
• Avvisi qualità e problemi connessione
• Notifiche chiamate in arrivo

Configurazione piattaforma

Configurazione iOS

• Richiede integrazione PushKit per chiamate in arrivo
• Configurazione certificato per uso produzione
• Permessi microfono in Info.plist

Configurazione Android

• Configurazione Firebase per notifiche push
• Permessi microfono in AndroidManifest.xml
• Configurazione servizio background

Esempio avvio rapido

import { TwilioVoice } from '@capgo/capacitor-twilio-voice';

// Autentica con Twilio
await TwilioVoice.login({ accessToken: 'your-twilio-access-token' });

// Effettua una chiamata
await TwilioVoice.makeCall({ to: '+1234567890' });

// Ascolta eventi chiamata
TwilioVoice.addListener('callConnected', (data) => {
  console.log('Chiamata connessa:', data);
});

Documentazione

Consulta la documentazione completa per istruzioni dettagliate di configurazione, configurazione avanzata ed esempi di integrazione.