Android

Wie Android-Verhalten funktioniert

Auf Android postet das Plugin eine Benachrichtigung für eingehende Anrufe mit hoher Priorität und kann eine volle Bildschirmaktivität erheben, wenn die Plattform- und Benutzereinstellungen dies zulassen.

The Pluginmanifest 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 Die Runtime-Berechtigungen sind ausreichend.

Sektion mit dem Titel „Runtime-Berechtigungen“

Zwischenablage kopieren

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

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

• requestPermissions() Öffnet die Einstellungen von Android 14 und später für volle Bildschirm-Intents, wenn erforderlich.
• requestFullScreenIntentPermission() Grundlegender Beispiel

Sektion mit dem Titel „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 so störend, dass sie für Klingelströme geeignet ist
• accentColor: Kompatibilität mit abgerundeten Benachrichtigungsoberflächen
• ringtoneUri: Punkt 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 den eingehenden Anrufbenachrichtigungs-Dialog.
• Zeitüberschreitungshandling ist willkürlich. Das Plugin verfolgt und sendet timeoutMs und sendet callTimedOutaber Ihre Backend sollte immer noch die verpassten Anrufe auf seiner Seite aufräumen.
• Akzeptieren, ablehnen und beenden sind über Capacitor-Hörer zurückgesendet, damit Ihre App sich dem echten Anrufssitzung beitreten oder sie aufräumen kann.

Empfohlene Produktionsmodell

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

• Registrierung und Token-Verwaltung von FCM
• Lebenszyklus der Medien-Sitzung
• Zustand des Backend-Anrufs
• Neuanlauf und verpasster Anruf-Unternehmenslogik

Fortsetzen von Android

Wenn Sie " Android " verwenden, um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit Mit @capgo/capacitor-incoming-call-kit für die native Fähigkeit in Mit @capgo/capacitor-incoming-call-kit, Mit @capgo/capacitor-live-activities für die native Fähigkeit in Mit @capgo/capacitor-live-activities, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities, 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.