Guide
Comment utiliser Twilio Voice dans Capacitor
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.