Android

Wie funktioniert die Android-Verhaltensweise

Auf Android sendet 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 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: Halte die Benachrichtigung für Klingelströme genug störend
• accentColor: Tint kompatibel mit Benachrichtigungsflächen
• ringtoneUri: Zeige auf eine benutzerdefinierte Android Klingeltonressource oder URI

Verhaltenshinweise

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

Empfehlte Produktionsmodell

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

• FCM-Registrierung und Token-Verwaltung
• Medien-Sitzungs-Lebenszyklus
• Hintergrundanruf-Status
• Wiederholungs- und verpasster-Anruf-Geschäftslogik

Bleiben Sie bei Android

Wenn Sie Android um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit Mit @capgo/capacitor-eingehendes-Anruf-Kit für die native Fähigkeit in Mit @capgo/capacitor-eingehendes-Anruf-Kit Mit @capgo/capacitor-Live-Aktivitäten für die native Fähigkeit in Mit @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