Zum Inhalt springen

Benutzerdefinierter Handler für Anrufereignisse auf Android

Ein benutzerdefinierter Handler für Anrufereignisse ist Ihre eigene Java-Klasse, die Ereignisse von VoIP-Anrufen auf der nativen Android-Seite empfängt. Damit können Sie Ihren eigenen Anrufbildschirm öffnen, wenn der Benutzer den Anruf annimmt, oder Anrufereignisse an einen Teil der App weitergeben, den die Haupt-WebView nicht erreicht, zum Beispiel eine zweite Activity mit eigener WebView.

So funktioniert der Handler

Anchor link to
  • Bei jedem Anrufereignis sendet das Plugin zuerst das JavaScript-Ereignis an die Haupt-WebView und ruft dann Ihren Handler auf. Ihre registerEvent-Listener funktionieren weiterhin.
  • Wenn ein Handler festgelegt ist, holt das Plugin die App beim Annehmen nicht in den Vordergrund. Ohne Handler öffnet das Plugin die Launcher-Activity der App. Mit einem Handler öffnen Sie Ihren Bildschirm in onAnswer, sonst bleibt die App im Hintergrund.
  • Das Plugin liest den Klassennamen beim ersten Anrufereignis nach dem Start des App-Prozesses aus dem App-Manifest und erstellt die Klasse per Reflection. Die Klasse benötigt einen öffentlichen Konstruktor ohne Argumente.
  • Die Callbacks erhalten keinen Context. Speichern Sie einen Application-Context in Ihrer App, zum Beispiel in Ihrer Application-Unterklasse, wie es MyApp.context() im Beispiel unten tut.

Anrufereignisse

Anchor link to

Der Handler implementiert com.pushwoosh.calls.listener.CallEventListener. Implementieren Sie alle acht Methoden und lassen Sie die nicht benötigten leer.

MethodeAufgerufen, wennJavaScript-Ereignis
onCreateIncomingConnection(Bundle payload)Ein eingehender Anruf zu klingeln beginntvoipPushPayload
onAnswer(PushwooshVoIPMessage message, int videoState)Der Benutzer den Anruf annimmtanswer
onReject(PushwooshVoIPMessage message)Der Benutzer den Anruf ablehntreject
onDisconnect(PushwooshVoIPMessage message)Der Anruf endethangup
onCallCancelled(PushwooshVoIPMessage message)Ein Abbruch-Push den Anruf abbrichtvoipDidCancelCall
onCallCancellationFailed(String callId, String reason)Ein Abbruch-Push nicht angewendet werden kannvoipDidFailToCancelCall
onCallAdded(PushwooshVoIPMessage message)Der In-Call-Service des Systems den Anruf hinzufügtKeines
onCallRemoved(PushwooshVoIPMessage message)Der In-Call-Service des Systems den Anruf entferntKeines

PushwooshVoIPMessage liefert Ihnen die Werte aus dem VoIP-Push:

GetterGibt zurück
getCallId()callId oder null, wenn der Push keinen enthält
getCallerName()callerName oder Unknown Caller, wenn der Push keinen enthält
getHasVideo()video
getSupportsHolding()supportsHolding
getSupportsDTMF()supportsDTMF
getCancelCall()cancelCall
getRawPayload()Das gesamte Push-Bundle, einschließlich Ihrer benutzerdefinierten Schlüssel

onCreateIncomingConnection erhält das rohe Bundle. Um dort die Getter zu verwenden, kapseln Sie es: new PushwooshVoIPMessage(payload).

1. Den Handler im Manifest registrieren

Anchor link to

Fügen Sie <application> einen meta-data-Eintrag mit dem vollständigen Klassennamen Ihres Handlers hinzu:

<application ...>
<meta-data
android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER"
android:value="com.example.app.MyCallEventHandler" />
</application>

Schritt 3 zeigt, wo dieser Eintrag in Cordova und in Capacitor hingehört.

2. Den Handler schreiben

Anchor link to

Dieser Handler öffnet beim Annehmen Ihren Anrufbildschirm und sendet jedes Anrufereignis als Broadcast innerhalb der App:

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. Den Code zu Ihrem Projekt hinzufügen

Anchor link to

Fügen Sie die Handler-Klasse zu android/app/src/main/java/ und den meta-data-Eintrag aus Schritt 1 zu android/app/src/main/AndroidManifest.xml hinzu.

Fügen Sie das Pushwoosh Calls SDK dem App-Modul in android/app/build.gradle hinzu. Verwenden Sie die Version, die in src/android/add-android-voip.gradle des Plugins festgelegt ist:

dependencies {
compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"
}

Ohne sie schlägt der Build mit package com.pushwoosh.calls.listener does not exist fehl, weil das Plugin das Calls SDK nur zu seinem eigenen Modul hinzufügt.

Cordova generiert das native Projekt neu, fügen Sie den Handler daher über ein lokales Plugin hinzu. Dessen plugin.xml kopiert die Klasse und fügt den meta-data-Eintrag zum Manifest hinzu:

<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 benötigt keine zusätzliche Gradle-Abhängigkeit.

Anchor link to