Android

Wie funktioniert die Android-Verhaltensweise?

Auf Android postet das Plugin eine hohe Priorität für eingehende Anrufbenachrichtigungen und kann eine Vollbildaktivitä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, cap sync ist ausreichend, um diese Konfiguration in Ihre Host-App zu integrieren.

Laufzeitberechtigungen

Rufen Sie diese Methoden während der Einrichtung oder bevor Sie auf die Eingehende-Anruf-Präsentation angewiesen sind:

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

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

• requestPermissions() fordert die Benachrichtigungs-Berechtigung bei Android 13 und später an.
• requestFullScreenIntentPermission() erö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: sichtbarer Name des Benachrichtigungschannels
• showFullScreen: Anfrage für die Vollbildaktivität
• isHighPriorityBleib die Benachrichtigung für die Klingelströme störend genug
• accentColor: Tintenkompatible Benachrichtigungsflächen
• ringtoneUri: Zeigen Sie auf eine benutzerdefinierte Android-Ringtone-Ressource oder -URI

Verhaltenshinweise

• Die Vollbildpräsentation ist ein Bestreben. Wenn das Gerät oder die Benutzerinstellungen es blockieren, zeigt Android den eingehenden Anrufbenachrichtigung immer noch an.
• Die Timeout-Verwaltung ist ein Bestreben. Das Plugin verfolgt und sendet timeoutMs emittiert callTimedOut, aber Ihr Backend sollte die verpassten Anrufe auf der eigenen Seite nochmals abgleichen.
• Akzeptieren, ablehnen und Beendigen-Aktionen werden über Capacitor-Listener zurückgegeben, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufräumen kann.

Empfohlener Produktionsmodell

Verwenden Sie Android-Push oder Ihre Rufanforderung SDK für den Transport, lassen Sie dann dieses Plugin die letzte Meile des nativen Klingel-UI bearbeiten. 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-Unternehmenslogik

Weitermachen von Android

Wenn Sie Capgo verwenden Android um native Medien und Schnittstellenverhalten zu planen und zu verbinden, Mit @capgo/capacitor-eingehende-Anruf-Kit zur Verwendung der native Fähigkeit in Mit @capgo/capacitor-eingehende-Anruf-Kit, Mit @capgo/capacitor-Live-Aktivitäten zur Verwendung der native Fähigkeit in Mit @capgo/capacitor-Live-Aktivitäten, @capgo/capacitor-Live-Aktivitäten zur Verwendung des Implementierungsdetails in @capgo/capacitor-Live-Aktivitäten, Mit @capgo/capacitor-Video-Player zur Verwendung der native Fähigkeit in Mit @capgo/capacitor-Video-Player und @capgo/capacitor-Video-Player zur Verwendung des Implementierungsdetails in @capgo/capacitor-Video-Player.