Android

Wie Android-Verhalten funktioniert

Auf Android sendet das Plugin eine Benachrichtigung für eingehende Anrufe mit hoher Priorität und kann eine volle Bildschirmaktivität erheben, wenn die Plattform und die Benutzereinstellungen dies zulassen.

Der Pluginmanifest 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 Zugriffsrechte zum Laufzeit

Abschnitt mit dem Titel “Zugriffsrechte zum Laufzeit”

Auf das Clipboard kopieren

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

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

• requestPermissions() __CAPGO_KEEP_0__
• requestFullScreenIntentPermission() eröffnet die Android 14- und späteren Einstellungen-Seite für Vollbild-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: Identifikator für den Benachrichtigungs-Kanal
• channelName: sichtbarer Kanalname für den Benutzer
• showFullScreen: Anfrage für das Vollbild-Aktivität
• isHighPriority: Halte die Benachrichtigung so störend, dass sie für Klingelströme geeignet ist
• accentColor: Kompatibilität mit benachrichtigungsfähigen Oberflächen
• ringtoneUri: Zeige auf eine benutzerdefinierte Android-Ringtone-Ressource oder URI

Verhaltenshinweise

• Eine Vollbildpräsentation ist nur ein Bestreben. Wenn das Gerät oder die Benutzereinstellungen es verhindern, zeigt Android die Eingangsanrufbenachrichtigung.
• Die Zeitüberschreitungshandhabung ist nur ein Bestreben. Das Plugin verfolgt und sendet timeoutMs und callTimedOut, aber Ihre Backend-Instanz sollte die verpassten Anrufe auf ihrer Seite nochmals abgleichen.
• Die Akzeptanz-, Ablehnungs- und Beendigungsaktionen werden über die Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufreinigen kann.

Empfohlene Produktionsmodell

Verwenden Sie Android-Push oder Ihre Ruf-SDK-Methode 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
• Hintergrundanforderungsstatus
• Wiederholungs- und Ausfallanruf-Logik