Inizia a Utilizzare
Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-contacts`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/contacts/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installa
Sezione intitolata “Installa”bun add @capgo/capacitor-contactsbunx cap syncImporta
Sezione intitolata “Importa”import { CapacitorContacts } from '@capgo/capacitor-contacts';API Panoramica
Sezione intitolata “API Panoramica”countContacts
Sezione intitolata “countContacts”Contabilizza il numero totale di contatti sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.countContacts();createContact
Sezione intitolata “createContact”Crea un nuovo contatto in modo programmatico.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createContact({} as CreateContactOptions);createGroup
Sezione intitolata “createGroup”Crea un nuovo gruppo di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createGroup({} as CreateGroupOptions);deleteContactById
Sezione intitolata “deleteContactById”Elimina un contatto per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({} as DeleteContactByIdOptions);deleteGroupById
Sezione intitolata “deleteGroupById”Elimina un gruppo per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({} as DeleteGroupByIdOptions);displayContactById
Sezione intitolata “displayContactById”Visualizza un contatto utilizzando il visualizzatore di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({} as DisplayContactByIdOptions);displayCreateContact
Sezione intitolata “displayCreateContact”Visualizza l'interfaccia utente per la creazione di contatti nativa.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayCreateContact();displayUpdateContactById
Sezione intitolata “displayUpdateContactById”Visualizza l'interfaccia utente per l'aggiornamento dei contatti nativa per un contatto specifico.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayUpdateContactById({} as DisplayUpdateContactByIdOptions);getAccounts
Sezione intitolata “getAccounts”Otteni tutti gli account disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getAccounts();getContactById
Sezione intitolata “getContactById”Ottieni un contatto specifico per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContactById({} as GetContactByIdOptions);getContacts
Sezione intitolata “getContacts”Ottieni tutti i contatti dal dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContacts();getGroupById
Sezione intitolata “getGroupById”Ottieni un gruppo specifico per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroupById({} as GetGroupByIdOptions);getGroups
Sezione intitolata “getGroups”Ottieni tutti i gruppi di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroups();isAvailable
Sezione intitolata “isAvailable”Controlla se i contatti sono disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isAvailable();isSupported
Sezione intitolata “isSupported”Controlla se il plugin è supportato sul corrente sistema operativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isSupported();openSettings
Sezione intitolata “openSettings”Apri le impostazioni dei contatti del dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.openSettings();pickContact
Sezione intitolata “pickContact”Scegli un singolo contatto utilizzando il picker di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
Sezione intitolata “pickContacts”Scegli uno o più contatti utilizzando il picker di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
Sezione intitolata “aggiornaContattoById”Aggiorna un contatto esistente con ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
Sezione intitolata “controllaAutorizzazioni”Controlla lo stato di autorizzazione corrente per i contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
Sezione intitolata “richiediAutorizzazioni”Richiedi le autorizzazioni per accedere ai contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.requestPermissions();Tipo di riferimento
Sezione intitolata “Riferimento di tipo”CountContactsResult
Sezione intitolata “ContattiCountResult”Risultato dalla conta dei contatti.
export interface CountContactsResult { /** * Total number of contacts. * * @since 1.0.0 */ count: number;}CreateContactOptions
Sezione intitolata “Opzioni per la creazione di un contatto”Opzioni per la creazione di un contatto.
export interface CreateContactOptions { /** * Contact information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ contact: Omit<Contact, 'id'>;}CreateContactResult
Sezione intitolata “Risultato dalla creazione di un contatto”Risultato dalla creazione di un contatto.
export interface CreateContactResult { /** * The ID of the newly created contact. * * @since 1.0.0 */ id: string;}CreateGroupOptions
Sezione intitolata “Opzioni per la creazione di un gruppo”Opzioni per la creazione di un gruppo.
export interface CreateGroupOptions { /** * Group information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ group: Omit<Group, 'id'>;}CreateGroupResult
Sezione intitolata “CreateGroupResult”Risultato dalla creazione di un gruppo.
export interface CreateGroupResult { /** * The ID of the newly created group. * * @since 1.0.0 */ id: string;}DeleteContactByIdOptions
Sezione intitolata “DeleteContactByIdOptions”Opzioni per eliminare un contatto per ID.
export interface DeleteContactByIdOptions { /** * The ID of the contact to delete. * * @since 1.0.0 */ id: string;}DeleteGroupByIdOptions
Sezione intitolata “DeleteGroupByIdOptions”Opzioni per eliminare un gruppo per ID.
export interface DeleteGroupByIdOptions { /** * The ID of the group to delete. * * @since 1.0.0 */ id: string;}DisplayContactByIdOptions
Sezione intitolata “DisplayContactByIdOptions”Opzioni per visualizzare un contatto per ID.
export interface DisplayContactByIdOptions { /** * The ID of the contact to display. * * @since 1.0.0 */ id: string;}DisplayCreateContactOptions
Sezione intitolata “Visualizza crea contatto”Opzioni per visualizzare l'interfaccia utente nativa per la creazione di contatti.
export interface DisplayCreateContactOptions { /** * Optional pre-filled contact information for the create UI. * * @since 1.0.0 */ contact?: Omit<Contact, 'id'>;}DisplayCreateContactResult
Sezione intitolata “Visualizza risultato crea contatto”Risultato dalla visualizzazione dell'interfaccia utente nativa per la creazione di contatti.
export interface DisplayCreateContactResult { /** * The ID of the created contact, if one was created. Undefined if the user cancelled. * * @since 1.0.0 */ id?: string;}DisplayUpdateContactByIdOptions
Sezione intitolata “Visualizza aggiorna contatto per ID”Opzioni per visualizzare l'interfaccia utente nativa per l'aggiornamento dei contatti.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
Sezione intitolata “Ottenere risultato conti”Risultato dall'ottenimento dei conti.
export interface GetAccountsResult { /** * List of accounts available on the device. * * @since 1.0.0 */ accounts: Account[];}Fonte di Verità
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin’s src/definitions.tsRiepilogo quando le informazioni pubbliche API cambiano in modo significativo.