연락처 Capacitor 플러그인

@capgo/capacitor-contacts 사용하기

기기 연락처 관리를 위한 Capacitor Contacts Plugin 인터페이스

설치

bun add @capgo/capacitor-contacts
bunx cap sync

bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.

가져오기

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

API 한눈에 보기

메서드	설명
countContacts	기기의 전체 연락처 수를 셉니다.
createContact	프로그램 방식으로 새 연락처를 생성합니다.
createGroup	새 연락처 그룹을 생성합니다.
deleteContactById	ID로 연락처를 삭제합니다.
deleteGroupById	ID로 그룹을 삭제합니다.
displayContactById	네이티브 연락처 뷰어를 통해 연락처를 표시합니다.
displayCreateContact	네이티브 연락처 생성 UI를 표시합니다.
displayUpdateContactById	특정 연락처에 대한 네이티브 연락처 업데이트 UI를 표시합니다.
getAccounts	기기에서 사용 가능한 모든 계정을 가져옵니다.
getContactById	ID로 특정 연락처를 가져옵니다.
getContacts	기기의 모든 연락처를 가져옵니다.
getGroupById	ID로 특정 그룹을 가져옵니다.
getGroups	모든 연락처 그룹을 가져옵니다.
isAvailable	기기에서 연락처 사용이 가능한지 확인합니다.
isSupported	현재 플랫폼에서 플러그인을 지원하는지 확인합니다.
openSettings	기기의 연락처 설정 화면을 엽니다.
pickContact	네이티브 연락처 선택기를 사용하여 연락처 하나를 선택합니다.
pickContacts	네이티브 연락처 선택기를 사용하여 하나 이상의 연락처를 선택합니다.
updateContactById	ID로 기존 연락처를 업데이트합니다.
checkPermissions	연락처의 현재 권한 상태를 확인합니다.
requestPermissions	연락처 접근 권한을 요청합니다.

예시

countContacts()

기기의 전체 연락처 수를 셉니다.

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

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

createContact()

프로그래밍 방식으로 새 연락처를 생성합니다.

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

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

createGroup()

새 연락처 그룹을 생성합니다.

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

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

deleteContactById()

ID를 사용하여 연락처를 삭제합니다.

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

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

deleteGroupById()

ID를 사용하여 그룹을 삭제합니다.

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

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

displayContactById()

네이티브 연락처 뷰어를 통해 연락처를 표시합니다.

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

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

위 테이블에는 21개의 핵심 메서드가 나열되어 있습니다. Listener 및 버전 헬퍼, 각 메서드의 전체 계약(contract)은 다음 문서에서 확인할 수 있습니다. GitHub 리포지토리.

전체 레퍼런스

• GitHub 리포지토리
• 문서
• API 레퍼런스

@capgo/capacitor-contacts 사용하기 단계부터 계속 진행하세요.

사용 중이라면 @capgo/capacitor-contacts 사용하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-contacts @capgo/capacitor-contacts의 구현 세부 사항은 다음과 같습니다. 시작하기 Getting Started의 구현 상세 내용은 API 개요 구현 세부 사항은 API 개요에서 소개 Introduction의 구현 상세 내용은, 그리고 API 키 API Keys의 구현 상세 내용은