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-Contextin Ihrer App, zum Beispiel in IhrerApplication-Unterklasse, wie esMyApp.context()im Beispiel unten tut.
Anrufereignisse
Anchor link toDer Handler implementiert com.pushwoosh.calls.listener.CallEventListener. Implementieren Sie alle acht Methoden und lassen Sie die nicht benötigten leer.
| Methode | Aufgerufen, wenn | JavaScript-Ereignis |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | Ein eingehender Anruf zu klingeln beginnt | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | Der Benutzer den Anruf annimmt | answer |
onReject(PushwooshVoIPMessage message) | Der Benutzer den Anruf ablehnt | reject |
onDisconnect(PushwooshVoIPMessage message) | Der Anruf endet | hangup |
onCallCancelled(PushwooshVoIPMessage message) | Ein Abbruch-Push den Anruf abbricht | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | Ein Abbruch-Push nicht angewendet werden kann | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | Der In-Call-Service des Systems den Anruf hinzufügt | Keines |
onCallRemoved(PushwooshVoIPMessage message) | Der In-Call-Service des Systems den Anruf entfernt | Keines |
PushwooshVoIPMessage liefert Ihnen die Werte aus dem VoIP-Push:
| Getter | Gibt 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 toFü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 toDieser 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 toCapacitor
Anchor link toFü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
Anchor link toCordova 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.