안드로이드

안드로이드 동작 방식

안드로이드에서 플러그인은 고 우선순위 incoming-call 알림을 게시하고 플랫폼 및 사용자 설정이 허용하는 경우 전체 화면 액티비티를 표시할 수 있습니다.

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

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

설치 후 cap sync 호스트 앱에 대한 구성이 이미 충분합니다.

런타임 권한

권한

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

• requestPermissions() 안드로이드 13 이상에서 알림 허용 요청
• requestFullScreenIntentPermission() 안드로이드 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알림 채널 식별자
• channelName사용자에게 보이는 채널 이름
• showFullScreen전체 화면 활동 요청
• isHighPriority알람 흐름을 위한 알림이 충분히 방해가 되도록 유지
• accentColor: 알림 표면과 호환되는 색상
• ringtoneUri: 사용자 정의 안드로이드 링톤 리소스나 URI를 가리킨다.

행동 관련 주의 사항

• 전면 표시가 가장 좋지만, 장치 또는 사용자 설정이 이를 막으면 안드로이드는 incoming-call 알림을 표시한다.
• 시간 초과 처리는 가장 좋지만, 플러그인은 timeoutMs 와 callTimedOut을 추적하고 방출한다. 그러나 백엔드에서는 여전히 미스드 콜을 일치시키도록 해야 한다.
• accept, decline, end 액션은 Capacitor 리스너를 통해 다시 방출되므로 앱은 실제 호출 세션에 참여하거나 정리할 수 있다.

권장 프로덕션 모델

안드로이드 푸시 또는 사용자 정의 호출 SDK를 사용하여 전송을 처리한 후, 이 플러그인이 네이티브 링톤 UI를 처리하는 마지막 마일을 맡게 한다. 이 책임은 플러그인 외부에 두어야 한다:

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

안드로이드에서 계속하기

이러한 기능을 사용 중이라면 안드로이드 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-incoming-call-kit을 사용하여 @capgo/capacitor-incoming-call-kit을 사용하여 @capgo/capacitor-live-activities를 사용하여 @capgo/capacitor-incoming-call-kit Capgo의 Native 기능을 사용하는 @capgo/capacitor-live-활동에 대해 @capgo/capacitor-live-활동 Capgo의 Implementation Detail을 사용하는 @capgo/capacitor-live-활동에 대해 Capgo의 Native 기능을 사용하는 @capgo/capacitor-video-플레이어 Capgo의 Native 기능을 사용하는 @capgo/capacitor-video-플레이어에 대해, @capgo/capacitor-video-플레이어 Capgo의 Implementation Detail을 사용하는 @capgo/capacitor-video-플레이어에 대해