Android-এ কাস্টম কল ইভেন্ট হ্যান্ডলার
কাস্টম কল ইভেন্ট হ্যান্ডলার হলো আপনার নিজস্ব Java ক্লাস, যা নেটিভ Android দিকে VoIP কল ইভেন্ট গ্রহণ করে। ব্যবহারকারী কলের উত্তর দিলে নিজের কল স্ক্রিন খুলতে, অথবা অ্যাপের এমন কোনো অংশে কল ইভেন্ট পাঠাতে এটি ব্যবহার করুন যেখানে প্রধান WebView পৌঁছাতে পারে না, যেমন নিজস্ব WebView সহ একটি দ্বিতীয় activity।
হ্যান্ডলার কীভাবে কাজ করে
Anchor link to- প্রতিটি কল ইভেন্টে প্লাগইন প্রথমে প্রধান WebView-তে JavaScript ইভেন্ট পাঠায়, তারপর আপনার হ্যান্ডলার কল করে। আপনার
registerEventলিসেনারগুলি কাজ করতে থাকে। - হ্যান্ডলার সেট থাকলে, Answer-এ প্লাগইন অ্যাপকে ফোরগ্রাউন্ডে আনে না। হ্যান্ডলার ছাড়া প্লাগইন অ্যাপের launcher activity খোলে। হ্যান্ডলার থাকলে
onAnswer-এ আপনার স্ক্রিন খুলুন, নইলে অ্যাপ ব্যাকগ্রাউন্ডেই থেকে যায়। - অ্যাপ প্রসেস শুরু হওয়ার পর প্রথম কল ইভেন্টে প্লাগইন অ্যাপ ম্যানিফেস্ট থেকে ক্লাসের নাম পড়ে এবং রিফ্লেকশনের মাধ্যমে ক্লাসটি তৈরি করে। ক্লাসটির আর্গুমেন্ট ছাড়া একটি পাবলিক কনস্ট্রাক্টর প্রয়োজন।
- কলব্যাকগুলি কোনো
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) | সিস্টেমের in-call service কলটি যোগ করে | নেই |
onCallRemoved(PushwooshVoIPMessage message) | সিস্টেমের in-call service কলটি সরিয়ে দেয় | নেই |
PushwooshVoIPMessage আপনাকে VoIP পুশ থেকে মানগুলি দেয়:
| গেটার | রিটার্ন করে |
|---|---|
getCallId() | callId, অথবা পুশে না থাকলে null |
getCallerName() | callerName, অথবা পুশে না থাকলে Unknown Caller |
getHasVideo() | video |
getSupportsHolding() | supportsHolding |
getSupportsDTMF() | supportsDTMF |
getCancelCall() | cancelCall |
getRawPayload() | আপনার কাস্টম কী সহ পুশের সম্পূর্ণ Bundle |
onCreateIncomingConnection কাঁচা Bundle পায়। সেখানে গেটার ব্যবহার করতে, এটি র্যাপ করুন: 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>Cordova এবং Capacitor-এ এই এন্ট্রি কোথায় যায়, তা ধাপ 3-এ দেখানো হয়েছে।
2. হ্যান্ডলার লিখুন
Anchor link toএই হ্যান্ডলার Answer-এ আপনার কল স্ক্রিন খোলে এবং প্রতিটি কল ইভেন্ট অ্যাপের ভেতরে 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/-এ যোগ করুন, এবং ধাপ 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 ডিপেন্ডেন্সি প্রয়োজন নেই।