معالج مخصص لأحداث المكالمات على Android
المعالج المخصص لأحداث المكالمات هو فئة Java خاصة بك تستقبل أحداث مكالمات VoIP على جانب Android الأصلي. استخدمه لفتح شاشة المكالمة الخاصة بك عندما يرد المستخدم، أو لتمرير أحداث المكالمات إلى جزء من التطبيق لا يصل إليه WebView الرئيسي، مثل activity ثانية لها WebView خاص بها.
كيف يعمل المعالج
Anchor link to- مع كل حدث مكالمة، يرسل المكوّن الإضافي أولًا حدث JavaScript إلى WebView الرئيسي، ثم يستدعي المعالج الخاص بك. تستمر مستمعات
registerEventالخاصة بك في العمل. - عند تعيين معالج، لا يُحضر المكوّن الإضافي التطبيق إلى الواجهة عند الرد (Answer). بدون معالج، يفتح المكوّن الإضافي launcher activity الخاصة بالتطبيق. مع وجود معالج، افتح شاشتك في
onAnswer، وإلا يبقى التطبيق في الخلفية. - يقرأ المكوّن الإضافي اسم الفئة من ملف manifest الخاص بالتطبيق عند أول حدث مكالمة بعد بدء عملية التطبيق، وينشئ الفئة عبر الانعكاس (reflection). تحتاج الفئة إلى مُنشئ عام بدون وسائط.
- لا تستقبل دوال الاستدعاء
Context. احتفظ بـContextالتطبيق داخل تطبيقك، على سبيل المثال في الفئة الفرعية منApplication، كما تفعلMyApp.context()في المثال أدناه.
أحداث المكالمات
Anchor link toيطبّق المعالج com.pushwoosh.calls.listener.CallEventListener. طبّق جميع الدوال الثماني، واترك الدوال التي لا تحتاجها فارغة.
| الدالة | متى تُستدعى | حدث JavaScript |
|---|---|---|
onCreateIncomingConnection(Bundle payload) | يبدأ رنين مكالمة واردة | voipPushPayload |
onAnswer(PushwooshVoIPMessage message, int videoState) | يرد المستخدم | answer |
onReject(PushwooshVoIPMessage message) | يرفض المستخدم المكالمة | reject |
onDisconnect(PushwooshVoIPMessage message) | تنتهي المكالمة | hangup |
onCallCancelled(PushwooshVoIPMessage message) | يُلغي push الإلغاء المكالمة | voipDidCancelCall |
onCallCancellationFailed(String callId, String reason) | يتعذر تطبيق push الإلغاء | voipDidFailToCancelCall |
onCallAdded(PushwooshVoIPMessage message) | تضيف خدمة in-call في النظام المكالمة | لا يوجد |
onCallRemoved(PushwooshVoIPMessage message) | تزيل خدمة in-call في النظام المكالمة | لا يوجد |
يوفر PushwooshVoIPMessage القيم من VoIP push:
| دالة الجلب | تُرجع |
|---|---|
getCallId() | callId، أو null إذا لم يحتوِ عليه الـ push |
getCallerName() | callerName، أو Unknown Caller إذا لم يحتوِ عليه الـ push |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | Bundle الـ push بالكامل، بما في ذلك مفاتيحك المخصصة |
تستقبل onCreateIncomingConnection الـ Bundle الخام. لاستخدام دوال الجلب هناك، غلّفه: new PushwooshVoIPMessage(payload).
1. سجّل المعالج في ملف manifest
Anchor link toأضف إدخال meta-data إلى <application> مع الاسم الكامل لفئة المعالج:
<application ...> <meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER" android:value="com.example.app.MyCallEventHandler" /></application>توضح الخطوة 3 مكان هذا الإدخال في Cordova وفي Capacitor.
2. اكتب المعالج
Anchor link toيفتح هذا المعالج شاشة المكالمة الخاصة بك عند الرد، ويرسل كل حدث مكالمة كـ broadcast داخل التطبيق:
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. أضف الكود إلى مشروعك
Anchor link toCapacitor
Anchor link toأضف فئة المعالج إلى android/app/src/main/java/، وإدخال meta-data من الخطوة 1 إلى android/app/src/main/AndroidManifest.xml.
أضف Pushwoosh calls SDK إلى وحدة التطبيق في android/app/build.gradle. استخدم الإصدار المحدد في ملف المكوّن الإضافي src/android/add-android-voip.gradle:
dependencies { compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"}بدون ذلك، يفشل البناء مع الخطأ package com.pushwoosh.calls.listener does not exist، لأن المكوّن الإضافي يضيف calls SDK إلى وحدته الخاصة فقط.
Cordova
Anchor link toيعيد Cordova إنشاء المشروع الأصلي، لذا أضف المعالج عبر مكوّن إضافي محلي. ينسخ ملف plugin.xml الخاص به الفئة ويضيف meta-data إلى ملف manifest:
<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 إلى تبعية Gradle إضافية.