iOS

iOS 동작 방식

iOS에서 이 플러그인은 수신 전화를 CallKit에 보고합니다. 그러면 직접 네이티브 수신 전화 UI를 만들지 않고도 시스템 수신 전화 시트와 표준화된 통화 액션을 사용할 수 있습니다.

requestPermissions() CallKit 자체가 런타임 권한 대화상자를 요구하지 않으므로 iOS에서는 즉시 resolve됩니다.

기본 예제

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

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  handle: '+1 555 010 020',
  ios: {
    handleType: 'phoneNumber',
    supportsHolding: true,
    supportsDTMF: false,
  },
});

Handle 타입

사용 ios.handleType CallKit이 handle을 포맷하는 방식을 제어하려면:

• generic 앱 전용 식별자의 경우
• phoneNumber 실제 전화번호의 경우
• emailAddress 이메일 기반 식별자의 경우

백그라운드 수신 전화

이 플러그인은 PushKit이나 APNs를 자동으로 등록하지 않습니다.

iOS에서 진정한 백그라운드 또는 종료 상태에서의 벨소리를 구현하려면, 사용 중인 전송 전략에 맞는 네이티브 Apple push 설정이 호스트 앱에 여전히 필요합니다:

1. 전송 방식이 Apple push delivery를 사용하는 경우 Push Notifications를 활성화하세요.
2. 앱이 VoIP push flow를 사용하는 경우 Voice over IP background mode를 활성화하세요.
3. Capacitor bridge를 사용할 수 있게 되는 즉시 앱으로 incoming-call 이벤트를 전달하고 이 플러그인을 호출하세요.

벨소리 이벤트가 JavaScript에만 존재하는 경우, 앱이 이미 포그라운드에서 실행 중일 때 가장 원활하게 작동합니다.

마이크 및 카메라 권한

CallKit은 미디어 SDK를 대체하지 않습니다. 실제 통화 세션에서 마이크나 카메라 액세스를 사용하는 경우, 해당 사용 설명(usage descriptions)은 여전히 앱에 포함되어 있어야 합니다:

<key>NSMicrophoneUsageDescription</key>
<string>This app uses the microphone for calls.</string>
<key>NSCameraUsageDescription</key>
<string>This app uses the camera for video calls.</string>

실제 통화 흐름에 꼭 필요한 키만 추가하세요.

이 책임은 앱 레이어에 두세요

• PushKit 및 APNs 등록
• 인증 및 토큰 갱신
• 이후 실제 룸 또는 VoIP 세션에 참여 callAccepted
• 플러그인이 이벤트를 발생시키면 원격 통화 상태를 종료하거나 조정 callDeclined, callEnded, 또는 callTimedOut

iOS에서 계속하기

사용 중이라면 iOS 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-incoming-call-kit 사용하기 @capgo/capacitor-incoming-call-kit를 사용하여 네이티브 기능을 구현할 때, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.