Android

Wie funktioniert die Android-Verhaltensweise

Auf Android sendet das Plugin eine hohe Priorität für eingehende Anrufbenachrichtigungen und kann eine volle Bildschirmaktivität erheben, wenn die Plattform und die Benutzer-Einstellungen dies zulassen.

Der Plugin-Manifest enthält bereits:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

Nach der Installation ist es ausreichend, diese Konfiguration in Ihre Host-App zu integrieren. cap sync Ist genug, um diese Konfiguration in Ihre Host-App zu integrieren.

Laufzeitberechtigungen

Rufen Sie diese Methoden während der Einrichtung oder bevor Sie auf die Anzeige von eingehenden Anrufen angewiesen sind:

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

• requestPermissions() Berechtigung für Benachrichtigungen bei Android 13 und später anfordern.
• requestFullScreenIntentPermission() Öffnet die Einstellungen von Android 14 und später für volle Bildschirm-Intents, wenn erforderlich.

Grundlegender Beispiel

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  appName: 'Capgo Phone',
  timeoutMs: 45_000,
  android: {
    channelId: 'calls',
    channelName: 'Incoming Calls',
    showFullScreen: true,
    isHighPriority: true,
    accentColor: '#0F766E',
  },
});

Android-spezifische Optionen

• channelId: Kennzeichner für die Benachrichtigungschannel
• channelName: Benutzerfreundlicher Channelname
• showFullScreen: Anfrage für die Vollbildaktivität
• isHighPriority: Halten Sie die Benachrichtigung für Ringtöne genug störend
• accentColor: Tint kompatibel mit Benachrichtigungsflächen
• ringtoneUri: Zeigen Sie auf eine benutzerdefinierte Android-Ringtöneressource oder URI

Verhaltenshinweise

• Die Vollbildpräsentation ist ein Bestreben. Wenn das Gerät oder die Benutzer-Einstellungen es blockieren, zeigt Android den eingehenden Anruf-Benachrichtigung.
• Timeout-Handling ist ein Bestreben. Das Plugin verfolgt timeoutMs und sendet callTimedOut, aber Ihr Backend sollte die verpassten Anrufe auf seiner Seite nochmals abgleichen.
• Akzeptieren, ablehnen und Beendigungshandlungen werden über Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anruf anbinden oder den Anrufsession aufräumen kann.

Empfehlte Produktionsmodell

Verwenden Sie Android-Push oder Ihren Anruf-SDK für den Transport, dann lassen Sie dieses Plugin die letzte Meile der nativen Klingel-UI übernehmen. Halten Sie diese Verantwortlichkeiten außerhalb des Plugins:

• Registrierung und Token-Verwaltung von FCM
• Lebenszyklus der Medien-Sitzung
• Zustand des Backend-Anrufs
• Wiederholungs- und verpasster-Anruf-Business-Logic