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
registerEventcontinuam 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 umContextdo aplicativo no seu app, por exemplo na sua subclasse deApplication, comoMyApp.context()faz no exemplo abaixo.
Eventos de chamada
Anchor link toO manipulador implementa com.pushwoosh.calls.listener.CallEventListener. Implemente os oito métodos e deixe vazios os que você não precisar.
| Método | Chamado quando | Evento JavaScript |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | Uma chamada recebida começa a tocar | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | O usuário atende | answer |
onReject(PushwooshVoIPMessage message) | O usuário recusa | reject |
onDisconnect(PushwooshVoIPMessage message) | A chamada termina | hangup |
onCallCancelled(PushwooshVoIPMessage message) | Um push de cancelamento cancela a chamada | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | Um push de cancelamento não pode ser aplicado | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | O serviço de chamadas do sistema adiciona a chamada | Nenhum |
onCallRemoved(PushwooshVoIPMessage message) | O serviço de chamadas do sistema remove a chamada | Nenhum |
PushwooshVoIPMessage fornece os valores do push VoIP:
| Getter | Retorna |
|---|---|
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 toAdicione 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 toEste 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 toCapacitor
Anchor link toAdicione 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.
Cordova
Anchor link toO 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.