iOS

iOS 동작 방식

iOS에서 incoming call plugin은 CallKit에 incoming call을 보고합니다. CallKit은 시스템 incoming-call sheet와 표준화된 call actions를 제공합니다. native incoming-call UI를 직접 구축하지 않아도 됩니다.

requestPermissions() iOS에서 CallKit은 runtime permission dialog를 요구하지 않기 때문에 즉시 해결됩니다.

기본 예제

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

타입 처리

Use ios.handleType iOS에서 CallKit이 핸들 형식을 제어하는 방법을 지정하는 데 사용하는 방법:

• generic 앱에 특정한 식별자에 대한
• phoneNumber 실제 전화번호에 대한
• emailAddress 이메일 기반의 식별자에 대한

배경 incoming calls

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

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

1. transport가 Apple push 전달을 사용할 때 Push Notifications를 활성화하세요.
2. VoIP push flow를 사용하는 앱에서 Voice over IP 배경 모드를 활성화하세요.
3. 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>

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

이 책임은 앱 layer에서 유지하세요

• PushKit과 APNs 등록
• 인증 및 토큰 갱신
• 실제 회의실 또는 VoIP 세션에 참가하기 전에 callAccepted
• plugin이 방출할 때远程 통화 상태를 종료하거나 일치시키기 전에 callDeclined, callEnded, 또는 callTimedOut

iOS에서 계속 진행하세요

iOS를 사용 중이라면 iOS iOS와 연결하여 @capgo/capacitor incoming call kit Using @capgo/capacitor-incoming-call-kit을 사용하여 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo에서 __CAPGO_KEEP_0__ 플러그인들에 대한 구현 세부 정보 Capgo의 구현 세부 사항에 대한 추가 또는 업데이트 플러그인에 대해 Ionic Enterprise 플러그인 대체 Ionic Enterprise 플러그인 대체의 제품 워크플로에 대해