Перейти к содержанию

Собственный обработчик событий звонков на 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 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 пересоздаёт нативный проект, поэтому добавляйте обработчик через локальный плагин. Его 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.

Связанные ссылки

Anchor link to