안드로이드

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

안드로이드 동작 방식

안드로이드에서 플러그인은 고 우선 순위 incoming-call 알림을 게시하고 플랫폼 및 사용자 설정이 허용하는 경우 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() Android 13 이상에서 incoming-call 표시를 요청합니다.
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: 알림 채널 식별자
channelName: 사용자에게 보이는 채널 이름
showFullScreen: 전체 화면 활동을 요청합니다.
isHighPriority: 울리는 흐름을 위해 알림이 방해가 되도록 유지합니다.
accentColor: 알림 표면에 호환되는 색상 조합을 사용합니다.
ringtoneUri: 사용자 정의 안드로이드 링턴을 URI 또는 리소스에 대한 포인터로 지정합니다.

행동 기록

전화 알림이 표시되는 경우 전면 화면 표시가 가장 좋습니다. 단말기 또는 사용자 설정이 표시를 차단하는 경우 Android에서는 incoming-call 알림을 표시합니다.
시간 초과 처리는 가장 좋습니다. 플러그인은 timeoutMs 및 callTimedOut, 하지만 백엔드에서 미스드 콜을 일치시키기 위해 여전히 reconcile해야 합니다.
Accept, decline, and end actions은 Capacitor 리스너를 통해 다시 전송되므로 앱이 실제 전화 세션에 참여하거나 정리할 수 있습니다.

권장 생산 모델

Android 푸시 또는 전화 SDK를 사용하여 전송을 처리한 후 이 플러그인이 네이티브 링 링 UI를 처리하도록 하십시오. 플러그인 외부에서 다음의 책임을 유지하십시오:

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

안드로이드에서 계속하기

Capgo를 사용 중이라면 안드로이드 자연/native 미디어 및 인터페이스 동작을 계획할 때 Cloudflare의 @capgo/capacitor-incoming-call-kit Cloudflare의 @capgo/capacitor-incoming-call-kit Using @capgo/capacitor-live-activities Cloudflare의 @capgo/capacitor-live-activities Cloudflare의 @capgo/capacitor-live-activities @capgo/capacitor-live-활동의 구현 세부 정보를 위해 Using @capgo/capacitor-비디오 플레이어 Using @capgo/capacitor-비디오 플레이어의 원시 기능을 위해 @capgo/capacitor-비디오 플레이어 @capgo/capacitor-비디오 플레이어의 구현 세부 정보를 위해