Telekomünikasyon çerçevesine genel bakış

Android Telecom çerçevesi (kısaca "Telecom" olarak da bilinir), Android destekli bir cihazda sesli ve görüntülü görüşmeleri yönetir. Telefon çerçevesini kullanan aramalar gibi SIM tabanlı aramalar ve Core-Telecom Jetpack kitaplığını uygulayan VoIP aramaları buna dahildir.

Telekom'un yönettiği başlıca bileşenler ConnectionService ve InCallService'dir.

ConnectionService uygulaması, aramaları diğer taraflara bağlamak için PSTN gibi teknolojileri temel alır. Telefonda en yaygın ConnectionService uygulaması, telefon ConnectionService'dir. Operatör aramalarını bağlar.

InCallService uygulaması, Telekom tarafından yönetilen aramalar için bir kullanıcı arayüzü sağlar ve kullanıcının bu aramaları kontrol etmesine ve aramalarla etkileşim kurmasına olanak tanır. InCallService'nin en yaygın uygulaması, cihazla birlikte gelen telefon uygulamasıdır.

Telekomünikasyon, santral görevi görür. ConnectionService uygulamalarının sağladığı aramaları, InCallService uygulamalarının sağladığı arama kullanıcı arayüzlerine yönlendirir.

Telecom API'lerini aşağıdaki nedenlerle uygulamak isteyebilirsiniz:

Alternatif telefon uygulaması oluşturma

Android cihazlarda varsayılan telefon uygulamasının yerine geçecek bir uygulama oluşturmak için InCallService API'sini uygulayın. Uygulamanız aşağıdaki şartları karşılamalıdır:

  • Arama özelliği olmamalı ve yalnızca arama için kullanıcı arayüzünden oluşmalıdır.
  • Telekom çerçevesinin bildiği tüm aramaları işlemeli ve aramaların niteliği hakkında varsayımlarda bulunmamalıdır. Örneğin, aramaların SIM tabanlı telefon aramaları olduğunu varsaymamalı veya görüntülü görüşmeler için telefon kısıtlamalarının uygulanması gibi herhangi bir ConnectionService'e dayalı arama kısıtlamaları uygulamamalıdır.

Daha fazla bilgi için InCallService konusuna bakın.

Arama çözümü entegre etme

Arama çözümünüzü Android'e entegre etmek için aşağıdaki seçenekleri kullanabilirsiniz:

  • Kendi kendini yöneten Core-Telecom Jetpack kitaplığını uygulama: Bu seçenek, aramalarını varsayılan telefon uygulamasında göstermek istemeyen ve kullanıcı arayüzünde başka aramaların gösterilmesini istemeyen bağımsız telefon uygulamalarının geliştiricileri için idealdir.

    Core-Telecom Jetpack kitaplığıyla entegrasyon yaptığınızda uygulamanızın yalnızca cihazdaki sistem telefon aramalarıyla değil, Telecom ile entegre olan diğer bağımsız arama uygulamalarıyla da birlikte çalışmasına yardımcı olursunuz. Core-Telecom kitaplığı, ses yönlendirmeyi ve odağı da yönetir. Ayrıntılar için Arama uygulaması geliştirme başlıklı makaleyi inceleyin.

  • Yönetilen ConnectionService API'yi uygulama: Bu seçenek, aramalar için kullanıcı arayüzü sağlamak üzere mevcut cihaz telefon uygulamasını kullanan bir arama çözümü geliştirilmesini kolaylaştırır. SIP araması ve VoIP araması hizmetlerinin üçüncü taraf uygulamaları buna örnek olarak verilebilir. Daha fazla bilgi için getDefaultDialerPackage() başlıklı makaleyi inceleyin.

    Tek başına ConnectionService, yalnızca aramaları bağlama imkanı sunar. İlişkili bir kullanıcı arayüzü yoktur.

  • Hem InCallService hem de ConnectionService API'yi uygulayın: Bu seçenek, kendi kullanıcı arayüzüne sahip kendi ConnectionService tabanlı arama çözümünüzü oluşturmak ve diğer tüm Android aramalarını aynı kullanıcı arayüzünde göstermek istiyorsanız idealdir. Bu yaklaşımı kullandığınızda InCallService uygulamanız, gösterdiği aramaların kaynakları hakkında herhangi bir varsayımda bulunmamalıdır. Ayrıca, ConnectionService uygulamanız, varsayılan telefon uygulaması özel InCallService olarak ayarlanmadan çalışmaya devam etmelidir.

