Android

Wie Android-Verhalten funktioniert

Auf Android sendet das Plugin eine Benachrichtigung für eingehende Anrufe mit hoher Priorität und kann eine vollbildschirmige Aktivität erheben, wenn die Plattform und die Benutzereinstellungen es 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 reicht es aus, diese Konfiguration in Ihre Host-App zu integrieren.

Laufzeitberechtigungen

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

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

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

• requestPermissions() fordert die Benachrichtigungs-Berechtigung auf Android 13 und später an.
• requestFullScreenIntentPermission() eröffnet die Einstellungen für vollbildintents auf Android 14 und später, 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: Kennung für den Benachrichtigungschannel
• channelName: Benutzerfreundlicher Name für den Benachrichtigungschannel
• showFullScreen: Anfrage für die vollbildaktivität
• isHighPriority: Halten Sie die Benachrichtigung für Klingelströme genug störend
• accentColor: Tintenkompatibilität für Benachrichtigungsoberflä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 Benutzereinstellungen es blockieren, zeigt Android die Eingangsanrufbenachrichtigung immer noch an.
• Zeitüberschreitungshandling ist ein Bestreben. Der Plugin verfolgt timeoutMs und sendet callTimedOut, aber Ihre Backend sollte die verpassten Anrufe auf der eigenen Seite nochmals abgleichen.
• Akzeptieren, ablehnen und beenden lassen sich über Capacitor-Hörer zurücksenden, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufreinigen kann.

Empfohlener Produktionsmodell

Verwenden Sie Android-Push oder Ihre Rufanbietungs SDK für den Transport, dann lassen Sie dieses Plugin die letzte Meile der native Ringing-UI handhaben. Halten Sie diese Verantwortlichkeiten außerhalb des Plugins:

• Registrierung und Token-Verwaltung von FCM
• Lebenszyklus der Medien-Sitzung
• Zustand des Backendaufrufs
• Wiederholen und verpasste Anruflogik

Fortsetzen von Android

Wenn Sie native Medien und Schnittstellenverhalten planen Android um es mit Verwenden Sie @capgo/capacitor-eingehender-Anruf-Kit zur nativen Fähigkeit in Verwenden Sie @capgo/capacitor-eingehender-Anruf-Kit Verwenden Sie @capgo/capacitor-live-Aktivitäten zur nativen Fähigkeit in Verwenden Sie @capgo/capacitor-live-Aktivitäten @capgo/capacitor-live-Aktivitäten für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player und @capgo/capacitor-video-player für die Implementierungsdetails in @capgo/capacitor-video-player.