Guida
Come usare Twilio Voice in Capacitor
Utilizzo di @capgo/capacitor-twilio-voice
Integra il SDK di Twilio Voice in Capacitor
Installa
bun add @capgo/capacitor-twilio-voice
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
API in breve
| Metodo | Descrizione |
|---|---|
login |
Autentica l'utente con Twilio Voice tramite un access token. |
logout |
Effettua il logout dell'utente e la disiscrizione da Twilio Voice. |
isLoggedIn |
Verifica se l'utente è loggato e ha un access token valido. |
makeCall |
Avvia una chiamata in uscita verso un numero o un client. |
acceptCall |
Rispondi a una chiamata in entrata. |
rejectCall |
Rifiuta una chiamata in entrata. |
endCall |
Termina una chiamata attiva. |
muteCall |
Disattiva o riattiva il microfono durante una chiamata attiva. |
setSpeaker |
Abilita o disabilita la modalità vivavoce. |
getCallStatus |
Ottieni lo stato attuale della chiamata attiva. |
checkMicrophonePermission |
Verifica se il permesso per il microfono è stato concesso. |
requestMicrophonePermission |
Richiedi all'utente l'autorizzazione per il microfono. |
Esempi
login()
Autentica l'utente con Twilio Voice tramite un access token.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.login({
accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);
logout()
Effettua il logout dell'utente corrente e annulla la registrazione a Twilio Voice.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.logout();
console.log('Logout successful:', result.success);
isLoggedIn()
Verifica se l'utente è loggato e ha un access token valido.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const status = await CapacitorTwilioVoice.isLoggedIn();
if (status.isLoggedIn && status.hasValidToken) {
console.log('User identity:', status.identity);
} else {
// Re-authenticate the user
}
makeCall()
Avvia una chiamata in uscita verso un numero o un client.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
// Call a phone number
const result = await CapacitorTwilioVoice.makeCall({
to: '+1234567890'
});
console.log('Call SID:', result.callSid);
// Call another Twilio client with a readable name for CallKit Recents
await CapacitorTwilioVoice.makeCall({
to: 'client:alice',
displayName: 'Alice Smith'
});
// Call a PSTN number using a specific caller ID
await CapacitorTwilioVoice.makeCall({
to: '+1234567890',
callerId: '+10987654321'
});
acceptCall()
Rispondi a una chiamata in entrata.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
console.log('Incoming call from:', data.from);
const result = await CapacitorTwilioVoice.acceptCall({
callSid: data.callSid
});
console.log('Call accepted:', result.success);
});
rejectCall()
Rifiuta una chiamata in entrata.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
if (shouldRejectCall(data.from)) {
await CapacitorTwilioVoice.rejectCall({
callSid: data.callSid
});
}
});
La tabella sopra elenca i 12 metodi principali. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapacitorTwilioVoice.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua da Usare @capgo/capacitor-twilio-voice
Se stai usando Utilizzo di @capgo/capacitor-twilio-voice per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-twilio-voice per i dettagli di implementazione in @capgo/capacitor-twilio-voice, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.