iOS

__CAPGO_KEEP_0__

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

기본 예시

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 calls

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

iOS에서 실제 배경 또는 종료된 상태의 벨소리 효과를 얻으려면, 호스트 앱은 native Apple push 설정을 사용해야 합니다. 그 설정은 transport 전략에 맞춰야 합니다.

Apple push 전송을 사용하는 transport가 있는 경우 Push Notifications를 활성화하세요.
VoIP push flow를 사용하는 앱이면 Voice over IP 배경 모드를 활성화하세요.
incoming-call 이벤트를 앱에 전달하고 Capacitor bridge가 사용 가능해질 때 이 플러그인을 호출하세요.

앱이 이미 foreground에서 실행 중일 때 ring 이벤트가 JavaScript에서만 존재한다면, 가장 좋은 경험을 얻을 수 있습니다.

마이크 및 카메라 권한

CallKit does not replace your media SDK. If the real call session uses microphone or camera access, those usage descriptions still belong in your app:

<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
플러그인으로부터 remote call 상태가 종료되거나 일치할 때 callDeclined, callEnded또는 callTimedOut

iOS에서 계속하세요

자연스러운 플러그인 작업을 계획할 때 iOS 자연스러운 플러그인 작업을 계획할 때 Using @capgo/capacitor incoming call kit for the native capability in Using @capgo/capacitor incoming call kit Capgo 플러그인 디렉토리 for the product workflow in Capgo 플러그인 디렉토리 Capacitor 플러그인들 - Capgo for the implementation detail in Capacitor 플러그인들 - Capgo 플러그인 추가 또는 업데이트 for the implementation detail in 플러그인 추가 또는 업데이트 아이오닉 엔터프라이즈 플러그인 대안 for the product workflow in 아이오닉 엔터프라이즈 플러그인 대안