시작하기

1. 패키지를 설치하세요

   bun add @capgo/capacitor-incoming-call-kit

2. 자연스럽게 프로젝트를 Sync

   bunx cap sync

3. 링 소스 선택 SDK에서 오는 incoming-call 이벤트가 백엔드, Twilio 또는 Stream과 같은 SDK 또는 native push path인 FCM 또는 PushKit과 같은 native push path인지 결정합니다.

인터그레이션의 구조

이 플러그인은 native incoming-call UI만 관리합니다. 앱은 여전히 전송, 인증 및 실제 미디어 세션을 관리합니다.

일반적인 프로덕션 패턴은 다음과 같습니다.

1. 백엔드 또는 SDK가 ring 이벤트를.emit합니다.
2. 앱은 showIncomingCall().
3. 플러그인이 native incoming-call UI를 표시합니다.
4. callAccepted 실제 회의 또는 VoIP 세션에 앱을 참여하도록 앱에게 알려줍니다.
5. callDeclined, callEnded또는 callTimedOut 앱이 원격 상태를 정리하도록 지시합니다.

최소한의 통합

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

await IncomingCallKit.addListener('callAccepted', async ({ call }) => {
  console.log('Accepted', call.callId, call.extra);
  // Start or join your real call session here.
});

await IncomingCallKit.addListener('callDeclined', ({ call }) => {
  console.log('Declined', call.callId);
  // Tell your backend or SDK that the user declined.
});

await IncomingCallKit.addListener('callTimedOut', ({ call }) => {
  console.log('Timed out', call.callId);
  // Clear ringing state in your backend or SDK.
});

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  handle: '+39 555 010 020',
  appName: 'Capgo Phone',
  hasVideo: true,
  timeoutMs: 45_000,
  extra: {
    roomId: 'room-42',
    callerUserId: 'user_ada',
  },
  android: {
    channelId: 'calls',
    channelName: 'Incoming Calls',
    showFullScreen: true,
  },
  ios: {
    handleType: 'phoneNumber',
  },
});

중요한 옵션

• callId: stable identifier 재사용 endCall()
• timeoutMs: best-effort unanswered timeout
• extra: listener 패킷에 JSON이 반영됩니다.
• android.channelId 그리고 android.channelName: Android 알림 채널 조정
• android.showFullScreen: Android incoming-call 전체 화면 액티비티 요청
• ios.handleType: 선택 generic, phoneNumber, 또는 emailAddress CallKit을 위한

활성화된 전화 관리

const { calls } = await IncomingCallKit.getActiveCalls();

await IncomingCallKit.endCall({
  callId: 'call-42',
  reason: 'remote-ended',
});

await IncomingCallKit.endAllCalls({
  reason: 'session-reset',
});

이벤트 모델

• incomingCallDisplayed: 네이티브 UI가 성공적으로 표시되었습니다
• callAccepted: 사용자가 네이티브 UI에서 수락했습니다
• callDeclined: 사용자가 참여하기 전에 거절했습니다
• callEnded: 앱 또는 플랫폼이 추적된 전화 통화를 종료했습니다
• callTimedOut전화는 답변을 받지 못했습니다. timeoutMs

각 이벤트에는 정규화 된 call 데이터와 원본 extra 객체가 포함되어 있습니다.

플랫폼 참고

• iOS iOS iOS
• iOS Android Android
• 웹은 지원되지 않습니다.