Allez directement au contenu principal
@capgo/capacitor-twilio-voice La communication Source

Twilio Voice plugin Capacitor

Effectuez et recevez des appels VoIP avec Twilio Voice pour une fonctionnalité d'appel en application

Installer

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

Guide

Comment utiliser Twilio Voice dans Capacitor

Tester sur appareil

Télécharger l'application Capgo, puis scannez le code QR code.

Twilio Voice plugin preview QR code

Utilisez @capgo/capacitor-twilio-voice

Intègre le SDK de Twilio Voice dans Capacitor.

Installer

bun add @capgo/capacitor-twilio-voice
bunx cap sync

bunx cap sync copie les code natifs du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
login Authentifier l'utilisateur avec Twilio Voice à l'aide d'un jeton d'accès.
logout Déconnecter l'utilisateur actuel et se désinscrire de Twilio Voice.
isLoggedIn Vérifier si l'utilisateur est actuellement connecté et dispose d'un jeton d'accès valide.
makeCall Lancer un appel sortant vers un numéro de téléphone ou un client.
acceptCall Accepter un appel entrant.
rejectCall Rejeter un appel entrant.
endCall Terminer un appel actif.
muteCall Activer ou désactiver le microphone pendant un appel actif.
setSpeaker Activer ou désactiver le mode haut-parleur.
getCallStatus Obtenir l'état actuel de l'appel en cours.
checkMicrophonePermission Vérifier si la permission de microphone a été accordée.
requestMicrophonePermission Demander la permission d'accès au microphone à l'utilisateur.

Exemples

login()

Authentifier l'utilisateur avec Twilio Voice à l'aide d'un jeton d'accès.

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

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

logout()

Se déconnecter de l'utilisateur actuel et se désinscrire de Twilio Voice.

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

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

isLoggedIn()

Vérifier si l'utilisateur est actuellement connecté et dispose d'un jeton d'accès valide.

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()

Lancer un appel sortant vers un numéro de téléphone ou 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()

Accepter un appel entrant.

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()

Rejeter un appel entrant.

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

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

La table ci-dessus liste les 12 méthodes de base. Les helpers d'écouteurs et de versions, ainsi que la pleine convention de chaque méthode, sont documentés dans le le GitHub dépôt.

Écouter les événements

addListener retourne un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou CapacitorTwilioVoice.removeAllListeners() pour supprimer tous les écouteurs.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-twilio-voice

Si vous utilisez L'utilisation de @capgo/capacitor-twilio-voice pour planifier le travail du plugin natif, connectez-l’avec @capgo/capacitor-twilio-voice pour les détails d'implémentation dans @capgo/capacitor-twilio-voice Getting Started pour les détails d'implémentation dans Démarrage Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo, et Ajouter ou Mettre à Jour les Plugins pour les détails d'implémentation dans Ajouter ou Mettre à Jour les Plugins.

FAQ

FAQ du plugin Twilio Voice

Comment installer le plugin Twilio Voice dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-twilio-voice » (ou « npm install @capgo/capacitor-twilio-voice »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif. Importez-l’à partir de « @capgo/capacitor-twilio-voice » dans votre application code.

Le plugin @capgo/capacitor-twilio-voice fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin Twilio Voice est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript simple.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-twilio-voice?

Capgo plugins suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README de GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-twilio-voice est-il gratuit et open source?

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-twilio-voice/ et le package est gratuit pour l'installation depuis npm. Les rapports de bogues et les demandes de mise à jour sont les bienvenus.

Puis-je mettre à jour code qui utilise Twilio Voice sans passer par une revue de l'App Store?

L'installation ou la mise à jour du plugin modifie le code natif de code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour en direct de Capgo.

Envoyez les modifications de Twilio Voice sans attendre l'examen de l'application.

Une fois le plugin est dans votre magasin de build, les mises à jour en direct Capgo envoient vos modifications JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Démarrer avec Capgo