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:
- Sistem telefonu uygulamasının yerine bir uygulama oluşturmak.
- Android arama deneyimine bir arama çözümü entegre etmek için.
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önetilenConnectionService
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ızdaInCallService
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ı özelInCallService
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); } } } }