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

Android Telecom फ़्रेमवर्क, ऑडियो और विज्ञापनों को मैनेज करता है. इसे "Telecom" भी कहा जाता है वीडियो कॉल करने की सुविधा मिलती है. इसमें सिम से किए जाने वाले कॉल शामिल हैं, जैसे कॉल जो टेलिफ़ोनी फ़्रेमवर्क का इस्तेमाल करते हैं और VoIP कॉल ConnectionService एपीआई.

टेलीकॉम मुख्य कॉम्पोनेंट में ConnectionService और InCallService.

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

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

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

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

इसकी जगह, कोई दूसरा फ़ोन ऐप्लिकेशन बनाएं

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

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

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

कॉल के लिए इस्तेमाल किया जाने वाला समाधान इंटिग्रेट करें

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

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

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

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

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

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

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

Android 10 (एपीआई लेवल 29) या इसके बाद के वर्शन पर चलने वाले डिवाइस में, आपका ऐप्लिकेशन ऐसे कॉल जो संभावित स्पैम के तौर पर उपयोगकर्ता की पता बुक में नहीं हैं कॉल. उपयोगकर्ता चाहें, तो स्पैम कॉल के अनुरोध को बिना किसी आवाज़ के अस्वीकार कर सकते हैं. बेहतर इनपुट देने के लिए उपयोगकर्ताओं से किसी कॉल के छूट जाने पर, उन्हें दी गई जानकारी. साथ ही, ब्लॉक की गई इन चीज़ों की जानकारी कॉल, कॉल लॉग में लॉग किए जाते हैं. Android 10 API का इस्तेमाल करने से, शर्त को पूरा करने की शर्त READ_CALL_LOG कॉल की स्क्रीनिंग और कॉलर आईडी की सुविधा देने के लिए उपयोगकर्ता से अनुमति सुविधा पर काम करता है.

आप CallScreeningService कॉल स्क्रीन करने के लिए लागू किया जा सकता है. कॉल करें onScreenCall() किसी भी नई इनकमिंग या आउटगोइंग कॉल के लिए फ़ंक्शन किया जा सकता है, जब उपयोगकर्ता की संपर्क सूची. आप Call.Details जानकारी के लिए ऑब्जेक्ट कॉल के बारे में है. खास तौर पर, getCallerNumberVerificationStatus() फ़ंक्शन में अन्य नंबर के बारे में नेटवर्क कंपनी की जानकारी शामिल होती है. अगर सत्यापन स्थिति विफल हो जाती है, तो यह एक अच्छा संकेत है कि कॉल किसी अमान्य नंबर या संभावित स्पैम कॉल से आया हो.

Kotlin

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

Java

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

कॉल करने के लिए, onScreenCall() फ़ंक्शन को सेट करें respondToCall() का इस्तेमाल करें. यह फ़ंक्शन किसी CallResponse एक पैरामीटर होना चाहिए, जिसका उपयोग करके आप सिस्टम को कॉल ब्लॉक करने का निर्देश दे सकें, तो उसे इस तरह अस्वीकार कर दें इस्तेमाल करने वाले व्यक्ति ने किया है या उसे चुप कर दिया गया है. सिस्टम को यह जानकारी न जोड़ने का निर्देश भी दिया जा सकता है कॉल को डिवाइस के कॉल लॉग पर ही कर सकता है.

Kotlin

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

Java

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

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

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

Kotlin

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

Java

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() का इस्तेमाल करता है.

Kotlin

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

Java

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