Telekomünikasyon çerçevesine genel bakış

Android Telecom çerçevesi ("Telekom" olarak da bilinir) Android destekli cihazlarda sesli ve görüntülü görüşmeleri yönetir. Buna, telefon çerçevesini kullanan çağrılar gibi SIM tabanlı çağrılar ve ConnectionService API'yi uygulayan VoIP çağrıları da dahildir.

Telecom'un yönettiği temel bileşenler, ConnectionService ve InCallService'tir.

ConnectionService uygulamasında, aramaları diğer taraflara bağlamak için VoIP gibi teknolojiler kullanılır. Telefonlarda en yaygın ConnectionService uygulaması, telefon (ConnectionService) uygulamasıdır. Operatör aramalarını bağlar.

InCallService uygulaması, Telekom tarafından yönetilen çağrılar için bir kullanıcı arayüzü sağlar ve kullanıcının bu aramaları kontrol etmesine ve bunlarla etkileşimde bulunmasına olanak tanır. En yaygın InCallService uygulaması, bir cihazla birlikte verilen telefon uygulamasıdır.

Telekom bir santral görevi görür. ConnectionService uygulamalarının sağladığı çağrıları, InCallService uygulamalarının sağladığı çağrı kullanıcı arayüzlerine yönlendirir.

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

Yeni telefon uygulaması oluşturma

Bir Android cihazda varsayılan telefon uygulamasının yerine yeni bir uygulama oluşturmak için InCallService API'yi uygulayın. Uygulamanız aşağıdaki gereksinimleri karşılamalıdır:

  • Arama özelliği bulunmamalı ve yalnızca arama için kullanılan kullanıcı arayüzünden oluşmalıdır.
  • Telekomünikasyon çerçevesinin farkında olduğu tüm çağrıları ele almalı ve çağrıların yapısı hakkında varsayımda bulunmamalıdır. Örneğin, aramaların SIM tabanlı telefon aramaları olduğu varsaymamalı veya görüntülü görüşmeler için telefon kısıtlamalarının uygulanması gibi herhangi bir ConnectionService tabanlı arama kısıtlamaları uygulamamalıdır.

Daha fazla bilgi için InCallService bölümünü inceleyin.

Arama çözümünü entegre etme

Arama çözümünüzü Android'e entegre etmek için şu seçenekleri kullanabilirsiniz:

  • Kendi kendine yönetilen ConnectionService API'yi uygulama: Bu seçenek, çağrılarını varsayılan telefon uygulamasında göstermek veya kullanıcı arayüzlerinde başka çağrılar göstermek istemeyen bağımsız çağrı uygulamalarının geliştiricileri için idealdir.

    Otomatik yönetilen ConnectionService kullandığınızda, uygulamanızın yalnızca cihazdaki yerel telefon çağrısıyla değil, aynı zamanda bu API'yi uygulayan diğer bağımsız çağrı uygulamalarıyla birlikte çalışmasına yardımcı olursunuz. Otomatik yönetilen ConnectionService API, ses yönlendirme ve odaklamayı da yönetir. Ayrıntılı bilgi için Telefon etme uygulaması oluşturma başlıklı makaleye bakın.

  • Managed ConnectionService API'yi uygulama: Bu seçenek, çağrılar için kullanıcı arayüzünü sağlamak üzere mevcut cihaz telefon uygulamasını kullanan bir çağrı çözümü geliştirmeyi kolaylaştırır. Örnekler arasında SIP araması ve VoIP arama hizmetlerinin üçüncü taraflarca uygulanması yer alır. Daha fazla bilgi için getDefaultDialerPackage() bölümünü inceleyin.

    ConnectionService tek başına yalnızca aramaları bağlama yöntemini sağlar. İlişkilendirilmiş bir kullanıcı arayüzü yoktur.

  • Hem InCallService hem de ConnectionService API'yi uygulayın: Kendi kullanıcı arayüzüyle eksiksiz, ConnectionService tabanlı kendi çağrı çözümünüzü oluşturmak ve diğer tüm Android çağrılarını aynı kullanıcı arayüzünde göstermek istiyorsanız bu seçenek idealdir. Bu yaklaşımı kullandığınızda InCallService uygulamanızda, görüntülediği çağrıların kaynakları hakkında herhangi bir varsayımda bulunmamalıdır. Ayrıca, ConnectionService uygulamanız, varsayılan telefon uygulaması özel InCallService olarak ayarlanmadıkça ç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ı olası spam aramalar olarak tanımlamasına izin verir. Kullanıcılar spam aramaların sessizce reddedilmesini seçebilir. Kullanıcılara cevapsız arama geldiğinde daha fazla şeffaflık sağlamak için bu engellenen aramalarla ilgili bilgiler çağrı kaydına kaydedilir. Android 10 API kullanıldığında, arama filtreleme ve arayan kimliği işlevi sağlamak için kullanıcıdan READ_CALL_LOG izni alma zorunluluğu ortadan kalkar.

Aramaları filtrelemek için bir CallScreeningService uygulaması kullanıyorsunuz. Numara kullanıcının kişi listesinde yoksa yeni gelen veya giden aramalar için onScreenCall() işlevini çağırın. Çağrı hakkında bilgi için Call.Details nesnesini kontrol edebilirsiniz. Daha açık belirtecek olursak getCallerNumberVerificationStatus() işlevi, ağ sağlayıcısının diğer numarayla ilgili bilgilerini içerir. Doğrulama durumu başarısız olduysa bu durum aramanın geçersiz bir numaradan veya spam olabilecek bir aramadan 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 çağrıya nasıl yanıt vereceğini bildirmek için onScreenCall() işlevini respondToCall() çağıracak şekilde ayarlayın. Bu işlev, sisteme çağrıyı engellemesini, kullanıcı yapmış gibi reddetmesini veya sessize almasını söylemek için kullanabileceğiniz bir CallResponse parametresi alır. Ayrıca sisteme, bu çağrıyı cihazın çağrı kaydına hiç eklememesini de söyleyebilirsiniz.

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 doğru şekilde tetikleyebilmesi için CallScreeningService uygulamasını, uygun intent filtresiyle ve izinle manifest dosyasına 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, çağrı 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ıldı ve yerini CallRedirectionService API'si aldı. CallRedirectionService, Android platformu tarafından yapılan giden çağrıları değiştirmek için kullanabileceğiniz arayüzler sağlar. Örneğin, üçüncü taraf uygulamaları aramaları iptal edip 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 doğru şekilde başlatabilmesi için bu hizmeti 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>

Bir yönlendirme hizmeti kullanmak için uygulamanızın RoleManager'dan arama yönlendirme rolü istemesi gerekir. Bu şekilde kullanıcıya, uygulamanızın çağrı yönlendirmelerini işlemesine izin vermek isteyip istemediği sorulur. Uygulamanıza bu rol verilmemişse yönlendirme hizmetiniz kullanılmaz.

Kullanıcı uygulamanızı başlattığında uygulamanızın bu role sahip olup olmadığını kontrol etmelisiniz. Böylece istediğiniz zaman istekte bulunabilirsiniz. RoleManager tarafından oluşturulan bir amacı 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);
            }
        }
    }
}