Android의 사용자 지정 통화 이벤트 핸들러
사용자 지정 통화 이벤트 핸들러는 네이티브 Android 측에서 VoIP 통화 이벤트를 받는 자체 Java 클래스입니다. 사용자가 전화를 받을 때 자체 통화 화면을 열거나, 자체 WebView가 있는 두 번째 activity처럼 메인 WebView가 닿지 않는 앱의 다른 부분에 통화 이벤트를 전달할 때 사용합니다.
핸들러 작동 방식
Anchor link to- 모든 통화 이벤트에 대해 플러그인은 먼저 JavaScript 이벤트를 메인 WebView로 보낸 다음 핸들러를 호출합니다. 기존
registerEvent리스너는 계속 작동합니다. - 핸들러가 설정되어 있으면 플러그인은 전화를 받을 때 앱을 포그라운드로 가져오지 않습니다. 핸들러가 없으면 플러그인이 앱의 런처 activity를 엽니다. 핸들러를 사용하는 경우
onAnswer에서 화면을 열어야 하며, 그렇지 않으면 앱이 백그라운드에 머뭅니다. - 플러그인은 앱 프로세스가 시작된 후 첫 번째 통화 이벤트에서 앱 매니페스트의 클래스 이름을 읽고 리플렉션으로 클래스를 생성합니다. 클래스에는 인수가 없는 public 생성자가 있어야 합니다.
- 콜백은
Context를 받지 않습니다. 아래 예제의MyApp.context()처럼, 예를 들어Application하위 클래스에 애플리케이션Context를 보관하세요.
통화 이벤트
Anchor link to핸들러는 com.pushwoosh.calls.listener.CallEventListener를 구현합니다. 8개 메서드를 모두 구현하고, 필요하지 않은 메서드는 비워 두세요.
| 메서드 | 호출 시점 | JavaScript 이벤트 |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | 수신 전화가 울리기 시작할 때 | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | 사용자가 전화를 받을 때 | answer |
onReject(PushwooshVoIPMessage message) | 사용자가 전화를 거절할 때 | reject |
onDisconnect(PushwooshVoIPMessage message) | 통화가 끝날 때 | hangup |
onCallCancelled(PushwooshVoIPMessage message) | 취소 푸시가 통화를 취소할 때 | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | 취소 푸시를 적용할 수 없을 때 | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | 시스템 통화 서비스가 통화를 추가할 때 | 없음 |
onCallRemoved(PushwooshVoIPMessage message) | 시스템 통화 서비스가 통화를 제거할 때 | 없음 |
PushwooshVoIPMessage는 VoIP 푸시의 값을 제공합니다:
| Getter | 반환 값 |
|---|---|
getCallId() | callId, 푸시에 값이 없으면 null |
getCallerName() | callerName, 푸시에 값이 없으면 Unknown Caller |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | 사용자 지정 키를 포함한 전체 푸시 Bundle |
onCreateIncomingConnection은 원시 Bundle을 받습니다. 여기서 getter를 사용하려면 new PushwooshVoIPMessage(payload)로 감싸세요.
1. 매니페스트에 핸들러 등록
Anchor link to<application>에 핸들러의 전체 클래스 이름이 담긴 meta-data 항목을 추가합니다:
<application ...> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /></application>Cordova와 Capacitor에서 이 항목을 어디에 넣는지는 3단계에서 설명합니다.
2. 핸들러 작성
Anchor link to이 핸들러는 전화를 받을 때 통화 화면을 열고, 각 통화 이벤트를 앱 내부 브로드캐스트로 보냅니다:
public class MyCallEventHandler implements CallEventListener { public static final String ACTION_CALL_EVENT = "com.example.app.CALL_EVENT";
/** * Called when the user answers the call. * Opens the app on the call screen and broadcasts the event to the rest of the app. */ @Override public void onAnswer(@NonNull PushwooshVoIPMessage message, int videoState) { Context context = MyApp.context(); // your application Context
Intent intent = new Intent(context, VideoCallActivity.class) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP) .putExtra("callId", message.getCallId()); context.startActivity(intent);
broadcast("answer", message); }
@Override public void onReject(@NonNull PushwooshVoIPMessage message) { broadcast("reject", message); }
@Override public void onDisconnect(@NonNull PushwooshVoIPMessage message) { broadcast("hangup", message); }
@Override public void onCallCancelled(@NonNull PushwooshVoIPMessage message) { broadcast("cancelled", message); }
@Override public void onCreateIncomingConnection(@Nullable Bundle payload) {} @Override public void onCallAdded(@NonNull PushwooshVoIPMessage message) {} @Override public void onCallRemoved(@NonNull PushwooshVoIPMessage message) {} @Override public void onCallCancellationFailed(@Nullable String callId, @NonNull String reason) {}
private static void broadcast(String event, PushwooshVoIPMessage message) { Context context = MyApp.context(); // your application Context Intent intent = new Intent(ACTION_CALL_EVENT) .setPackage(context.getPackageName()) .putExtra("event", event) .putExtra("callId", message.getCallId()); context.sendBroadcast(intent); }}3. 프로젝트에 코드 추가
Anchor link toCapacitor
Anchor link to핸들러 클래스를 android/app/src/main/java/에 추가하고, 1단계의 meta-data 항목을 android/app/src/main/AndroidManifest.xml에 추가합니다.
android/app/build.gradle의 앱 모듈에 Pushwoosh calls SDK를 추가합니다. 플러그인의 src/android/add-android-voip.gradle에 설정된 버전을 사용하세요:
dependencies { compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"}이 의존성이 없으면 플러그인이 calls SDK를 자체 모듈에만 추가하기 때문에 package com.pushwoosh.calls.listener does not exist 오류로 빌드가 실패합니다.
Cordova
Anchor link toCordova는 네이티브 프로젝트를 다시 생성하므로 로컬 플러그인을 통해 핸들러를 추가합니다. 로컬 플러그인의 plugin.xml이 클래스를 복사하고 매니페스트에 meta-data를 추가합니다:
<platform name="android"> <source-file src="src/android/MyCallEventHandler.java" target-dir="src/com/example/app" />
<config-file target="AndroidManifest.xml" parent="/manifest/application"> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /> </config-file></platform>Cordova에는 추가 Gradle 의존성이 필요하지 않습니다.