Lebih lanjut ke konten utama
@capgo/capacitor-kontak API Perangkat Sumber Terbuka

Kontak Plugin Capacitor

Akses dan kelola kontak perangkat dengan kemampuan baca dan tulis

Install

bun add @capgo/capacitor-contacts bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-contacts
  • pnpm add @capgo/capacitor-contacts
  • yarn add @capgo/capacitor-contacts

Panduan

How to use Kontak di Capacitor

Menggunakan @capgo/capacitor-kontak

Interface Kontak Capacitor untuk mengelola kontak perangkat.

Install

bun add @capgo/capacitor-contacts
bunx cap sync

bunx cap sync menggandakan plugin code native ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

import { CapacitorContacts } from '@capgo/capacitor-contacts';

Kontak API secara singkat

Methode Deskripsi
countContacts Hitung jumlah kontak total di perangkat.
createContact Buat kontak baru secara programatik.
createGroup Buat kelompok kontak baru.
deleteContactById Hapus kontak dengan ID.
deleteGroupById Hapus grup dengan ID.
displayContactById Tampilkan kontak menggunakan viewer kontak asli.
displayCreateContact Tampilkan UI pembuatan kontak asli.
displayUpdateContactById Tampilkan UI pembaruan kontak asli untuk kontak tertentu.
getAccounts Dapatkan semua akun yang tersedia di perangkat.
getContactById Dapatkan kontak tertentu dengan ID.
getContacts Dapatkan semua kontak dari perangkat.
getGroupById Dapatkan grup kontak tertentu dengan ID.
getGroups Dapatkan semua grup kontak.
isAvailable Periksa jika kontak tersedia di perangkat.
isSupported Periksa jika plugin ini kompatibel dengan platform saat ini.
openSettings Terbuka pengaturan kontak perangkat.
pickContact Memilih kontak tunggal menggunakan picker kontak asli.
pickContacts Pilih satu atau lebih kontak menggunakan picker kontak asli.
updateContactById Update kontak yang sudah ada dengan ID.
checkPermissions Periksa status izin kontak saat ini.
requestPermissions Minta izin untuk mengakses kontak.

Contoh

countContacts()

Hitung jumlah kontak total di perangkat.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.countContacts();
console.log(result);

createContact()

Membuat kontak baru secara program.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.createContact({ contact: {} });
console.log(result);

createGroup()

Membuat grup kontak baru.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.createGroup({ group: { name: 'example' } });
console.log(result);

deleteContactById()

Hapus kontak dengan ID.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.deleteContactById({ id: 'id-123' });

deleteGroupById()

Hapus grup dengan ID.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.deleteGroupById({ id: 'id-123' });

displayContactById()

Menampilkan kontak menggunakan penampil kontak asli.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.displayContactById({ id: 'id-123' });

Daftar di atas menampilkan 21 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat di GitHub repository.

Dokumentasi

Teruskan dari Menggunakan @capgo/capacitor-contacts

Menggunakan @ Menggunakan @capgo/capacitor-kontak hubungi untuk merencanakan dashboard dan operasional API @capgo/capacitor-contacts untuk detail implementasi di @capgo/capacitor-kontak Mulai Menggunakan untuk detail implementasi di Getting Started, API Pengenalan untuk detail implementasi di API Pengenalan Pendahuluan untuk detail implementasi di Pendahuluan, dan API Kunci untuk detail implementasi di API Kunci

FAQ

FAQ Kontak Plugin

Bagaimana cara menginstal plugin Kontak di sebuah Capacitor aplikasi?

Jalankan "bun add @capgo/capacitor-contacts" (atau "npm install @capgo/capacitor-contacts"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap code native. Import dari "@capgo/capacitor-contacts" di aplikasi code Anda.

Apakah @capgo/capacitor-contacts berfungsi dengan React, Vue dan Angular?

Iya. Kontak adalah paket Capacitor, sehingga berfungsi dengan semua framework web yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte dan JavaScript biasa.

Mana Capacitor versi yang didukung oleh @capgo/capacitor-contacts?

Plugin Capgo mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang dipertahankan.

Apakah @capgo/capacitor-contacts gratis dan terbuka sumber?

Ya. Sumber code yang terbuka di GitHub di https://github.com/Cap-go/capacitor-contacts/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya bisa memperbarui code yang menggunakan Contacts tanpa review App Store?

Pemasangan atau pengupgrade plugin mengubah code native, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa berlalu-lalang dengan Capgo live updates.

Kirim perubahan Kontak tanpa menunggu tinjauan aplikasi

Saat plugin sudah ada di toko Anda, Capgo pembaruan hidup membagikan perubahan JavaScript, HTML, dan CSS Anda kepada pengguna dalam menit.

Mulai dengan Capgo