iOS

iOS 동작 방식

iOS에서 플러그인은 CallKit에 incoming call을 보고합니다. 이로 인해 시스템 incoming-call 시트 및 표준화된 호출 작업을 제공할 수 있습니다. native incoming-call UI를 직접 구축하지 않아도 됩니다.

requestPermissions() iOS에서 CallKit 자체가 런타임 권한 대화창을 요구하지 않기 때문에 iOS에서 즉시 해결됩니다.

기본 예시

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,
  },
});

핸들 유형

사용 ios.handleType CallKit이 핸들을 형식화하는 방법을 제어하기 위해:

• generic 앱 고유 식별자
• phoneNumber 실제 전화번호
• emailAddress 이메일 기반 식별자

배경 incoming 호출

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

iOS에서 실제 배경 또는 종료 상태의 링잉을 원한다면, 호스트 앱은 네이티브 애플 푸시 설정이 Transport 전략과 일치해야 합니다.

1. Apple 푸시 전달을 사용하는 Transport가 있는 경우 Push Notifications를 활성화하세요.
2. VoIP 푸시 흐름을 사용하는 앱에서 Voice over IP 배경 모드를 활성화하세요.
3. Capacitor 브릿지가 사용 가능할 때 incoming-call 이벤트를 앱에 전달하고 이 플러그인을 호출하세요.

JavaScript에서만 Ring 이벤트가 존재하는 경우, 앱이 이미 전면에서 실행 중일 때 최적의 경험을 얻을 수 있습니다.

마이크 및 카메라 권한

CallKit은 미디어 SDK를 대체하지 않습니다. 실제 통화 세션에서 마이크 또는 카메라 접근이 사용되는 경우, 사용 설명이 여전히 앱에 속해야 합니다.

<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>

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

이 책임은 앱 계층에서 유지하세요.

• 푸시 키트 및 APNs 등록
• 인증 및 토큰 갱신
• 실시간 회의 또는 VoIP 세션에 참가하기 callAccepted
• 플러그인에서 전송된 후远程 호출 상태를 종료하거나 일치시키기 callDeclined, callEnded또는 callTimedOut