Telekomünikasyon çerçevesine genel bakış

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

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

ConnectionService uygulaması, PSTN gibi teknolojileri kullanarak aramaları diğer taraflara bağlar. Telefonlarda en yaygın ConnectionService uygulaması telefon ConnectionService'dir. Operatör aramalarını bağlar.

InCallService uygulaması, Telecom 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'ün en yaygın uygulaması, cihazla birlikte sunulan telefon uygulamasıdır.

Telekomünikasyon, bir telefon santrali gibi çalışır. ConnectionServiceuygulamaları tarafından sağlanan aramaları, InCallServiceuygulamaları tarafından sağlanan arayan kullanıcı arayüzlerine yönlendirir.

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

Değişim amaçlı telefon uygulaması oluşturma

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

  • Arama özelliğine sahip 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şlemelidir ve aramaların niteliği hakkında varsayımlarda bulunmamalıdır. Örneğin, aramaların SIM tabanlı telefon aramaları olduğunu varsayamaz veya video aramaları için telefon kısıtlamalarının uygulanması gibi herhangi bir ConnectionService'ye dayalı arama kısıtlamaları uygulayamaz.

Daha fazla bilgi için InCallService başlıklı makaleyi inceleyin.

Arama çözümü entegrasyonu

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

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

    Core-Telecom Jetpack kitaplığıyla entegrasyon yaptığınızda uygulamanızın yalnızca cihazdaki sistem telefon görüşmesi ile değil, Telecom ile entegre olan diğer bağımsız görüşme uygulamalarıyla da birlikte çalışabilmesini sağlarsınız. Core-Telecom kitaplığı, ses yönlendirme ve odağı da yönetir. Ayrıntılar için Arama uygulaması oluşturma başlıklı makaleyi inceleyin.

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

    ConnectionService yalnızca aramaları bağlama aracı sağlar. İlişkili bir kullanıcı arayüzü yoktur.

  • Hem InCallService hem de ConnectionService API'sini uygulama: Kendi kullanıcı arayüzüne sahip 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 bu seçenek 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 ayarınıza 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 bulunmayan numaralardan gelen aramaları olası spam aramalar olarak tanımlamasına olanak tanır. Kullanıcılar, spam aramaların sessizce reddedilmesini seçebilir. Kullanıcılar cevaplamadıkları aramalar hakkında daha fazla bilgi edinebilmek için engellenen aramalarla ilgili bilgiler arama günlüğüne kaydedilir. Android 10 API'yi kullanmak, arama filtreleme ve arayan kimliği işlevini sağlamak için kullanıcıdan READ_CALL_LOG izni alınması zorunluluğunu 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. Daha açık belirtmek gerekirse getCallerNumberVerificationStatus() işlevi, ağ sağlayıcıdan diğer numarayla ilgili bilgileri içerir. Doğrulama durumu başarısız olduysa aramanın geçersiz bir numaradan veya spam olabilecek bir numaradan geldiğinin iyi bir göstergesidir.

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

Sisteme yeni aramaya nasıl yanıt vereceğini bildirmek için onScreenCall() işlevini respondToCall() çağıracak şekilde ayarlayın. Bu işlev, sisteme aramayı engellemesini, kullanıcıymış gibi reddetmesini veya sessize almasını söylemek için kullanabileceğiniz bir CallResponse parametresi alır. Ayrıca, sistemi bu aramayı cihazın arama günlüğüne eklememeyi de seçebilirsiniz.

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

Sistemin CallScreeningService uygulamasını doğru şekilde tetikleyebilmesi için manifest dosyasında 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 isteklerini 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ı desteği sonlandırıldı ve CallRedirectionService API ile değiştirildi. 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 edebilir ve VoIP üzerinden yeniden yönlendirebilir.

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

Sistemin bu hizmeti doğru şekilde başlatabilmesi için manifest dosyasına 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ıdan uygulamanızın arama yönlendirmelerini yönetmesine 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ü isteyebilirsiniz. RoleManager tarafından oluşturulan bir intent'i başlatırsınız. Bu nedenle, kullanıcının seçimini işlemek için onActivityResult() işlevini geçersiz kıldığınızdan emin olun.

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