iOS

iOS 동작 방식

iOS에서 플러그인은 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,
  },
});

Handle 유형

CallKit이 handle을 어떻게 형식화하는지 제어하기 위해 사용합니다. ios.handleType app-specific identifiers

• generic for app-specific identifiers
• phoneNumber 실제 전화번호를 위한
• emailAddress 이메일 기반 식별자에 대한

배경 incoming calls

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

iOS에서 실제 배경 또는 종료된 상태의 링을 위해, 호스트 앱은 여전히 native Apple push 설정이 필요합니다. 이 설정은 transport 전략에 맞춰야 합니다.:

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

앱이 이미 foreground에서 실행 중일 때, 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>

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

앱层에서 이 책임을 유지하세요

• PushKit 및 APNs 등록
• 인증 및 토큰 갱신
• 실제 회의실 또는 VoIP 세션에 참가할 때 callAccepted
• 플러그인으로부터 remote call 상태를 종료하거나 일치시키는 경우 callDeclined, callEnded앱에서 이 책임을 유지하세요 callTimedOut

iOS에서 계속하세요

iOS를 사용하여 iOS native 플러그인 작업을 계획하려면 Using @capgo/capacitor-incoming-call-kit native 기능을 사용하기 위해 @capgo/capacitor-incoming-call-kit과 연결하세요. Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우를 위해 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 implementation detail을 위해 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 implementation detail을 위해 Ionic Enterprise 플러그인 대체품 Ionic Enterprise 플러그인 대체 제품의 제품 워크플로에 대해.