सामग्री पर जाएं

Android पर कस्टम कॉल इवेंट हैंडलर

कस्टम कॉल इवेंट हैंडलर आपकी अपनी Java क्लास है, जो नेटिव Android साइड पर VoIP कॉल इवेंट प्राप्त करती है। इसका उपयोग तब करें जब उपयोगकर्ता कॉल का उत्तर दे और आप अपनी कॉल स्क्रीन खोलना चाहते हों, या कॉल इवेंट को ऐप के उस हिस्से तक पहुँचाना हो जहाँ मुख्य WebView नहीं पहुँच सकता, जैसे अपने WebView वाली दूसरी activity।

हैंडलर कैसे काम करता है

Anchor link to
  • हर कॉल इवेंट के लिए, प्लगइन पहले JavaScript इवेंट मुख्य WebView को भेजता है, फिर आपके हैंडलर को कॉल करता है। आपके registerEvent लिसनर काम करते रहते हैं।
  • जब हैंडलर सेट होता है, तो उत्तर देने पर प्लगइन ऐप को फ़ोरग्राउंड में नहीं लाता। हैंडलर के बिना, प्लगइन ऐप की लॉन्चर activity खोलता है। हैंडलर होने पर, अपनी स्क्रीन onAnswer में खोलें, वरना ऐप बैकग्राउंड में ही रहता है।
  • ऐप प्रोसेस शुरू होने के बाद पहले कॉल इवेंट पर प्लगइन ऐप मैनिफ़ेस्ट से क्लास का नाम पढ़ता है और रिफ़्लेक्शन के ज़रिए क्लास बनाता है। क्लास में बिना आर्ग्युमेंट वाला public कंस्ट्रक्टर होना चाहिए।
  • कॉलबैक को 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)कैंसल पुश कॉल रद्द करता हैvoipDidCancelCall
onCallCancellationFailed(String callId, String reason)कैंसल पुश लागू नहीं किया जा सकताvoipDidFailToCancelCall
onCallAdded(PushwooshVoIPMessage message)सिस्टम की इन-कॉल सेवा कॉल जोड़ती हैकोई नहीं
onCallRemoved(PushwooshVoIPMessage message)सिस्टम की इन-कॉल सेवा कॉल हटाती हैकोई नहीं

PushwooshVoIPMessage आपको VoIP पुश के मान देता है:

Getterलौटाता है
getCallId()callId, या पुश में न होने पर null
getCallerName()callerName, या पुश में न होने पर Unknown Caller
getHasVideo()video
getSupportsHolding()supportsHolding
getSupportsDTMF()supportsDTMF
getCancelCall()cancelCall
getRawPayload()आपकी कस्टम कुंजियों सहित पूरा पुश Bundle

onCreateIncomingConnection को रॉ Bundle मिलता है। वहां getter इस्तेमाल करने के लिए उसे रैप करें: new PushwooshVoIPMessage(payload)।

1. मैनिफ़ेस्ट में हैंडलर रजिस्टर करें

Anchor link to

<application> में अपने हैंडलर के पूरे क्लास नाम के साथ एक meta-data एंट्री जोड़ें:

<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

यह हैंडलर उत्तर देने पर आपकी कॉल स्क्रीन खोलता है और हर कॉल इवेंट को ऐप के अंदर ब्रॉडकास्ट के रूप में भेजता है:

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/ में जोड़ें और चरण 1 की meta-data एंट्री को android/app/src/main/AndroidManifest.xml में जोड़ें।

android/app/build.gradle में ऐप मॉड्यूल में Pushwoosh calls SDK जोड़ें। प्लगइन की 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 जोड़ती है:

<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