Salta al contenuto principale
@capgo/capacitor-twilio-voice Comunicazione Open source

Twilio Voice Plugin Capacitor

Effettua e ricevi chiamate VoIP con Twilio Voice per funzionalità di chiamata in-app

Installa

bun add @capgo/capacitor-twilio-voice bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-twilio-voice
  • pnpm add @capgo/capacitor-twilio-voice
  • yarn add @capgo/capacitor-twilio-voice

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.

FAQ

FAQ del plugin Twilio Voice

Come installo il plugin Twilio Voice in un'app Capacitor?

Esegui "bun add @capgo/capacitor-twilio-voice" (o "npm install @capgo/capacitor-twilio-voice"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-twilio-voice" nel code della tua app.

@capgo/capacitor-twilio-voice funziona con React, Vue e Angular?

Sì. Twilio Voice è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-twilio-voice?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-twilio-voice è gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-twilio-voice/ e puoi installare il pacchetto gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Twilio Voice senza la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a Twilio Voice senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo