Anleitung
How to use Contacts in Capacitor
Verwendung von @capgo/capacitor-kontakte
Capacitor Kontakt-Plugin-Schnittstelle für die Verwaltung von Gerätekontakten.
Installieren
bun add @capgo/capacitor-contacts
bunx cap sync
bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut aus, nachdem Sie jedes Plugin aktualisiert haben.
Importieren
import { CapacitorContacts } from '@capgo/capacitor-contacts';
API im Überblick
| Methode | Beschreibung |
|---|---|
countContacts |
Zählt die Gesamtzahl der Kontakte auf dem Gerät. |
createContact |
Erstellt einen neuen Kontakt programmatisch. |
createGroup |
Erstellt einen neuen Kontaktgruppe. |
deleteContactById |
Löschen eines Kontakts durch ID. |
deleteGroupById |
Löschen eines Gruppen durch ID. |
displayContactById |
Anzeigen eines Kontakts mit dem nativen Kontakt-Viewer. |
displayCreateContact |
Anzeigen des nativen Kontakt-Erstellungs-UI. |
displayUpdateContactById |
Anzeigen des nativen Kontakt-Update-UI für einen bestimmten Kontakt. |
getAccounts |
Auslesen aller verfügbaren Konten auf dem Gerät. |
getContactById |
Auslesen eines bestimmten Kontakts durch ID. |
getContacts |
Auslesen aller Kontakte vom Gerät. |
getGroupById |
Auslesen einer bestimmten Gruppe durch ID. |
getGroups |
Auslesen aller Kontaktgruppen. |
isAvailable |
Überprüfen, ob Kontakte auf dem Gerät verfügbar sind. |
isSupported |
Überprüfen, ob das Plugin auf der aktuellen Plattform unterstützt wird. |
openSettings |
Öffnen Sie die Kontakteinstellungen des Geräts. |
pickContact |
Wählen Sie einen einzelnen Kontakt mit dem nativen Kontaktpicker aus. |
pickContacts |
Wählen Sie einen oder mehrere Kontakte mit dem nativen Kontaktpicker aus. |
updateContactById |
Ein bestehender Kontakt aktualisieren. |
checkPermissions |
Überprüfen Sie den aktuellen Berechtigungsstatus für Kontakte. |
requestPermissions |
Anfordern Sie die Berechtigung, auf Kontakte zuzugreifen. |
Beispiele
countContacts()
Zählen Sie die Gesamtzahl der Kontakte auf dem Gerät.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.countContacts();
console.log(result);
createContact()
Erstellen Sie einen neuen Kontakt programmatisch.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.createContact({ contact: {} });
console.log(result);
createGroup()
Erstellen Sie eine neue Kontaktgruppe.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
const result = await CapacitorContacts.createGroup({ group: { name: 'example' } });
console.log(result);
deleteContactById()
Löschen Sie einen Kontakt durch ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({ id: 'id-123' });
deleteGroupById()
Löschen Sie eine Gruppe durch ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({ id: 'id-123' });
displayContactById()
Verwenden Sie den native Kontaktanzeiger, um einen Kontakt anzuzeigen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({ id: 'id-123' });
Die Tabelle oben listet die 21 Kernmethoden auf. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind im GitHub-Repository.
Vollständige Referenz
Fortfahren von Using @capgo/capacitor-kontakte
Wenn Sie Capgo verwenden Using @capgo/capacitor-kontakte um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-kontakte für die Implementierungsdetails in @capgo/capacitor-kontakte, Getting Started für die Implementierungsdetails in Einstieg, API Übersicht für die Implementierungsdetails in API Übersicht, Einführung für die Implementierungsdetails in Einführung und API Schlüssel für die Implementierungsdetails in API Schlüssel.