Saltar al contenido

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 registerEvent siguen 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 un Context de la aplicación en su app, por ejemplo en su subclase de Application, como hace MyApp.context() en el ejemplo siguiente.

Eventos de llamada

Anchor link to

El controlador implementa com.pushwoosh.calls.listener.CallEventListener. Implemente los ocho métodos y deje vacíos los que no necesite.

MétodoSe llama cuandoEvento de JavaScript
onCreateIncomingConnection(Bundle payload)Una llamada entrante empieza a sonarvoipPushPayload
onAnswer(PushwooshVoIPMessage message, int videoState)El usuario respondeanswer
onReject(PushwooshVoIPMessage message)El usuario rechaza la llamadareject
onDisconnect(PushwooshVoIPMessage message)La llamada terminahangup
onCallCancelled(PushwooshVoIPMessage message)Un push de cancelación cancela la llamadavoipDidCancelCall
onCallCancellationFailed(String callId, String reason)No se puede aplicar un push de cancelaciónvoipDidFailToCancelCall
onCallAdded(PushwooshVoIPMessage message)El servicio de llamadas del sistema añade la llamadaNinguno
onCallRemoved(PushwooshVoIPMessage message)El servicio de llamadas del sistema elimina la llamadaNinguno

PushwooshVoIPMessage le da los valores del push VoIP:

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

Añ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 to

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

Añ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 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.

Enlaces relacionados

Anchor link to