Gestionnaire personnalisé d'événements d'appel sur Android
Un gestionnaire personnalisé d’événements d’appel est votre propre classe Java qui reçoit les événements d’appels VoIP côté Android natif. Utilisez-le pour ouvrir votre propre écran d’appel lorsque l’utilisateur répond, ou pour transmettre les événements d’appel à une partie de l’application que la WebView principale ne peut pas atteindre, par exemple une deuxième activity avec sa propre WebView.
Fonctionnement du gestionnaire
Anchor link to- Pour chaque événement d’appel, le plugin envoie d’abord l’événement JavaScript à la WebView principale, puis appelle votre gestionnaire. Vos listeners
registerEventcontinuent de fonctionner. - Lorsqu’un gestionnaire est défini, le plugin ne met pas l’application au premier plan lors de la réponse. Sans gestionnaire, le plugin ouvre l’activity de lancement de l’application. Avec un gestionnaire, ouvrez votre écran dans
onAnswer, sinon l’application reste en arrière-plan. - Le plugin lit le nom de la classe dans le manifeste de l’application lors du premier événement d’appel après le démarrage du processus de l’application, et crée la classe par réflexion. La classe doit avoir un constructeur public sans arguments.
- Les callbacks ne reçoivent pas de
Context. Conservez unContextd’application dans votre app, par exemple dans votre sous-classe d’Application, comme le faitMyApp.context()dans l’exemple ci-dessous.
Événements d’appel
Anchor link toLe gestionnaire implémente com.pushwoosh.calls.listener.CallEventListener. Implémentez les huit méthodes et laissez vides celles dont vous n’avez pas besoin.
| Méthode | Appelée quand | Événement JavaScript |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | Un appel entrant commence à sonner | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | L’utilisateur répond | answer |
onReject(PushwooshVoIPMessage message) | L’utilisateur refuse l’appel | reject |
onDisconnect(PushwooshVoIPMessage message) | L’appel se termine | hangup |
onCallCancelled(PushwooshVoIPMessage message) | Un push d’annulation annule l’appel | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | Un push d’annulation ne peut pas être appliqué | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | Le service d’appel du système ajoute l’appel | Aucun |
onCallRemoved(PushwooshVoIPMessage message) | Le service d’appel du système supprime l’appel | Aucun |
PushwooshVoIPMessage vous donne les valeurs du push VoIP :
| Getter | Renvoie |
|---|---|
getCallId() | callId, ou null si le push n’en contient pas |
getCallerName() | callerName, ou Unknown Caller si le push n’en contient pas |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | Le Bundle complet du push, y compris vos clés personnalisées |
onCreateIncomingConnection reçoit le Bundle brut. Pour y utiliser les getters, encapsulez-le : new PushwooshVoIPMessage(payload).
1. Enregistrer le gestionnaire dans le manifeste
Anchor link toAjoutez une entrée meta-data à <application> avec le nom complet de la classe de votre gestionnaire :
<application ...> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /></application>L’étape 3 indique où placer cette entrée dans Cordova et dans Capacitor.
2. Écrire le gestionnaire
Anchor link toCe gestionnaire ouvre votre écran d’appel lors de la réponse et envoie chaque événement d’appel sous forme de broadcast au sein de l’application :
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. Ajouter le code à votre projet
Anchor link toCapacitor
Anchor link toAjoutez la classe du gestionnaire à android/app/src/main/java/ et l’entrée meta-data de l’étape 1 à android/app/src/main/AndroidManifest.xml.
Ajoutez le SDK d’appels Pushwoosh au module de l’application dans android/app/build.gradle. Utilisez la version définie dans src/android/add-android-voip.gradle du plugin :
dependencies { compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"}Sans elle, la compilation échoue avec package com.pushwoosh.calls.listener does not exist, car le plugin n’ajoute le SDK d’appels qu’à son propre module.
Cordova
Anchor link toCordova régénère le projet natif : ajoutez donc le gestionnaire via un plugin local. Son plugin.xml copie la classe et ajoute le meta-data au manifeste :
<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 n’a pas besoin de dépendance Gradle supplémentaire.