انتقل إلى المحتوى

معالج مخصص لأحداث المكالمات على 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 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 إنشاء المشروع الأصلي، لذا أضف المعالج عبر مكوّن إضافي محلي. ينسخ ملف 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 إضافية.

روابط ذات صلة

Anchor link to