Guide
Comment utiliser Twilio Voice dans Capacitor
Utiliser @capgo/capacitor-twilio-voice
Intègre le SDK Twilio Voice dans Capacitor.
Installer
bun add @capgo/capacitor-twilio-voice
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
Aperçu de API
| Méthode | Description |
|---|---|
login |
Authentifiez l'utilisateur avec Twilio Voice à l'aide d'un access token. |
logout |
Déconnectez l'utilisateur actuel et désinscrivez-le de Twilio Voice. |
isLoggedIn |
Vérifiez si l'utilisateur est connecté et possède un access token valide. |
makeCall |
Lancez un appel sortant vers un numéro de téléphone ou un client. |
acceptCall |
Acceptez un appel entrant. |
rejectCall |
Rejetez un appel entrant. |
endCall |
Terminez un appel en cours. |
muteCall |
Couper ou réactiver le micro pendant un appel actif. |
setSpeaker |
Activer ou désactiver le mode haut-parleur. |
getCallStatus |
Obtenir le statut actuel de l'appel actif. |
checkMicrophonePermission |
Vérifier si l'autorisation du micro a été accordée. |
requestMicrophonePermission |
Demander l'autorisation d'utiliser le micro à l'utilisateur. |
Exemples
login()
Authentifier l'utilisateur avec Twilio Voice via un access token.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.login({
accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);
logout()
Déconnecter l'utilisateur actuel et se désenregistrer 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 connecté et possède un access token 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
});
}
});
Le tableau ci-dessus liste les 12 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou CapacitorTwilioVoice.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuer avec l'utilisation de @capgo/capacitor-twilio-voice
Si vous utilisez Utiliser @capgo/capacitor-twilio-voice pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-twilio-voice pour les détails d'implémentation dans @capgo/capacitor-twilio-voice, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.