Saltare al contenuto

iOS

GitHub

Sul sistema 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 in arrivo nativa.

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

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

Utilizza 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

Questo plugin non registra PushKit o APNs per te.

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

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

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

CallKit non sostituisce il tuo 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.

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

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