iOS

Wie iOS-Verhalten funktioniert

Auf iOS meldet sich das Plugin dem eingehenden Anruf bei CallKit. Das gibt Ihnen das Systemeingehungsanrufblatt und standardisierte Anrufaktionen ohne, dass Sie Ihre eigene native eingehende Anruf-UI erstellen müssen.

requestPermissions() wird auf iOS sofort gelöst, weil CallKit selbst keine Laufzeitgenehmigungsanfrage anfordert.

Grundlegender Beispiel

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  handle: '+1 555 010 020',
  ios: {
    handleType: 'phoneNumber',
    supportsHolding: true,
    supportsDTMF: false,
  },
});

Handle-Typen

Verwenden ios.handleType um zu bestimmen, wie CallKit den Handle formatiert:

• generic für app-spezifische Identifikatoren
• phoneNumber für echte Telefonnummern
• emailAddress für Identitäten auf Basis von E-Mails

Hintergrundeingänge

Diese Erweiterung registriert PushKit oder APNs nicht für Sie.

Für wahrheitsgetreue Hintergrund- oder beendete-Zustand-Klingeln auf iOS benötigt Ihre Host-App immer noch die native Apple-Push-Einrichtung, die Ihrem Transport-Strategie entspricht:

1. Aktivieren Sie Push-Benachrichtigungen, wenn Ihr Transport Apple-Push-Lieferung verwendet.
2. Aktivieren Sie die Voice-over-IP-Hintergrundmodus, wenn Ihre App eine VoIP-Push-Fluss verwendet.
3. Liefern Sie das eingehende Anrufereignis an Ihre App und rufen Sie diese Erweiterung auf, sobald die Capacitor-Brücke verfügbar ist.

Wenn Ihr Klingelereignis nur in JavaScript existiert, erhalten Sie die beste Erfahrung, während die App bereits im Vordergrund läuft.

Mikrofon- und Kamera-Berechtigungen

CallKit does not replace your media SDK. If the real call session uses microphone or camera access, those usage descriptions still belong in your app:

<key>NSMicrophoneUsageDescription</key>
<string>This app uses the microphone for calls.</string>
<key>NSCameraUsageDescription</key>
<string>This app uses the camera for video calls.</string>

Fügen Sie nur die Schlüssel hinzu, die Ihre echte Rufablauf benötigt.

Bleiben Sie diese Verantwortlichkeiten in Ihrer App-Schicht

• PushKit- und APNs-Registrierung
• Authentifizierung und Token-Refresh
• Beitreten Sie dem echten Raum oder der VoIP-Sitzung nach callAccepted
• Beenden oder ggf. die Remote-Anrufzustand wenn der Plugin ausgibt callDeclined, callEndedSeite bearbeiten callTimedOut