__CAPGO_KEEP_0__
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
Android 동작 방법
Android 동작 방법 섹션Android에서 플러그인은 플랫폼 및 사용자 설정이 허용하는 경우 incoming-call 알림을 우선 순위로 게시하고, 전체 화면 활동을 올릴 수 있습니다.
플러그인 매니페스트에는 이미 포함되어 있습니다:
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /><uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />설치 후 cap sync 호스트 앱에 대한 구성이 이미 충분합니다.
런타임 권한
런타임 권한온보딩 또는 incoming-call 표시를 의존하기 전에 이 메서드를 호출하십시오.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
await IncomingCallKit.requestPermissions();await IncomingCallKit.requestFullScreenIntentPermission();requestPermissions()Android 13 이상에서 요청 알림 권한을 요청합니다.requestFullScreenIntentPermission()필요한 경우 Android 14 이상의 설정 페이지를 열어 전체 화면 인텐트를 위한 권한을 설정합니다.
기본 예제
클립보드에 복사import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
await IncomingCallKit.showIncomingCall({ callId: 'call-42', callerName: 'Ada Lovelace', appName: 'Capgo Phone', timeoutMs: 45_000, android: { channelId: 'calls', channelName: 'Incoming Calls', showFullScreen: true, isHighPriority: true, accentColor: '#0F766E', },});알림 채널 식별자
사용자에게 표시되는 채널 이름channelId__CAPGO_KEEP_0__channelName__CAPGO_KEEP_0__showFullScreen: incoming call 화면을 요청합니다.isHighPriority: 알림이 울리는 흐름을 유지하기 위해 알림을 방해하는 정도를 유지하세요.accentColor: 알림 표면의 색상 조정을 호환합니다.ringtoneUri: 사용자 정의 안드로이드 링톤 리소스나 URI를 지정하세요.
행동 참고
제목: "행동 참고"- 전화가 들어오는 알림은 화면 전체 표시를 최선의 노력으로 합니다. 단말기나 사용자 설정이 화면 전체 표시를 막으면 안드로이드는 여전히 incoming-call 알림을 표시합니다.
- 시간 초과 처리는 최선의 노력입니다. 플러그인은
timeoutMs및callTimedOut, 하지만 백엔드에서는 여전히 놓친 전화에 대해 일치시키기를 처리해야 합니다. - accept, decline, end 액션은 Capacitor 리스너를 통해 다시 방출되므로 앱은 실제 전화 세션에 참여하거나 정리할 수 있습니다.
권장 생산 모델
권장 생산 모델Android 푸시 또는 SDK를 사용하여 수송, 그리고 이 플러그인은 네이티브 링 링 UI를 처리하도록 해주세요. 이 플러그인 외부에서 다음의 책임을 유지하세요:
- FCM 등록 및 토큰 관리
- 미디어 세션 라이프 사이클
- 백엔드 호출 상태
- 재시도 및 미스 콜 비즈니스 로직