টেলিকম ফ্রেমওয়ার্ক ওভারভিউ

অ্যান্ড্রয়েড টেলিকম ফ্রেমওয়ার্ক (সাধারণভাবে "টেলিকম" নামেও পরিচিত) একটি অ্যান্ড্রয়েড-চালিত ডিভাইসে অডিও এবং ভিডিও কল পরিচালনা করে। এর মধ্যে রয়েছে সিম-ভিত্তিক কল, যেমন কল যা টেলিফোনি ফ্রেমওয়ার্ক ব্যবহার করে এবং ভিওআইপি কল যা ConnectionService API বাস্তবায়ন করে।

টেলিকম যে প্রধান উপাদানগুলি পরিচালনা করে তা হল ConnectionService এবং InCallService

একটি ConnectionService বাস্তবায়ন অন্য পক্ষের সাথে কল সংযোগ করতে VoIP এর মত প্রযুক্তি ব্যবহার করে। একটি ফোনে সবচেয়ে সাধারণ ConnectionService বাস্তবায়ন হল টেলিফোনি ConnectionService । এটি ক্যারিয়ার কল সংযোগ করে।

একটি InCallService বাস্তবায়ন টেলিকম দ্বারা পরিচালিত কলগুলির জন্য একটি ইউজার ইন্টারফেস প্রদান করে এবং ব্যবহারকারীকে এই কলগুলিকে নিয়ন্ত্রণ এবং ইন্টারঅ্যাক্ট করতে দেয়৷ একটি InCallService এর সবচেয়ে সাধারণ বাস্তবায়ন হল ফোন অ্যাপ যা একটি ডিভাইসের সাথে বান্ডিল করা হয়।

টেলিকম একটি সুইচবোর্ড হিসাবে কাজ করে। এটি কলগুলিকে রুট করে যা ConnectionService বাস্তবায়নগুলি কলিং ব্যবহারকারী ইন্টারফেসে প্রদান করে যা InCallService বাস্তবায়ন প্রদান করে।

আপনি নিম্নলিখিত কারণগুলির জন্য টেলিকম APIগুলি বাস্তবায়ন করতে চাইতে পারেন:

একটি প্রতিস্থাপন ফোন অ্যাপ তৈরি করুন

একটি Android ডিভাইসে ডিফল্ট ফোন অ্যাপের জন্য একটি প্রতিস্থাপন তৈরি করতে, InCallService API প্রয়োগ করুন। আপনার বাস্তবায়ন নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে:

  • এটির কোন কলিং ক্ষমতা থাকতে হবে না এবং কল করার জন্য শুধুমাত্র ইউজার ইন্টারফেস থাকতে হবে।
  • টেলিকম ফ্রেমওয়ার্ক যে সমস্ত কল সম্পর্কে সচেতন তা অবশ্যই পরিচালনা করতে হবে এবং কলের প্রকৃতি সম্পর্কে অনুমান করতে হবে না। উদাহরণ স্বরূপ, কলগুলিকে সিম-ভিত্তিক টেলিফোনি কলগুলি মনে করা উচিত নয়, অথবা ভিডিও কলগুলির জন্য টেলিফোনি বিধিনিষেধ প্রয়োগ করার মতো যে কোনও একটি ConnectionService উপর ভিত্তি করে কলিং বিধিনিষেধ প্রয়োগ করা উচিত নয়৷

আরও তথ্যের জন্য, InCallService দেখুন।

একটি কলিং সমাধান সংহত করুন

