Pular para o conteúdo

Manipulador personalizado de eventos de chamada no Android

Um manipulador personalizado de eventos de chamada é a sua própria classe Java que recebe eventos de chamadas VoIP no lado nativo do Android. Use-o para abrir a sua própria tela de chamada quando o usuário atender, ou para passar eventos de chamada para uma parte do aplicativo que a WebView principal não alcança, como uma segunda activity com a sua própria WebView.

Como o manipulador funciona

Anchor link to
  • Para cada evento de chamada, o plugin primeiro envia o evento JavaScript para a WebView principal e depois chama o seu manipulador. Os seus listeners de registerEvent continuam funcionando.
  • Quando um manipulador está definido, o plugin não traz o aplicativo para o primeiro plano ao atender. Sem manipulador, o plugin abre a activity de inicialização do aplicativo. Com um manipulador, abra a sua tela em onAnswer, ou o aplicativo permanecerá em segundo plano.
  • O plugin lê o nome da classe no manifesto do aplicativo no primeiro evento de chamada após o início do processo do aplicativo e cria a classe por reflexão. A classe precisa de um construtor público sem argumentos.
  • Os callbacks não recebem um Context. Mantenha um Context do aplicativo no seu app, por exemplo na sua subclasse de Application, como MyApp.context() faz no exemplo abaixo.

Eventos de chamada

Anchor link to

O manipulador implementa com.pushwoosh.calls.listener.CallEventListener. Implemente os oito métodos e deixe vazios os que você não precisar.

MétodoChamado quandoEvento JavaScript
onCreateIncomingConnection(Bundle payload)Uma chamada recebida começa a tocarvoipPushPayload
onAnswer(PushwooshVoIPMessage message, int videoState)O usuário atendeanswer
onReject(PushwooshVoIPMessage message)O usuário recusareject
onDisconnect(PushwooshVoIPMessage message)A chamada terminahangup
onCallCancelled(PushwooshVoIPMessage message)Um push de cancelamento cancela a chamadavoipDidCancelCall
onCallCancellationFailed(String callId, String reason)Um push de cancelamento não pode ser aplicadovoipDidFailToCancelCall
onCallAdded(PushwooshVoIPMessage message)O serviço de chamadas do sistema adiciona a chamadaNenhum
onCallRemoved(PushwooshVoIPMessage message)O serviço de chamadas do sistema remove a chamadaNenhum

PushwooshVoIPMessage fornece os valores do push VoIP:

GetterRetorna
getCallId()callId, ou null se o push não tiver
getCallerName()callerName, ou Unknown Caller se o push não tiver
getHasVideo()video
getSupportsHolding()supportsHolding
getSupportsDTMF()supportsDTMF
getCancelCall()cancelCall
getRawPayload()O Bundle completo do push, incluindo as suas chaves personalizadas

onCreateIncomingConnection recebe o Bundle bruto. Para usar os getters nele, encapsule-o: new PushwooshVoIPMessage(payload).

1. Registre o manipulador no manifesto

Anchor link to

Adicione uma entrada meta-data em <application> com o nome completo da classe do seu manipulador:

<application ...>
<meta-data
android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER"
android:value="com.example.app.MyCallEventHandler" />
</application>

A etapa 3 mostra onde essa entrada fica no Cordova e no Capacitor.

2. Escreva o manipulador

Anchor link to

Este manipulador abre a sua tela de chamada ao atender e envia cada evento de chamada como um broadcast dentro do aplicativo:

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. Adicione o código ao seu projeto

Anchor link to

Adicione a classe do manipulador em android/app/src/main/java/ e a entrada meta-data da etapa 1 em android/app/src/main/AndroidManifest.xml.

Adicione o SDK de chamadas do Pushwoosh ao módulo do aplicativo em android/app/build.gradle. Use a versão definida em src/android/add-android-voip.gradle do plugin:

dependencies {
compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"
}

Sem ela, o build falha com package com.pushwoosh.calls.listener does not exist, porque o plugin adiciona o SDK de chamadas apenas ao seu próprio módulo.

O Cordova regenera o projeto nativo, então adicione o manipulador por meio de um plugin local. O plugin.xml dele copia a classe e adiciona o meta-data ao manifesto:

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

O Cordova não precisa de uma dependência extra do Gradle.

Anchor link to