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 Benutzereinstellungen 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 Zugriffsrechte zum Laufzeit

Abschnitt mit dem Titel „Zugriffsrechte zum Laufzeit“

Auf die Zwischenablage kopieren

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

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

• requestPermissions() __CAPGO_KEEP_0__
• requestFullScreenIntentPermission() eröffnet die Android 14 und späteren Einstellungen-Seite für Vollbild-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: Identifikator für den Benachrichtigungs-Kanal
• channelName: sichtbarer Kanalname für den Benutzer
• showFullScreen: Anfrage für das Vollbild-Activity
• isHighPriority: Halte die Benachrichtigung für Klingelströme genug störend
• accentColor: Kompatibilität für die Farbgebung von Benachrichtigungen
• ringtoneUri: Zeige 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 die Eingangsanruf-Notifikation.
• Zeitüberschreitungshandling ist ein Bestreben. Der Plugin verfolgt und sendet timeoutMs und callTimedOut, aber Ihre Backend sollte die verpassten Anrufe auf seiner Seite nochmals abgleichen.
• Akzeptieren, ablehnen und beenden sind über die Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anrufsession anschließen oder sie aufräumen kann.

Empfohlene Produktionsmodell

Wenden Sie sich für die Transportversorgung an Android Push oder Ihre Ruf SDK-Funktion und lassen Sie dieses Plugin die letzte Meile der nativen Klingel-UI übernehmen. Halten Sie diese Verantwortlichkeiten außerhalb des Plugins:

• Registrierung und Token-Verwaltung von FCM
• Lebenszyklus der Medien-Sitzung
• Hintergrundanforderungszustand
• Wiederholungs- und verpasste-Anruf-Unternehmenslogik

Fortsetzen von 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.