বিষয়বস্তুতে যান

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 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