Android

Come funziona il comportamento Android

Su Android, il plugin invia una notifica di chiamata in arrivo di priorità alta e può elevare un'attività a schermo intero quando le impostazioni della piattaforma e dell'utente lo consentono.

Il manifesto del plugin include già:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

Dopo l'installazione, cap sync __CAPGO_KEEP_0__ è sufficiente per unire quella configurazione con la tua app host.

I permessi di esecuzione

Chiamate questi metodi durante l'onboarding o prima di affidarti alla presentazione della chiamata in arrivo:

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

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

• requestPermissions() richiede il permesso di notifica su Android 13 e successive versioni.
• requestFullScreenIntentPermission() apre la pagina di impostazioni di Android 14 e versioni successive per intenti a schermo intero quando necessario.

Esempio base

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',
  },
});

Optioni specifiche per Android

• channelId: identificatore per il canale di notifica
• channelName: nome del canale visibile dall'utente
• showFullScreen: richiede l'attività a schermo intero
• isHighPriority: mantiene la notifica sufficientemente disturbante per flussi di suono
• accentColor: abilita la notifica compatibile con superfici di notifica
• ringtoneUri: punti a un ringtone personalizzato per Android o a una risorsa/URI

Nota di comportamento

• La presentazione a schermo intero è di tipo best-effort. Se il dispositivo o le impostazioni dell'utente bloccano, Android mostra comunque la notifica di chiamata in arrivo.
• La gestione dei timeout è di tipo best-effort. Il plugin traccia e emette timeoutMs ma il tuo backend dovrebbe ancora riconciliare le chiamate perse sul suo lato. callTimedOutLe azioni di accettazione, rifiuto e fine sono emesse nuovamente attraverso gli ascoltatori __CAPGO_KEEP_0__ affinché il tuo app possa unirsi o pulire la sessione di chiamata reale.
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

Sezione intitolata “Modello di produzione consigliato”

Use Android push or your calling SDK for transport, then let this plugin handle the last mile of native ringing UI. Keep these responsibilities outside the plugin:

• Ciclo di vita della sessione di media
• Timeout handling is best-effort. The plugin tracks __CAPGO_KEEP_0__ and emits __CAPGO_KEEP_1__ but your backend should still reconcile missed calls on its side.
• Stato della chiamata backend
• Logica di business per la ripetizione e la chiamata persa