Vai al contenuto principale
@capgo/capacitor-twilio-voice Comunicazione Sorgente aperta

Vozi Twilio Plugin Capacitor

Fare 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 utilizzare Twilio Voice in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il QR code.

QR code di anteprima del plugin Twilio Voice

Utilizza @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 il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo d'occhio

Metodo Descrizione
login Autentica l'utente con Twilio Voice utilizzando un token di accesso.
logout Disconnetti l'utente corrente e disiscriviti da Twilio Voice.
isLoggedIn Controlla se l'utente è attualmente connesso e ha un token di accesso valido.
makeCall Avvia una chiamata in uscita verso un numero di telefono o un client.
acceptCall Accetta una chiamata in arrivo.
rejectCall Rifiuta una chiamata in arrivo.
endCall Termina una chiamata attiva.
muteCall Attiva o disattiva il microfono durante una chiamata attiva.
setSpeaker Abilita o disabilita il modo speakerphone.
getCallStatus Ottieni lo stato corrente della chiamata attiva.
checkMicrophonePermission Controlla se è stato concesso il permesso di utilizzo del microfono.
requestMicrophonePermission Richiedi il permesso di utilizzare la microfonia dall'utente.

Esempi

login()

Autentica l'utente con Twilio Voice utilizzando un token di accesso.

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

const result = await CapacitorTwilioVoice.login({
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);

logout()

Disconnetti l'utente corrente e disiscrivi da Twilio Voice.

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

const result = await CapacitorTwilioVoice.logout();
console.log('Logout successful:', result.success);

isLoggedIn()

Controlla se l'utente è attualmente connesso e ha un token di accesso 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 di telefono 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()

Accetta una chiamata in arrivo.

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 arrivo.

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

CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
  if (shouldRejectCall(data.from)) {
    await CapacitorTwilioVoice.rejectCall({
      callSid: data.callSid
    });
  }
});

Il tabella sopra elenca i 12 metodi di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository GitHub.

Ascolta gli eventi

addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapacitorTwilioVoice.removeAllListeners() per cancellare tutti gli ascoltatori.

Tutte le informazioni

Continua dall'uso di @capgo/capacitor-twilio-voice

Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-twilio-voice Usando @capgo/capacitor-twilio-voice per pianificare il lavoro del plugin nativo, connettilo per i dettagli di implementazione in @capgo/capacitor-twilio-voice per i dettagli di implementazione in @capgo/capacitor-twilio-voice Getting Started per i dettagli di implementazione in Avvio Direttorio Plugin Capgo per il flusso di lavoro del prodotto in Direttorio Plugin Capgo Capacitor Plugin per Capgo per i dettagli di implementazione in Capacitor Plugin per Capgo, e Aggiungere o Aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin.

FAQ

Domande frequenti del plugin Twilio Voice

Come posso installare il plugin Twilio Voice in un'app Capacitor?

Esegui "bun add @capgo/capacitor-twilio-voice" (o "npm install @capgo/capacitor-twilio-voice"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-twilio-voice" nella tua app code.

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

Sì. Twilio Voice è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-twilio-voice?

Capgo plugin seguono la versione maggiore di Capacitor: utilizzare la versione maggiore del plugin che corrisponde alla versione maggiore 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 il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono graditi.

Posso aggiornare code che utilizza Twilio Voice senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il codice nativo di code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con le Capgo live updates.

Invia le modifiche a Twilio Voice senza dover attendere la revisione dell'app

Una volta che il plugin è presente nel tuo store build, Capgo le nuove versioni vengono distribuite ai clienti in pochi minuti.

Inizia con Capgo