Controlador personalizado de eventos de llamada en Android
Un controlador personalizado de eventos de llamada es su propia clase Java que recibe los eventos de llamadas VoIP en el lado nativo de Android. Úselo para abrir su propia pantalla de llamada cuando el usuario responde, o para pasar los eventos de llamada a una parte de la aplicación a la que el WebView principal no llega, como una segunda activity con su propio WebView.
Cómo funciona el controlador
Anchor link to- Para cada evento de llamada, el plugin primero envía el evento de JavaScript al WebView principal y después llama a su controlador. Sus listeners de
registerEventsiguen funcionando. - Cuando hay un controlador configurado, el plugin no pone la aplicación en primer plano al responder. Sin controlador, el plugin abre la activity de inicio de la aplicación. Con un controlador, abra su pantalla en
onAnswer; de lo contrario, la aplicación permanece en segundo plano. - El plugin lee el nombre de la clase del manifiesto de la aplicación en el primer evento de llamada después de que se inicia el proceso de la aplicación, y crea la clase mediante reflexión. La clase necesita un constructor público sin argumentos.
- Los callbacks no reciben un
Context. Guarde unContextde la aplicación en su app, por ejemplo en su subclase deApplication, como haceMyApp.context()en el ejemplo siguiente.
Eventos de llamada
Anchor link toEl controlador implementa com.pushwoosh.calls.listener.CallEventListener. Implemente los ocho métodos y deje vacíos los que no necesite.
| Método | Se llama cuando | Evento de JavaScript |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | Una llamada entrante empieza a sonar | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | El usuario responde | answer |
onReject(PushwooshVoIPMessage message) | El usuario rechaza la llamada | reject |
onDisconnect(PushwooshVoIPMessage message) | La llamada termina | hangup |
onCallCancelled(PushwooshVoIPMessage message) | Un push de cancelación cancela la llamada | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | No se puede aplicar un push de cancelación | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | El servicio de llamadas del sistema añade la llamada | Ninguno |
onCallRemoved(PushwooshVoIPMessage message) | El servicio de llamadas del sistema elimina la llamada | Ninguno |
PushwooshVoIPMessage le da los valores del push VoIP:
| Getter | Devuelve |
|---|---|
getCallId() | callId, o null si el push no lo incluye |
getCallerName() | callerName, o Unknown Caller si el push no lo incluye |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | El Bundle completo del push, incluidas sus claves personalizadas |
onCreateIncomingConnection recibe el Bundle sin procesar. Para usar los getters ahí, envuélvalo: new PushwooshVoIPMessage(payload).
1. Registrar el controlador en el manifiesto
Anchor link toAñada una entrada meta-data a <application> con el nombre completo de la clase de su controlador:
<application ...> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /></application>El paso 3 muestra dónde va esta entrada en Cordova y en Capacitor.
2. Escribir el controlador
Anchor link toEste controlador abre su pantalla de llamada al responder y envía cada evento de llamada como un broadcast dentro de la aplicación:
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. Añadir el código a su proyecto
Anchor link toCapacitor
Anchor link toAñada la clase del controlador a android/app/src/main/java/ y la entrada meta-data del paso 1 a android/app/src/main/AndroidManifest.xml.
Añada el SDK de llamadas de Pushwoosh al módulo de la aplicación en android/app/build.gradle. Use la versión indicada en src/android/add-android-voip.gradle del plugin:
dependencies { compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"}Sin ella, la compilación falla con package com.pushwoosh.calls.listener does not exist, porque el plugin añade el SDK de llamadas solo a su propio módulo.
Cordova
Anchor link toCordova regenera el proyecto nativo, así que añada el controlador mediante un plugin local. Su plugin.xml copia la clase y añade el meta-data al manifiesto:
<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 no necesita una dependencia de Gradle adicional.