안드로이드

설치

Android 동작 방식

Android에서 플러그인은 고 우선순위 incoming-call notification을 게시하고 플랫폼 및 사용자 설정이 허용하는 경우 full-screen activity를 표시할 수 있습니다.

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

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

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

Runtime 권한

온보딩 중이나 incoming-call 표시를 사용하기 전에 이 메소드를 호출하세요:

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

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

requestPermissions() Android 13 이상에서 notification 권한을 요청하세요.
requestFullScreenIntentPermission() Android 14 이상부터는 필요할 때 전체 화면 인텐트를 위한 Android 설정 페이지를 열게 됩니다.

기본 예시

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를 가리킵니다.

행동 관련 참고 사항

전면 화면 표시가 최선의 노력입니다. 장치 또는 사용자 설정이 이를 차단하면 Android는 incoming-call notification을 표시합니다.
시간 초과 처리는 최선의 노력입니다. 플러그인은 timeoutMs 그리고 callTimedOut, 그러나 백엔드에서는 여전히 미스드 콜을 일치시키는 것을 처리해야 합니다.
accept, decline, 및 end 액션은 Capacitor 리스너를 통해 다시 전송되므로 앱이 실제 호출 세션에 참여하거나 정리할 수 있습니다.

권장 프로덕션 모델

Android push 또는 호출 SDK를 사용하여 전송을 처리한 후 이 플러그인이 네이티브 링킹 UI의 마지막 마일을 처리하도록 하십시오. 이 플러그인 외부에서 이러한 책임을 유지하십시오:

FCM 등록 및 토큰 관리
미디어 세션 라이프 사이클
백엔드 호출 상태
재시도 및 미답신业务逻辑

안드로이드에서 계속하기

Capacitor를 사용하는 경우 Android 자연적인 미디어 및 인터페이스 동작을 계획하려면 Capacitor를 사용하여 @capgo/capacitor-incoming-call-kit for the native capability in Using @capgo/capacitor-incoming-call-kit, Capacitor를 사용하여 @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities Capgo의 구현 세부 정보는 @capgo/capacitor-live-activities 에서 찾을 수 있습니다. Capgo의 @capgo/capacitor-video-player을 사용하여 Capgo의 @capgo/capacitor-video-player을 사용하여 native 기능을 사용하고 Capgo의 @capgo/capacitor-video-player Capgo의 구현 세부 정보는 @capgo/capacitor-video-player 에서 찾을 수 있습니다.