iOS

Comment fonctionne le comportement iOS

Sur iOS, le plugin signale l'appel entrant à CallKit. Cela vous donne la feuille de rappel d'appel système et les actions d'appel standardisées sans que vous deviez construire votre propre interface d'appel entrant native.

requestPermissions() se résout immédiatement sur iOS car CallKit lui-même ne nécessite pas de dialogue de demande de permission en temps de exécution.

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

Types de gestion

Utilisez ios.handleType pour contrôler la façon dont CallKit formate le handle :

• generic pour des identifiants spécifiques à l'application
• phoneNumber pour des numéros de téléphone réels
• emailAddress pour des identités basées sur l'e-mail

Appels entrants en arrière-plan

Cette extension ne s'inscrit pas pour vous PushKit ou APNs.

Pour un sonnerage en arrière-plan ou en état de terminaison réel sur iOS, votre application d'hôte nécessite toujours la mise en place native d'Apple push qui correspond à votre stratégie de transport :

1. Activer les notifications Push lorsque votre transport utilise la livraison de push Apple.
2. Activer le mode de fond VoIP lorsque votre application utilise un flux de push VoIP.
3. Fournir l'événement d'appel entrant à votre application et invoquez cette extension dès que le pont Capacitor est disponible.

Si votre événement de sonnerie n'existe que dans JavaScript, vous obtiendrez la meilleure expérience alors que l'application est déjà en cours d'exécution en arrière-plan.

Autorisations de microphone et de caméra

CallKit ne remplace pas votre média SDK.

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

Ajoutez uniquement les clés dont votre flux de communication réelle a besoin.

Section intitulée « Gardez ces responsabilités dans votre couche d'application »

• Authentification et mise à jour du jeton
• Rejoindre la vraie salle ou la session VoIP après
• Terminer ou réconcilier l'état d'appel distant lorsque le plugin émet callAccepted
• ou callDeclined, callEndedContinuez depuis iOS callTimedOut

Section intitulée « Continuez depuis iOS »

If vous utilisez iOS pour planifier le travail de plugin natif, connectez-l’à En utilisant @capgo/capacitor-kit-appel-entrant pour la capacité native dans En utilisant @capgo/capacitor-kit-appel-entrant Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo Ajout ou mise à jour des plugins pour le détail d'implémentation dans Ajout ou mise à jour des plugins, et Alternatives aux plugins d'entreprise Ionic pour le flux de travail du produit dans les alternatives du plugin Ionic Enterprise