Guida
Come usare i contatti in Capacitor
Utilizzo di @capgo/capacitor-contacts
Plugin Capacitor Contacts per gestire i contatti del dispositivo.
Installa
bun add @capgo/capacitor-contacts
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorContacts } from '@capgo/capacitor-contacts';
API in breve
| Metodo | Descrizione |
|---|---|
countContacts |
Conta il numero totale di contatti sul dispositivo. |
createContact |
Crea un nuovo contatto via codice. |
createGroup |
Crea un nuovo gruppo di contatti. |
deleteContactById |
Elimina un contatto tramite ID. |
deleteGroupById |
Elimina un gruppo tramite ID. |
displayContactById |
Visualizza un contatto con il viewer nativo. |
displayCreateContact |
Mostra l'interfaccia nativa per creare un contatto. |
displayUpdateContactById |
Mostra l'interfaccia nativa per aggiornare un contatto specifico. |
getAccounts |
Recupera tutti gli account disponibili sul dispositivo. |
getContactById |
Recupera un contatto specifico tramite ID. |
getContacts |
Recupera tutti i contatti dal dispositivo. |
getGroupById |
Recupera un gruppo specifico tramite ID. |
getGroups |
Recupera tutti i gruppi di contatti. |
isAvailable |
Verifica se i contatti sono disponibili sul dispositivo. |
isSupported |
Verifica se il plugin è supportato sulla piattaforma corrente. |
openSettings |
Apri le impostazioni dei contatti del dispositivo. |
pickContact |
Seleziona un singolo contatto tramite il picker nativo. |
pickContacts |
Seleziona uno o più contatti tramite il contact picker nativo. |
updateContactById |
Aggiorna un contatto esistente tramite ID. |
checkPermissions |
Controlla lo stato attuale dei permessi per i contatti. |
requestPermissions |
Richiedi i permessi per accedere ai contatti. |
Esempi
countContacts()
Conta il numero totale di contatti sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.countContacts();
console.log(result);
createContact()
Crea un nuovo contatto via codice.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.createContact({ contact: {} });
console.log(result);
createGroup()
Crea un nuovo gruppo di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.createGroup({ group: { name: 'example' } });
console.log(result);
deleteContactById()
Elimina un contatto tramite ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({ id: 'id-123' });
deleteGroupById()
Elimina un gruppo tramite ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({ id: 'id-123' });
displayContactById()
Visualizza un contatto con il viewer nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({ id: 'id-123' });
La tabella sopra elenca i 21 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Continua da Usare @capgo/capacitor-contacts
Se stai usando Usare @capgo/capacitor-contacts per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-contacts per i dettagli di implementazione in @capgo/capacitor-contacts, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.