iOS

복사할 수 있는 설치 프롬프트

iOS 동작 방식

iOS에서 플러그인은 CallKit에 incoming call을 보고합니다. 그로 인해 시스템 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,
  },
});

사용

앱 전용 식별자 ios.handleType __CAPGO_KEEP_0__

generic __CAPGO_KEEP_1__
phoneNumber 실제 전화번호
emailAddress 이메일 기반 식별자

배경 incoming calls

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

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

Apple push 전달을 사용하는 경우 Push 알림을 활성화하세요.
VoIP push flow를 사용하는 앱의 경우 Voice over IP 배경 모드를 활성화하세요.
incoming-call 이벤트를 앱에 전달하고 Capacitor 브릿지를 사용할 수 있는 즉시 이 플러그인을 호출하세요.

앱이 이미 전면에서 실행 중일 때, 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
플러그인이 방출할 때远程 통화 상태를 종료하거나 일치시키기 전에 callDeclined, callEnded, 또는 callTimedOut

iOS에서 계속하세요

iOS에서 네이티브 플러그인 작업을 계획하고 있다면 iOS 네이티브 플러그인 작업을 위해 연결하세요. Using @capgo/capacitor-incoming-call-kit Using @capgo/capacitor-incoming-call-kit Capgo Plugin Directory Capgo Plugin Directory Capacitor Plugins by Capgo Capacitor Plugins by Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 Ionic Enterprise Plugin Alternatives Ionic Enterprise 플러그인 대체품의 제품 워크플로우에 대해.