Android

Android 동작 방식

Android에서 이 플러그인은 우선순위가 높은 수신 전화 알림을 게시하며, 플랫폼 및 사용자 설정이 허용하는 경우 전체 화면 액티비티를 실행할 수 있습니다.

플러그인 매니페스트에 이미 다음 내용이 포함되어 있습니다:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

설치 후, cap sync 해당 설정을 호스트 앱에 병합하기에 충분합니다.

런타임 권한

onboarding 단계나 수신 전화 화면 표시 기능에 의존하기 전에 다음 메서드들을 호출하세요:

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: 커스텀 Android 벨소리 리소스 또는 URI 지정

동작 관련 참고 사항

• 전체 화면 표시는 best-effort로 동작합니다. 기기나 사용자 설정에서 이를 차단하더라도 Android는 수신 전화 알림을 계속 표시합니다.
• 타임아웃 처리는 best-effort로 동작합니다. 플러그인은 추적하고 timeoutMs 이벤트를 발생시킵니다 callTimedOut하지만 누락된 통화는 백엔드 측에서 별도로 정리해야 합니다.
• 수락, 거절, 종료 액션은 Capacitor 리스너를 통해 다시 전달되므로, 앱에서 실제 통화 세션에 참여하거나 정리할 수 있습니다.

권장 프로덕션 모델

Android 푸시 또는 통화용 SDK를 전송 수단으로 사용하고, 네이티브 벨링 UI의 마지막 단계는 이 플러그인에 맡기세요. 다음 책임은 플러그인 외부에 두세요:

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

Android에서 계속하기

사용 중이라면 Android 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-incoming-call-kit 사용하기 @capgo/capacitor-incoming-call-kit를 사용하여 네이티브 기능을 구현하는 경우, @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항, @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player 사용에서의 네이티브 기능 및 @capgo/capacitor-video-player @capgo/capacitor-video-player.의 구현 세부 사항