안드로이드

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 표시를 사용하기 전에 onboard 또는 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',
  },
});

Android 전용 옵션

• channelId: 알림 채널 식별자
• channelName: 사용자에게 표시되는 채널 이름
• showFullScreen: 전체 화면 활동을 요청합니다.
• isHighPriority: 알람 흐름을 유지하기 위해 알림을 충분히 방해하는
• accentColor: 알림 표면에 호환되는 색조
• ringtoneUri: 사용자 지정 안드로이드 알람 소음 리소스 또는 URI를 참조하십시오.

행동 설명

• 시간 초과 처리는 가장 좋지만, 플러그인은
• 및 timeoutMs 발생 callTimedOut, 그러나 백엔드에서는 여전히 미충족된 호출에 대한 일정을 일괄 처리해야 합니다.
• accept, decline, 및 end 액션은 Capacitor 리스너를 통해 다시 전송되므로 앱이 실제 호출 세션을 연결하거나 정리할 수 있습니다.

권장 프로덕션 모델

Android 푸시를 사용하거나 SDK를 호출하여 전송하고 이 플러그인을 통해 네이티브 링 링 UI를 처리하십시오. 이 플러그인 외부에서 다음의 책임을 유지하십시오:

• FCM 등록 및 토큰 관리
• 미디어 세션 라이프사이클
• 백엔드 호출 상태
• 재시도 및 미충족 호출 비즈니스 로직