আপনার কলিং সলিউশনকে অ্যান্ড্রয়েডে একীভূত করতে, আপনার কাছে নিম্নলিখিত বিকল্পগুলি রয়েছে:

  • স্ব-পরিচালিত ConnectionService API প্রয়োগ করুন: এই বিকল্পটি স্বতন্ত্র কলিং অ্যাপ্লিকেশনগুলির বিকাশকারীদের জন্য আদর্শ যারা ডিফল্ট ফোন অ্যাপের মধ্যে তাদের কলগুলি দেখাতে চান না বা তাদের ব্যবহারকারী ইন্টারফেসে অন্য কলগুলিও দেখানো হয় না৷

    আপনি যখন একটি স্ব-পরিচালিত ConnectionService ব্যবহার করেন, তখন আপনি আপনার অ্যাপটিকে শুধুমাত্র ডিভাইসে নেটিভ টেলিফোনি কলিংয়ের সাথে নয়, এই APIটি বাস্তবায়নকারী অন্যান্য স্বতন্ত্র কলিং অ্যাপগুলির সাথেও ইন্টারঅপারেটিং করতে সহায়তা করেন৷ স্ব-পরিচালিত ConnectionService API এছাড়াও অডিও রাউটিং এবং ফোকাস পরিচালনা করে। বিশদ বিবরণের জন্য, একটি কলিং অ্যাপ তৈরি করুন দেখুন।

  • পরিচালিত ConnectionService API প্রয়োগ করুন: এই বিকল্পটি একটি কলিং সমাধানের বিকাশকে সহজ করে যা কলের জন্য ব্যবহারকারীর ইন্টারফেস প্রদানের জন্য বিদ্যমান ডিভাইস ফোন অ্যাপ্লিকেশনের উপর নির্ভর করে। উদাহরণগুলির মধ্যে রয়েছে এসআইপি কলিং এবং ভিওআইপি কলিং পরিষেবাগুলির তৃতীয়-পক্ষ বাস্তবায়ন। আরো বিস্তারিত জানার জন্য, getDefaultDialerPackage() দেখুন।

    শুধুমাত্র একটি ConnectionService শুধুমাত্র কল সংযোগের উপায় প্রদান করে। এটির কোনো সংশ্লিষ্ট ইউজার ইন্টারফেস নেই।

  • InCallService এবং ConnectionService API উভয়ই প্রয়োগ করুন: আপনি যদি আপনার নিজস্ব ConnectionService ভিত্তিক কলিং সলিউশন তৈরি করতে চান, তার নিজস্ব ইউজার ইন্টারফেস দিয়ে সম্পূর্ণ করতে এবং একই ইউজার ইন্টারফেসে অন্য সমস্ত Android কল দেখাতে চাইলে এই বিকল্পটি আদর্শ। আপনি যখন এই পদ্ধতিটি ব্যবহার করেন, তখন আপনার InCallService এর বাস্তবায়নে এটি প্রদর্শিত কলগুলির উত্স সম্পর্কে কোনও অনুমান করা উচিত নয়৷ এছাড়াও, ConnectionService এর আপনার বাস্তবায়ন অবশ্যই আপনার কাস্টম InCallService এ সেট করা ডিফল্ট ফোন অ্যাপ ছাড়াই কাজ চালিয়ে যেতে হবে।

স্ক্রীন কল

যে ডিভাইসগুলি Android 10 (API স্তর 29) বা উচ্চতর চালায় সেগুলি আপনার অ্যাপটিকে সম্ভাব্য স্প্যাম কল হিসাবে ব্যবহারকারীর ঠিকানা বইতে নেই এমন নম্বরগুলি থেকে কলগুলি সনাক্ত করতে দেয়৷ ব্যবহারকারীরা স্প্যাম কলগুলি নিঃশব্দে প্রত্যাখ্যান করা বেছে নিতে পারেন। ব্যবহারকারীরা কল মিস করলে তাদের আরও স্বচ্ছতা প্রদান করতে, এই ব্লক করা কলগুলির তথ্য কল লগে লগ করা হয়। অ্যান্ড্রয়েড 10 এপিআই ব্যবহার করে কল স্ক্রীনিং এবং কলার আইডি কার্যকারিতা প্রদানের জন্য ব্যবহারকারীর কাছ থেকে READ_CALL_LOG অনুমতি পাওয়ার প্রয়োজনীয়তা দূর করে।

আপনি কল স্ক্রিন করার জন্য একটি CallScreeningService বাস্তবায়ন ব্যবহার করেন। নম্বরটি ব্যবহারকারীর যোগাযোগ তালিকায় না থাকলে যেকোনো নতুন ইনকামিং বা আউটগোয়িং কলের জন্য onScreenCall() ফাংশনে কল করুন। আপনি কল সম্পর্কে তথ্যের জন্য Call.Details অবজেক্ট চেক করতে পারেন। বিশেষত, getCallerNumberVerificationStatus() ফাংশন অন্য নম্বর সম্পর্কে নেটওয়ার্ক প্রদানকারীর তথ্য অন্তর্ভুক্ত করে। যাচাইকরণের স্থিতি ব্যর্থ হলে, এটি একটি ভাল ইঙ্গিত যে কলটি একটি অবৈধ নম্বর বা একটি সম্ভাব্য স্প্যাম কল থেকে এসেছে৷

কোটলিন

class ScreeningService : CallScreeningService() {
    // This function is called when an ingoing or outgoing call
    // is from a number not in the user's contacts list
    override fun onScreenCall(callDetails: Call.Details) {
        // Can check the direction of the call
        val isIncoming = callDetails.callDirection == Call.Details.DIRECTION_INCOMING

        if (isIncoming) {
            // the handle (e.g. phone number) that the Call is currently connected to
            val handle: Uri = callDetails.handle

            // determine if you want to allow or reject the call
            when (callDetails.callerNumberVerificationStatus) {
                Connection.VERIFICATION_STATUS_FAILED -> {
                    // Network verification failed, likely an invalid/spam call.
                }
                Connection.VERIFICATION_STATUS_PASSED -> {
                    // Network verification passed, likely a valid call.
                }
                else -> {
                    // Network could not perform verification.
                    // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED.
                }
            }
        }
    }
}

জাভা

class ScreeningService extends CallScreeningService {
    @Override
    public void onScreenCall(@NonNull Call.Details callDetails) {
        boolean isIncoming = callDetails.getCallDirection() == Call.Details.DIRECTION_INCOMING;

        if (isIncoming) {
            Uri handle = callDetails.getHandle();

            switch (callDetails.getCallerNumberVerificationStatus()) {
                case Connection.VERIFICATION_STATUS_FAILED:
                    // Network verification failed, likely an invalid/spam call.
                    break;
                case Connection.VERIFICATION_STATUS_PASSED:
                    // Network verification passed, likely a valid call.
                    break;
                default:
                    // Network could not perform verification.
                    // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED
            }
        }
    }
}

নতুন কলে কীভাবে সাড়া দিতে হবে তা সিস্টেমকে জানাতে respondToCall() কল করতে onScreenCall() ফাংশন সেট করুন। এই ফাংশনটি একটি CallResponse প্যারামিটার নেয় যা আপনি সিস্টেমকে কলটি ব্লক করতে, ব্যবহারকারীর মতো এটি প্রত্যাখ্যান করতে বা নীরব করতে বলতে পারেন। আপনি সিস্টেমকে বলতে পারেন যে ডিভাইসের কল লগে এই কলটি সম্পূর্ণভাবে যোগ করা এড়িয়ে যেতে।

কোটলিন

// Tell the system how to respond to the incoming call
// and if it should notify the user of the call.
val response = CallResponse.Builder()
    // Sets whether the incoming call should be blocked.
    .setDisallowCall(false)
    // Sets whether the incoming call should be rejected as if the user did so manually.
    .setRejectCall(false)
    // Sets whether ringing should be silenced for the incoming call.
    .setSilenceCall(false)
    // Sets whether the incoming call should not be displayed in the call log.
    .setSkipCallLog(false)
    // Sets whether a missed call notification should not be shown for the incoming call.
    .setSkipNotification(false)
    .build()

// Call this function to provide your screening response.
respondToCall(callDetails, response)

জাভা

// Tell the system how to respond to the incoming call
// and if it should notify the user of the call.
CallResponse.Builder response = new CallResponse.Builder();
// Sets whether the incoming call should be blocked.
response.setDisallowCall(false);
// Sets whether the incoming call should be rejected as if the user did so manually.
response.setRejectCall(false);
// Sets whether ringing should be silenced for the incoming call.
response.setSilenceCall(false);
// Sets whether the incoming call should not be displayed in the call log.
response.setSkipCallLog(false);
// Sets whether a missed call notification should not be shown for the incoming call.
response.setSkipNotification(false);

// Call this function to provide your screening response.
respondToCall(callDetails, response.build());

আপনাকে অবশ্যই ম্যানিফেস্ট ফাইলে CallScreeningService ইমপ্লিমেন্টেশনটি যথাযথ উদ্দেশ্য ফিল্টার এবং অনুমতি সহ নিবন্ধন করতে হবে যাতে সিস্টেম এটিকে সঠিকভাবে ট্রিগার করতে পারে৷

<service
    android:name=".ScreeningService"
    android:permission="android.permission.BIND_SCREENING_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.CallScreeningService" />
    </intent-filter>
</service>

একটি কল রিডাইরেক্ট করুন

যে ডিভাইসগুলি অ্যান্ড্রয়েড 10 বা উচ্চতর চালায় সেগুলি অ্যান্ড্রয়েড 9 বা তার কম সংস্করণে চালিত ডিভাইসগুলির থেকে আলাদাভাবে কলের উদ্দেশ্য পরিচালনা করে। Android 10 এবং উচ্চতর সংস্করণে, ACTION_NEW_OUTGOING_CALL সম্প্রচার বন্ধ করা হয়েছে এবং CallRedirectionService API দিয়ে প্রতিস্থাপিত হয়েছে। CallRedirectionService আপনাকে অ্যান্ড্রয়েড প্ল্যাটফর্ম দ্বারা করা বহির্গামী কলগুলি সংশোধন করতে ব্যবহার করার জন্য ইন্টারফেস সরবরাহ করে। উদাহরণস্বরূপ, তৃতীয় পক্ষের অ্যাপগুলি কলগুলি বাতিল করতে পারে এবং সেগুলিকে VoIP-এর মাধ্যমে পুনরায় রুট করতে পারে৷

কোটলিন

class RedirectionService : CallRedirectionService() {
    override fun onPlaceCall(
        handle: Uri,
        initialPhoneAccount: PhoneAccountHandle,
        allowInteractiveResponse: Boolean
    ) {
        // Determine if the call should proceed, be redirected, or cancelled.
        val callShouldProceed = true
        val callShouldRedirect = false
        when {
            callShouldProceed -> {
                placeCallUnmodified()
            }
            callShouldRedirect -> {
                // Update the URI to point to a different phone number or modify the
                // PhoneAccountHandle and redirect.
                redirectCall(handle, initialPhoneAccount, true)
            }
            else -> {
                cancelCall()
            }
        }
    }
}

জাভা

class RedirectionService extends CallRedirectionService {
    @Override
    public void onPlaceCall(
            @NonNull Uri handle,
            @NonNull PhoneAccountHandle initialPhoneAccount,
            boolean allowInteractiveResponse
    ) {
        // Determine if the call should proceed, be redirected, or cancelled.
        // Your app should implement this logic to determine the redirection.
        boolean callShouldProceed = true;
        boolean callShouldRedirect = false;
        if (callShouldProceed) {
            placeCallUnmodified();
        } else if (callShouldRedirect) {
            // Update the URI to point to a different phone number or modify the
            // PhoneAccountHandle and redirect.
            redirectCall(handle, initialPhoneAccount, true);
        } else {
            cancelCall();
        }
    }
}

আপনাকে অবশ্যই ম্যানিফেস্টে এই পরিষেবাটি নিবন্ধন করতে হবে যাতে সিস্টেম এটি সঠিকভাবে শুরু করতে পারে৷

<service
    android:name=".RedirectionService"
    android:permission="android.permission.BIND_CALL_REDIRECTION_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.CallRedirectionService"/>
    </intent-filter>
</service>

একটি পুনঃনির্দেশ পরিষেবা ব্যবহার করতে, আপনার অ্যাপটিকে অবশ্যই RoleManager থেকে কল পুনঃনির্দেশের ভূমিকার জন্য অনুরোধ করতে হবে৷ এটি ব্যবহারকারীকে জিজ্ঞাসা করবে যে তারা আপনার অ্যাপকে কল রিডাইরেক্ট পরিচালনা করার অনুমতি দিতে চায় কিনা। যদি আপনার অ্যাপটিকে এই ভূমিকা না দেওয়া হয়, তাহলে আপনার পুনঃনির্দেশ পরিষেবা ব্যবহার করা হবে না৷

ব্যবহারকারী আপনার অ্যাপটি চালু করার সময় আপনার অ্যাপটিতে এই ভূমিকা আছে কিনা তা আপনার পরীক্ষা করা উচিত যাতে আপনি প্রয়োজন অনুযায়ী অনুরোধ করতে পারেন। আপনি RoleManager দ্বারা তৈরি একটি উদ্দেশ্য চালু করেন, তাই ব্যবহারকারীর নির্বাচন পরিচালনা করতে আপনি onActivityResult() ফাংশনটি ওভাররাইড করেছেন তা নিশ্চিত করুন৷

কোটলিন

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Tell the system that you want your app to handle call redirects. This
        // is done by using the RoleManager to register your app to handle redirects.
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
            val roleManager = getSystemService(Context.ROLE_SERVICE) as RoleManager
            // Check if the app needs to register call redirection role.
            val shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) &&
                    !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION)
            if (shouldRequestRole) {
                val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION)
                startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE)
            }
        }
    }

    companion object {
        private const val REDIRECT_ROLE_REQUEST_CODE = 1
    }
}

জাভা

class MainActivity extends AppCompatActivity {
    private static final int REDIRECT_ROLE_REQUEST_CODE = 0;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Tell the system that you want your app to handle call redirects. This
        // is done by using the RoleManager to register your app to handle redirects.
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
            RoleManager roleManager = (RoleManager) getSystemService(Context.ROLE_SERVICE);
            // Check if the app needs to register call redirection role.
            boolean shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) &&
                    !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION);
            if (shouldRequestRole) {
                Intent intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION);
                startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE);
            }
        }
    }
}