iOS

Comment fonctionne le comportement iOS

Sur iOS, le plugin signale l'appel entrant à CallKit. Cela vous donne la feuille de dialogue d'appel entrant du système et des actions d'appel standardisées sans que vous ayez besoin de créer votre propre interface d'appel entrant native.

requestPermissions() se résout immédiatement sur iOS car CallKit n'a pas besoin d'un dialogue de demande de permission de runtime.

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 prise en charge

Utilisez ios.handleType pour contrôler la façon dont CallKit formate la prise en charge :

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

Appels entrants en arrière-plan

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

Pour un sonnerage réel en arrière-plan ou en état terminé sur iOS, votre application d'hôte doit toujours avoir 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. Envoyez 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.

Permissions de microphone et de caméra

L'extension CallKit ne remplace pas vos médias SDK. Si la session de appel réelle utilise l'accès au microphone ou à la caméra, les descriptions d'utilisation doivent toujours appartenir à votre application :

<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 d'appel réel a besoin.

Gardez ces responsabilités dans votre couche d'application

• L'inscription PushKit et APNs
• L'authentification et la mise à jour du jeton
• Rejoindre la vraie salle ou la session VoIP après callAccepted
• Terminer ou réconcilier l'état d'appel distant lorsque le plugin émet callDeclined, callEnded, ou callTimedOut

Continuez de l'iOS

Si 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 Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo Ajouter ou Mettre à jour les plugins pour le détail d'implémentation dans Ajouter ou Mettre à jour les plugins, et Alternatives de plugins d'entreprise Ionic pour le flux de travail du produit dans Alternatives de plugins d'entreprise Ionic.