Permessi Plugin Capacitor

Usare @capgo/capacitor-permissions

Un unico API TypeScript per verificare e richiedere i permessi runtime su iOS, Android e web, con codici di stato normalizzati.

Installa

bun add @capgo/capacitor-permissions
bunx cap sync

Cosa espone questo plugin

• check - Leggi lo stato attuale di un permesso senza mostrare prompt.
• request - Richiedi un permesso all'utente.
• checkMultiple - Controlla più permessi senza mostrare prompt.
• requestMultiple - Richiedi più permessi in sequenza.
• shouldShowRationale - Indica se Android deve mostrare una spiegazione prima di richiedere di nuovo.
• openSettings - Apri le impostazioni dell'app o delle notifiche quando l'accesso è bloccato.
• requestPreciseLocation - Passa alla posizione precisa su iOS e alla posizione accurata su Android.
• getPluginVersion - Restituisce il marker di versione dell'implementazione della piattaforma.

Esempio d'uso

check e request

import { Permissions } from '@capgo/capacitor-permissions';

export async function ensureCamera(): Promise<boolean> {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'granted') return true;
  const { status: afterRequest } = await Permissions.request({ permission: 'camera' });
  return afterRequest === 'granted';
}

openSettings

import { Permissions } from '@capgo/capacitor-permissions';

document.getElementById('camera-settings')?.addEventListener('click', async () => {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'blocked') {
    await Permissions.openSettings({ type: 'application' });
  }
});

Riferimento completo

• GitHub: https://github.com/Cap-go/capacitor-permissions/
• Docs: /docs/plugins/permissions/