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 toCapacitor
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
Anchor link toCordova नेटिव प्रोजेक्ट को फिर से जनरेट करता है, इसलिए हैंडलर को एक लोकल प्लगइन के ज़रिए जोड़ें। इसकी 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 डिपेंडेंसी की ज़रूरत नहीं है।