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 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 genug, um 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 bei 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

• channelIdKennung für den Benachrichtigungskanal
• channelNameBenutzerfreundlicher Kanalname
• showFullScreenBereitstellung der vollbildaktivität
• isHighPriorityBewahren Sie die Benachrichtigung so störend, dass sie für Klingelströme geeignet ist
• accentColorTintenkompatibilität für Benachrichtigungsoberflächen
• ringtoneUriPunkte auf eine benutzerdefinierte Android-Ringtone-Ressource oder -URI

Verhaltenshinweise

• Die Vollbildpräsentation ist ein Bestreben. Wenn das Gerät oder die Benutzereinstellungen es verhindern, zeigt Android die Eingangsanrufbenachrichtigung immer noch an.
• Die Timeout-Verwaltung ist ein Bestreben. Das Plugin verfolgt und sendet timeoutMs und sendet callTimedOut, aber Ihr Backend sollte die verpassten Anrufe auf seiner Seite nochmals abgleichen.
• Die Akzeptanz, Ablehnung und Beendigung der Aktionen werden über Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufräumen kann.

Empfohlener Produktionsmodell

Verwenden Sie Android-Push oder Ihre Ruf-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 Verwaltung von FCM-Tokens
• Media-Sessions-Lebenszyklus
• Zustand des Backendaufrufs
• Wiederholen und verpasste Anruflogik

Fortsetzen von Android

Wenn Sie native Medien und Schnittstellenverhalten planen möchten Android um es mit Verwenden Sie @capgo/capacitor-incoming-call-kit zur nativen Fähigkeit in Verwenden Sie @capgo/capacitor-incoming-call-kit, Verwenden Sie @capgo/capacitor-live-activities zur nativen Fähigkeit in Verwenden Sie @capgo/capacitor-live-activities, Verwenden Sie @capgo/capacitor-live-activities 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 Mit @capgo/capacitor-video-player für die Implementierungsdetails in @capgo/capacitor-video-player.