Sesli aramaları süz

Android 10 (API düzeyi 29) veya sonraki sürümleri çalıştıran cihazlar, uygulamanızın kullanıcının adres defterinde olmayan numaralardan gelen aramaları potansiyel spam aramalar olarak tanımlamasına olanak tanır. Kullanıcılar, spam aramaların sessizce reddedilmesini seçebilir. Kullanıcıların cevapsız aramalar konusunda daha şeffaf bir deneyim yaşaması için bu engellenen aramalarla ilgili bilgiler arama kaydına kaydedilir. Android 10 API'nin kullanılması, arama filtreleme ve arayan kimliği işlevini sağlamak için kullanıcıdan READ_CALL_LOG izni alma şartını ortadan kaldırır.

Aramaları filtrelemek için CallScreeningService uygulamasını kullanıyorsunuz. Numara, kullanıcının kişi listesinde olmadığında yeni gelen veya giden aramalar için onScreenCall() işlevini çağırın. Aramayla ilgili bilgi için Call.Details nesnesini kontrol edebilirsiniz. Özellikle, getCallerNumberVerificationStatus() işlevi, ağ sağlayıcıdan diğer numarayla ilgili bilgileri içerir. Doğrulama durumu başarısızsa bu, aramanın geçersiz bir numaradan yapıldığını veya spam çağrı olabileceğini gösterir.

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

Sisteme yeni aramaya nasıl yanıt vereceğini bildirmek için onScreenCall() işlevini respondToCall() çağrısına ayarlayın. Bu işlev, sisteme aramayı engellemesini, kullanıcı reddetmiş gibi reddetmesini veya sessize almasını söylemek için kullanabileceğiniz bir CallResponse parametresi alır. Sisteme bu aramayı cihazın arama kaydına eklemeyi tamamen atlamasını da söyleyebilirsiniz.

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

Sistemin doğru şekilde tetikleyebilmesi için manifest dosyasında CallScreeningService uygulamasını uygun intent filtresi ve izinle kaydetmeniz gerekir.

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

Aramayı yönlendirme

Android 10 veya sonraki sürümleri çalıştıran cihazlar, arama amaçlarını Android 9 veya önceki sürümleri çalıştıran cihazlardan farklı şekilde yönetir. Android 10 ve sonraki sürümlerde ACTION_NEW_OUTGOING_CALL yayını kullanımdan kaldırılmış ve yerine CallRedirectionService API'si getirilmiştir. CallRedirectionService, Android platformu tarafından yapılan giden aramaları değiştirmek için kullanabileceğiniz arayüzler sağlar. Örneğin, üçüncü taraf uygulamaları aramaları iptal edip VoIP üzerinden yeniden yönlendirebilir.

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

Sistemin bu hizmeti doğru şekilde başlatabilmesi için hizmeti manifest dosyasında kaydetmeniz gerekir.

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

Yönlendirme hizmetini kullanmak için uygulamanızın RoleManager'dan arama yönlendirme rolünü istemesi gerekir. Bu işlem, kullanıcıya uygulamanızın arama yönlendirmelerini işlemesine izin vermek isteyip istemediğini sorar. Uygulamanıza bu rol verilmezse yönlendirme hizmetiniz kullanılmaz.

Kullanıcı uygulamanızı başlattığında uygulamanızın bu role sahip olup olmadığını kontrol etmeniz gerekir. Böylece, gerektiğinde bu rolü talep edebilirsiniz. RoleManager tarafından oluşturulan bir intent'i başlatıyorsunuz. Bu nedenle, kullanıcının seçimini işlemek için onActivityResult() işlevini geçersiz kıldığınızdan emin olun.

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