Passer au contenu

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 registerEvent continuent 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 un Context d’application dans votre app, par exemple dans votre sous-classe d’Application, comme le fait MyApp.context() dans l’exemple ci-dessous.

Événements d’appel

Anchor link to

Le 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éthodeAppelée quandÉvénement JavaScript
onCreateIncomingConnection(Bundle payload)Un appel entrant commence à sonnervoipPushPayload
onAnswer(PushwooshVoIPMessage message, int videoState)L’utilisateur répondanswer
onReject(PushwooshVoIPMessage message)L’utilisateur refuse l’appelreject
onDisconnect(PushwooshVoIPMessage message)L’appel se terminehangup
onCallCancelled(PushwooshVoIPMessage message)Un push d’annulation annule l’appelvoipDidCancelCall
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’appelAucun
onCallRemoved(PushwooshVoIPMessage message)Le service d’appel du système supprime l’appelAucun

PushwooshVoIPMessage vous donne les valeurs du push VoIP :

GetterRenvoie
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 to

Ajoutez 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 to

Ce 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 to

Ajoutez 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 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.

Liens connexes

Anchor link to