Anleitung
How verwenden Sie Twilio Voice in Capacitor
Verwendung von @capgo/capacitor-twilio-voice
Integriert den Twilio Voice SDK in Capacitor.
Installieren
bun add @capgo/capacitor-twilio-voice
bunx cap sync
bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut durch, nachdem jede Plugin-Upgrade durchgeführt wurde.
Importieren
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
API im Überblick
| Methode | Beschreibung |
|---|---|
login |
Authentifizieren Sie den Benutzer mit Twilio Voice mithilfe eines Zugriffstokens. |
logout |
Abmelden des aktuellen Benutzers und Abmeldung von Twilio Voice. |
isLoggedIn |
Überprüfen Sie, ob der Benutzer derzeit angemeldet ist und ein gültiges Zugriffstoken besitzt. |
makeCall |
Einen Ausgehanschluss an eine Telefonnummer oder einen Client starten. |
acceptCall |
Ein eingehendes Anruf annehmen. |
rejectCall |
Ein eingehendes Anruf ablehnen. |
endCall |
Ein aktives Gespräch beenden. |
muteCall |
Mikrofon abschalten oder wieder einschalten während eines laufenden Anrufs. |
setSpeaker |
Das Lautsprecher-Modus an- oder abschalten. |
getCallStatus |
Den aktuellen Status des aktiven Gesprächs abrufen. |
checkMicrophonePermission |
Überprüfen, ob die Mikrofon-Berechtigung erteilt wurde. |
requestMicrophonePermission |
Das Mikrofon-Berechtigung vom Benutzer anfordern. |
Beispiele
login()
Der Benutzer mit Twilio Voice authentifizieren, indem ein Zugriffstoken verwendet wird.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.login({
accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);
logout()
Den aktuellen Benutzer abmelden und von Twilio Voice abmelden.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.logout();
console.log('Logout successful:', result.success);
isLoggedIn()
Überprüfen Sie, ob der Benutzer derzeit angemeldet ist und einen gültigen Zugriffstoken besitzt.
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()
Erteilen Sie einem Ausgehenden Anruf an eine Telefonnummer oder einen 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()
Ein eingehenden Anruf annehmen.
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()
Ein eingehenden Anruf ablehnen.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
if (shouldRejectCall(data.from)) {
await CapacitorTwilioVoice.rejectCall({
callSid: data.callSid
});
}
});
Die Tabelle oben listet die 12 Kernmethoden. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind in der GitHub Repository.
Zu Ereignissen hören
addListener gibt einen Handle zurück. Rufen Sie handle.remove() wenn die Seite entladen wird, oder CapacitorTwilioVoice.removeAllListeners() um alle Listener zu löschen.
Vollständige Referenz
Mit @capgo/capacitor-twilio-voice weitermachen
Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-twilio-voice verwenden Verwenden Sie @capgo/capacitor-twilio-voice um native Plugin-Arbeit zu planen, verbinden Sie es mit @capgo/capacitor-Twilio-Gespräch um die Implementierungsdetails in @capgo/capacitor-twilio-voice zu erhalten __CAPGO_KEEP_0__-Plugin-Verzeichnis um den Produktworkflow in __CAPGO_KEEP_0__-Plugin-Verzeichnis zu erhalten Capgo Plugin Directory für den Produktworkflow in der Capgo Plugin-Datenbank Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren zur Implementierungsdetail in Plugins hinzufügen oder aktualisieren.