Zum Hauptinhalt springen
@capgo/capacitor-twilio-voice Kommunikation Open Source

Twilio Voice Capacitor Plugin

Mit Twilio Voice VoIP-Anrufe tätigen und empfangen – für In-App-Anruffunktionen

Installieren

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

Anleitung

Twilio Voice in Capacitor nutzen

Verwendung von @capgo/capacitor-twilio-voice

Integriert das Twilio Voice SDK in Capacitor.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
login Authentifizieren Sie den Benutzer bei Twilio Voice mithilfe eines Access Tokens.
logout Den aktuellen Benutzer abmelden und die Registrierung bei Twilio Voice aufheben.
isLoggedIn Prüfen, ob der User aktuell eingeloggt ist und einen gültigen Access Token hat.
makeCall Einen ausgehenden Anruf an eine Telefonnummer oder einen Client starten.
acceptCall Einen eingehenden Anruf annehmen.
rejectCall Einen eingehenden Anruf ablehnen.
endCall Einen aktiven Anruf beenden.
muteCall Das Mikrofon während eines aktiven Anrufs stummschalten oder aktivieren.
setSpeaker Den Lautsprecher-Modus ein- oder ausschalten.
getCallStatus Den aktuellen Status des aktiven Anrufs abrufen.
checkMicrophonePermission Prüfen, ob die Mikrofon-Berechtigung erteilt wurde.
requestMicrophonePermission Die Mikrofon-Berechtigung beim Nutzer anfordern.

Beispiele

login()

Authentifizieren Sie den Benutzer bei Twilio Voice mithilfe eines Access Tokens.

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 die Registrierung bei Twilio Voice aufheben.

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

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

isLoggedIn()

Prüfen, ob der User aktuell eingeloggt ist und einen gültigen Access Token hat.

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

Einen ausgehenden Anruf an eine Telefonnummer oder einen Client starten.

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

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

Einen 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 obige Tabelle listet die 12 Kernmethoden auf. Listener und Versions-Helper sowie der vollständige Contract jeder Methode sind dokumentiert in der GitHub Repository.

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder CapacitorTwilioVoice.removeAllListeners() auf, um alle Listener zu entfernen.

Vollständige Referenz

Weiterlesen unter Verwendung von @capgo/capacitor-twilio-voice

Wenn du es nutzt Verwendung von @capgo/capacitor-twilio-voice Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-twilio-voice für die Implementierungsdetails in @capgo/capacitor-twilio-voice, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

Twilio Voice Plugin FAQ

Wie installiere ich das Twilio Voice Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-twilio-voice" (oder "npm install @capgo/capacitor-twilio-voice") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-twilio-voice".

Funktioniert @capgo/capacitor-twilio-voice mit React, Vue und Angular?

Ja. Twilio Voice ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-twilio-voice unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-twilio-voice kostenlos und Open Source?

Ja. Der code Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-twilio-voice/ einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Twilio Voice ohne App Store Review updaten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Twilio Voice Änderungen deployen, ohne auf den App Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo