टेलीकॉम फ़्रेमवर्क की खास जानकारी

Android Telecom फ़्रेमवर्क (इसे "Telecom" भी कहा जाता है), Android डिवाइस पर ऑडियो और वीडियो कॉल मैनेज करता है. इसमें सिम से किए जाने वाले कॉल शामिल हैं. जैसे, टेलीफ़ोनी फ़्रेमवर्क का इस्तेमाल करने वाले कॉल और वीओआईपी कॉल, जो Core-Telecom Jetpack लाइब्रेरी का इस्तेमाल करते हैं.

टेलीकॉम, मुख्य रूप से ConnectionService और InCallService को मैनेज करता है.

ConnectionService को लागू करने के लिए, पीएसटीएन जैसी टेक्नोलॉजी का इस्तेमाल किया जाता है, ताकि अन्य पक्षों को कॉल से जोड़ा जा सके. फ़ोन पर ConnectionService को लागू करने का सबसे आम तरीका, टेलीफ़ोनी ConnectionService है. यह मोबाइल और इंटरनेट सेवा देने वाली कंपनी के कॉल कनेक्ट करता है.

InCallService को लागू करने से, Telecom से मैनेज किए जाने वाले कॉल के लिए एक यूज़र इंटरफ़ेस मिलता है. साथ ही, उपयोगकर्ता को इन कॉल को कंट्रोल करने और इनसे इंटरैक्ट करने की अनुमति मिलती है. InCallService का सबसे आम उदाहरण, डिवाइस के साथ बंडल किया गया फ़ोन ऐप्लिकेशन है.

टेलीकॉम, स्विचबोर्ड की तरह काम करता है. यह ConnectionService के लागू किए गए कॉल को, InCallService के लागू किए गए कॉलिंग यूज़र इंटरफ़ेस पर रूट करता है.

आपको इन वजहों से Telecom API लागू करने पड़ सकते हैं:

फ़ोन ऐप्लिकेशन की जगह इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना

Android डिवाइस पर डिफ़ॉल्ट फ़ोन ऐप्लिकेशन की जगह कोई दूसरा ऐप्लिकेशन इस्तेमाल करने के लिए, InCallService एपीआई लागू करें. लागू करने के लिए, आपको ये ज़रूरी शर्तें पूरी करनी होंगी:

  • इसमें कॉल करने की कोई सुविधा नहीं होनी चाहिए. साथ ही, इसमें सिर्फ़ कॉल करने के लिए यूज़र इंटरफ़ेस होना चाहिए.
  • इसे उन सभी कॉल को मैनेज करना चाहिए जिनकी जानकारी टेलीकॉम फ़्रेमवर्क को है. साथ ही, कॉल के टाइप के बारे में अनुमान नहीं लगाना चाहिए. उदाहरण के लिए, यह नहीं माना जाना चाहिए कि कॉल, सिम पर आधारित टेलीफ़ोनी कॉल हैं. साथ ही, कॉल करने पर ऐसी पाबंदियां नहीं लगानी चाहिए जो किसी एक ConnectionService पर आधारित हों. जैसे, वीडियो कॉल के लिए टेलीफ़ोनी से जुड़ी पाबंदियां लागू करना.

ज़्यादा जानकारी के लिए, InCallService देखें.

कॉलिंग की सुविधा इंटिग्रेट करना

Android में कॉलिंग की सुविधा को इंटिग्रेट करने के लिए, आपके पास ये विकल्प हैं:

  • सेल्फ़-मैनेज्ड Core-Telecom Jetpack लाइब्रेरी लागू करें: यह विकल्प, स्टैंड-अलोन कॉलिंग ऐप्लिकेशन के उन डेवलपर के लिए सबसे सही है जो अपने कॉल को डिफ़ॉल्ट फ़ोन ऐप्लिकेशन में नहीं दिखाना चाहते. इसके अलावा, वे अपने यूज़र इंटरफ़ेस में अन्य कॉल भी नहीं दिखाना चाहते.

    Core-Telecom Jetpack लाइब्रेरी के साथ इंटिग्रेट करने पर, आपके ऐप्लिकेशन को डिवाइस पर सिस्टम टेलीफ़ोनी कॉलिंग के साथ-साथ, Telecom के साथ इंटिग्रेट किए गए अन्य स्टैंडअलोन कॉलिंग ऐप्लिकेशन के साथ भी इंटरऑपरेट करने में मदद मिलती है. Core-Telecom लाइब्रेरी, ऑडियो रूटिंग और फ़ोकस को भी मैनेज करती है. ज़्यादा जानकारी के लिए, कॉलिंग ऐप्लिकेशन बनाना लेख पढ़ें.

  • मैनेज किए जा रहे ConnectionService API को लागू करें: इस विकल्प की मदद से, कॉल करने की सुविधा को डेवलप किया जा सकता है. यह सुविधा, कॉल के लिए यूज़र इंटरफ़ेस उपलब्ध कराने के लिए, डिवाइस में पहले से मौजूद फ़ोन ऐप्लिकेशन पर निर्भर करती है. उदाहरण के लिए, एसआईपी कॉलिंग और वीओआईपी कॉलिंग सेवाओं को तीसरे पक्ष की मदद से लागू करना. ज़्यादा जानकारी के लिए, getDefaultDialerPackage() देखें.

    ConnectionService से सिर्फ़ कॉल कनेक्ट किए जा सकते हैं. इसका कोई यूज़र इंटरफ़ेस नहीं होता.

  • InCallService और ConnectionService API, दोनों को लागू करें: यह विकल्प तब सबसे सही होता है, जब आपको ConnectionService पर आधारित अपना कॉलिंग सलूशन बनाना हो. साथ ही, आपको अपना यूज़र इंटरफ़ेस बनाना हो और उसी यूज़र इंटरफ़ेस में अन्य सभी Android कॉल भी दिखाने हों. इस तरीके का इस्तेमाल करने पर, InCallService को लागू करने के दौरान, आपको कॉल के सोर्स के बारे में कोई अनुमान नहीं लगाना चाहिए. साथ ही, ConnectionService को लागू करने की सुविधा, डिफ़ॉल्ट फ़ोन ऐप्लिकेशन को आपके कस्टम InCallService पर सेट किए बिना भी काम करती रहनी चाहिए.

कॉल स्क्रीन करें

Android 10 (एपीआई लेवल 29) या इसके बाद के वर्शन वाले डिवाइसों पर, आपका ऐप्लिकेशन उन नंबरों से आने वाले कॉल की पहचान कर सकता है जो उपयोगकर्ता की अड्रेस बुक में नहीं हैं. ऐप्लिकेशन, इन नंबरों से आने वाले कॉल को संभावित स्पैम कॉल के तौर पर पहचान सकता है. उपयोगकर्ता, स्पैम कॉल को अपने-आप अस्वीकार होने की सुविधा चालू कर सकते हैं. उपयोगकर्ताओं को मिस्ड कॉल के बारे में ज़्यादा जानकारी देने के लिए, ब्लॉक किए गए इन कॉल की जानकारी को कॉल लॉग में सेव किया जाता है. Android 10 API का इस्तेमाल करने पर, कॉल स्क्रीनिंग और कॉलर आईडी की सुविधा देने के लिए, उपयोगकर्ता से 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.
                }
            }
        }
    }
}

onScreenCall() फ़ंक्शन को respondToCall() को कॉल करने के लिए सेट करें, ताकि सिस्टम को पता चल सके कि नए कॉल का जवाब कैसे देना है. यह फ़ंक्शन, 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)

आपको मेनिफ़ेस्ट फ़ाइल में, CallScreeningService को सही इंटेंट फ़िल्टर और अनुमति के साथ रजिस्टर करना होगा, ताकि सिस्टम इसे सही तरीके से ट्रिगर कर सके.

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

कॉल को रीडायरेक्ट करना

Android 10 या इसके बाद के वर्शन वाले डिवाइसों में, कॉल इंटेंट को मैनेज करने का तरीका Android 9 या इससे पहले के वर्शन वाले डिवाइसों से अलग होता है. Android 10 और इसके बाद के वर्शन पर, ACTION_NEW_OUTGOING_CALL ब्रॉडकास्ट को बंद कर दिया गया है. इसकी जगह, CallRedirectionService एपीआई का इस्तेमाल किया जाता है. CallRedirectionService आपको ऐसे इंटरफ़ेस उपलब्ध कराता है जिनका इस्तेमाल करके, Android प्लैटफ़ॉर्म से किए जाने वाले आउटगोइंग कॉल में बदलाव किया जा सकता है. उदाहरण के लिए, तीसरे पक्ष के ऐप्लिकेशन, कॉल रद्द कर सकते हैं और उन्हें वीओआईपी पर रीडायरेक्ट कर सकते हैं.

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()
            }
        }
    }
}

आपको इस सेवा को मेनिफ़ेस्ट में रजिस्टर करना होगा, ताकि सिस्टम इसे सही तरीके से शुरू कर सके.

<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 : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

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