Собственный обработчик событий звонков на Android
Собственный обработчик событий звонков — это ваш Java-класс, который получает события VoIP-звонков на нативной стороне Android. С его помощью можно открывать свой экран звонка, когда пользователь отвечает, или передавать события звонков в ту часть приложения, до которой не дотягивается основной WebView, например во вторую activity со своим WebView.
Как работает обработчик
Anchor link to- На каждое событие звонка плагин сначала отправляет JavaScript-событие в основной WebView, а затем вызывает ваш обработчик. Ваши слушатели
registerEventпродолжают работать. - Если обработчик задан, плагин не выводит приложение на передний план при ответе (Answer). Без обработчика плагин открывает launcher activity приложения. С обработчиком откройте свой экран в
onAnswer, иначе приложение останется в фоне. - Плагин читает имя класса из манифеста приложения при первом событии звонка после запуска процесса приложения и создаёт класс через рефлексию. Классу нужен публичный конструктор без аргументов.
- Колбэки не получают
Context. ХранитеContextприложения в самом приложении, например в своём подклассеApplication, как это делаетMyApp.context()в примере ниже.
События звонков
Anchor link toОбработчик реализует com.pushwoosh.calls.listener.CallEventListener. Реализуйте все восемь методов, а ненужные оставьте пустыми.
| Метод | Когда вызывается | JavaScript-событие |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | Входящий звонок начинает звонить | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | Пользователь отвечает | answer |
onReject(PushwooshVoIPMessage message) | Пользователь отклоняет звонок | reject |
onDisconnect(PushwooshVoIPMessage message) | Звонок завершается | hangup |
onCallCancelled(PushwooshVoIPMessage message) | Push отмены отменяет звонок | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | Push отмены не удаётся применить | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | Системный in-call service добавляет звонок | Нет |
onCallRemoved(PushwooshVoIPMessage message) | Системный in-call service удаляет звонок | Нет |
PushwooshVoIPMessage даёт значения из VoIP push:
| Геттер | Возвращает |
|---|---|
getCallId() | callId или null, если в push его нет |
getCallerName() | callerName или Unknown Caller, если в push его нет |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | Весь Bundle push, включая ваши собственные ключи |
onCreateIncomingConnection получает исходный Bundle. Чтобы использовать в нём геттеры, оберните его: new PushwooshVoIPMessage(payload).
1. Зарегистрируйте обработчик в манифесте
Anchor link toДобавьте запись meta-data в <application> с полным именем класса вашего обработчика:
<application ...> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /></application>Шаг 3 показывает, куда добавить эту запись в Cordova и в Capacitor.
2. Напишите обработчик
Anchor link toЭтот обработчик открывает ваш экран звонка при ответе и отправляет каждое событие звонка как broadcast внутри приложения:
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/, а запись meta-data из шага 1 — в android/app/src/main/AndroidManifest.xml.
Добавьте Pushwoosh calls SDK в модуль приложения в android/app/build.gradle. Используйте версию, заданную в файле плагина src/android/add-android-voip.gradle:
dependencies { compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"}Без этой зависимости сборка завершается ошибкой package com.pushwoosh.calls.listener does not exist, потому что плагин добавляет calls SDK только в собственный модуль.
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.