Android

Wie Android-Verhalten funktioniert

Auf Android stellt der Plugin eine hohe Priorität für eingehende Anrufbenachrichtigungen ein und kann eine volle Bildschirmaktivität erheben, wenn die Plattform und die Benutzer-Einstellungen es zulassen.

Das 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 sich auf die Darstellung von eingehenden Anrufen verlassen:

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

• channelId: Identifikator für den Benachrichtigungs-Kanal
• channelName: sichtbarer Kanalname für den Benutzer
• showFullScreen: Anfrage für die vollbildaktivität
• isHighPriority: Halte die Benachrichtigung für Klingelströme genug störend
• accentColor: Tint kompatible Benachrichtigungsflächen
• ringtoneUri: Zeige auf eine benutzerdefinierte Android-Ringtone-Ressource oder URI

Verhaltenshinweise

• Die Vollbildpräsentation ist willkürlich. Wenn das Gerät oder die Benutzerinstellungen es blockieren, zeigt Android die Eingangsanrufbenachrichtigung immer noch an.
• Die Timeout-Verwaltung ist willkürlich. Das Plugin verfolgt timeoutMs und sendet callTimedOut, aber Ihre Backend-Instanz sollte die verpassten Anrufe auf der eigenen Seite auflösen.
• Akzeptieren, ablehnen und beenden werden über Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufräumen kann.

Empfehlte Produktionsmodell

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

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

Fortsetzen von Android

Wenn Sie Android verwenden Android um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit Mit @capgo/capacitor-eingehendes-Anruf-Kit zur nativen Fähigkeit in Mit @capgo/capacitor-eingehendes-Anruf-Kit, Mit @capgo/capacitor-live-Aktivitäten zur nativen 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.