iOS

Come funziona il comportamento di iOS

Su iOS, il plugin segnala la chiamata in arrivo a CallKit. Ciò ti consente di avere la scheda di chiamata in arrivo del sistema e azioni di chiamata standardizzate senza dover costruire la tua UI di chiamata in arrivo nativa.

requestPermissions() risolve immediatamente su iOS perché CallKit stesso non richiede un dialogo di autorizzazione runtime.

Esempio base

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,
  },
});

Tipi di gestione

Usa ios.handleType per controllare come CallKit formatta il handle:

• generic per identificatori specifici dell'app
• phoneNumber per numeri di telefono reali
• emailAddress per identità basate su email

Chiamate in arrivo in background

Questo plugin non registra PushKit o APNs per te.

Per un vero background o stato di chiamata terminato su iOS, la tua app host ancora richiede la configurazione di push nativa di Apple che corrisponde alla tua strategia di trasporto:

1. Abilita le notifiche push quando il tuo trasporto utilizza la consegna di push di Apple.
2. Abilita il modulo di background Voice over IP quando la tua app utilizza un flusso di push VoIP.
3. Inoltra l'evento di chiamata in arrivo alla tua app e invoca questo plugin non appena è disponibile il ponte Capacitor.

Se l'evento di chiamata esiste solo in JavaScript, otterrai l'esperienza migliore mentre l'app è già in esecuzione in primo piano.

Autorizzazioni per il microfono e la camera

CallKit non sostituisce la tua media SDK. Se la sessione di chiamata reale utilizza l'accesso al microfono o alla fotocamera, le descrizioni di utilizzo devono ancora essere presenti nell'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>

Aggiungi solo le chiavi che il tuo flusso di chiamata reale necessita.

Mantieni queste responsabilità nel layer dell'app

• Registrazione di PushKit e APNs
• Autenticazione e rinnovo del token
• Unirsi alla stanza reale o alla sessione VoIP dopo callAccepted
• Terminare o conciliare lo stato della chiamata remota quando il plugin emette callDeclined, callEndedPagina di modifica callTimedOut