Guida
Come utilizzare i Contatti in Capacitor
Utilizzare @capgo/capacitor-contacts
Interfaccia del plugin Capacitor per la gestione dei contatti del dispositivo.
Installa
bun add @capgo/capacitor-contacts
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapacitorContacts } from '@capgo/capacitor-contacts';
Vedi API in breve
| Metodo | Descrizione |
|---|---|
countContacts |
Conta il numero totale di contatti sul dispositivo. |
createContact |
Creare un nuovo contatto in modo programmatico. |
createGroup |
Creare un nuovo gruppo di contatti. |
deleteContactById |
Elimina un contatto per ID. |
deleteGroupById |
Elimina un gruppo per ID. |
displayContactById |
Visualizza un contatto utilizzando il visualizzatore di contatti nativo. |
displayCreateContact |
Display the native create contact UI. |
displayUpdateContactById |
Visualizza l'interfaccia di aggiornamento di contatti nativa per un contatto specifico. |
getAccounts |
Otteni tutti gli account disponibili sul dispositivo. |
getContactById |
Otteni un contatto specifico per ID. |
getContacts |
Otteni tutti i contatti dal dispositivo. |
getGroupById |
Otteni un gruppo specifico per ID. |
getGroups |
Otteni 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 utilizzando il picker dei contatti nativi. |
pickContacts |
Seleziona uno o più contatti utilizzando il picker dei contatti nativi. |
updateContactById |
Aggiorna un contatto esistente per ID. |
checkPermissions |
Controlla lo stato di autorizzazione corrente per i contatti. |
requestPermissions |
Richiedi le autorizzazioni per accedere ai contatti. |
Esempi
countContacts()
Conta il totale di contatti sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.countContacts();
console.log(result);
createContact()
Crea un nuovo contatto in modo programmatico.
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()
Cancella un contatto per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({ id: 'id-123' });
deleteGroupById()
Cancella un gruppo per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({ id: 'id-123' });
displayContactById()
Visualizza un contatto utilizzando il visualizzatore di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({ id: 'id-123' });
La tabella sopra elenca le 21 metodologie di base. I listener e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository di GitHub.
Riferimento completo
Continua dall'uso di @capgo/capacitor-contacts
Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-contacts Usando @capgo/capacitor-contacts per pianificare il dashboard e le API operazioni, connettilo con @capgo/capacitor-contacts per i dettagli di implementazione in @capgo/capacitor-contacts, Getting Started per i dettagli di implementazione in Iniziare, API Panoramica per i dettagli di implementazione in API Panoramica, Introduzione per i dettagli di implementazione in Introduzione, e API Chiavi per i dettagli di implementazione in API Chiavi.