iOS

How iOS behavior works

On iOS, il plugin segnala la chiamata in arrivo a CallKit. Ciò ti consente di avere la schermata di sistema per le chiamate in arrivo e azioni di chiamata standardizzate senza dover costruire la tua UI di chiamata 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 app-specifici
• 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 il tuo media SDK. Se la sessione di chiamata reale utilizza l'accesso al microfono o alla camera, 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.

Tieni queste responsabilità nel layer dell'app

• Registrazione di PushKit e APNs
• Autenticazione e rinnovo del token
• Unisciti alla stanza reale o alla sessione VoIP dopo callAccepted
• Termina o riconcilia lo stato della chiamata remota quando il plugin emette callDeclined, callEnded, o callTimedOut

Continua da iOS

If you are using iOS per pianificare il lavoro di plugin nativi, connettilo con Utilizza @capgo/capacitor-kit-di-chiamata-in-arrivo per la capacità nativa in Utilizza @capgo/capacitor-kit-di-chiamata-in-arrivo Directory dei plugin di Capgo per il flusso di lavoro del prodotto in Directory dei plugin di Capgo I plugin di Capacitor sviluppati da Capgo per il dettaglio di implementazione in I plugin di Capacitor sviluppati da Capgo Aggiungere o aggiornare i plugin per il dettaglio di implementazione in Aggiungere o aggiornare i plugin, e Alternative per plugin aziendali di Ionic Enterprise per il workflow del prodotto in Alternative Plugin Enterprise Ionic.