Telekomünikasyon çerçevesine genel bakış

Android Telecom yapısı ("Telecom" olarak da bilinir), ses içeriklerini ve Android destekli bir cihazda görüntülü görüşmeler yapabilirsiniz. Buna, şunlar gibi SIM tabanlı aramalar da dahildir: telefon aramaları telefon çerçevesini kullanan VoIP çağrıları ve ConnectionService API.

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

ConnectionService uygulaması, bağlantı kurmak için VoIP gibi teknolojiler kullanır. çağrışımlar yapabilir. Bir web sitesinde en sık ConnectionService telefon, ConnectionService telefon. Operatör aramalarını bağlar.

InCallService uygulaması, Telekomünikasyon, kullanıcının bu aramaları kontrol etmesine ve bunlarla etkileşime geçmesine olanak tanır. En InCallService genel uygulaması, cihaz.

Telekom, bir santral görevi görür. ConnectionService numaralı aramaları yönlendirir uygulamaları, çağrı kullanıcı arayüzlerine InCallService pek çok fayda sağlar.

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

Yeni telefon uygulaması oluşturma

Bir Android cihazdaki varsayılan telefon uygulamasının yerine yenisini oluşturmak için InCallService API'yi uygulayabilirsiniz. Uygulamanız aşağıdaki şartları karşılamalıdır koşullar:

  • Arama özelliği bulunmamalı ve yalnızca kullanıcıdan oluşmalıdır. arama arayüzü.
  • Telekomünikasyon çerçevesinin farkında olduğu tüm çağrıları ele almalı ve telefon görüşmelerinin mahiyetiyle ilgili varsayımlar da bulunmaktadır. Örneğin, çağrılarının SIM tabanlı telefon aramaları olduğunu veya telefon işlevlerinin uygulanması gibi herhangi bir ConnectionService'a dayalı olarak kısıtlamalara tabi.

Daha fazla bilgi için bkz. InCallService.

Arama çözümü entegre edin

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

  • Kendi kendine yönetilen ConnectionService API'yi uygulayın: Bu seçenek, telefon etmek istemeyen bağımsız arama uygulamalarının geliştiricileri için idealdir. çağrılarını varsayılan telefon uygulamasında gösterme veya diğer aramaları gösterme API'leri kullanabilirsiniz.

    Kullanıcı tarafından yönetilen bir ConnectionService kullandığınızda, uygulamanızın şu işlemleri yapmasına yardımcı olursunuz: Yalnızca cihazdaki yerel telefon aramasıyla değil, aynı zamanda özelliğini kullanın. Kendi kendine yönetilen ConnectionService API, ses yönlendirmesini ve odağı da yönetir. Ayrıntılar için bkz. Telefon araması uygulaması oluşturun.

  • Managed ConnectionService API'yi uygulayın: Bu seçenek, mevcut cihaz telefonu uygulamasını kullanarak aramalar için kullanıcı arayüzü sağlar. Buna örnek olarak SIP araması ve VoIP aramasının üçüncü taraflarca uygulanması verilebilir. kullanıma sunuyoruz. Daha fazla bilgi için bkz. getDefaultDialerPackage().

    Tek başına ConnectionService, çağrıları bağlamak için yalnızca bir yöntem sunar. Google ilişkilendirilmiş bir kullanıcı arayüzü yoktur.

  • Hem InCallService hem de ConnectionService API'yi uygulayın: Kendiniz bir özel rapor oluşturmak istiyorsanız ConnectionService tabanlı arama çözümü, kendi kullanıcısıyla tamamlanmış tüm diğer Android çağrılarını da aynı kullanıcı arayüzünde gösterebilirsiniz. Bu yaklaşımı kullandığınızda, InCallService telefon aramalarının kaynakları hakkında varsayımlarda bulunabilir. Ayrıca, ConnectionService uygulaması, varsayılan telefon uygulamanız özel InCallService olarak ayarlandı.

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 ve potansiyel spam olarak gelen aramalar çağrısının en iyi yolu. Kullanıcılar, spam çağrıların sessizce reddedilmesini tercih edebilir. Daha fazla aramaları cevaplamayan kullanıcılara şeffaflık, engellenenlerle ilgili bilgiler çağrıları, çağrı kaydına kaydedilir. Android 10 API'yi kullanmak proje gerekliliklerinin karşılanmasını READ_CALL_LOG arama filtreleme ve arayan kimliği sağlamak için kullanıcıdan izin alınması işlevi görür.

Google'da CallScreeningService filtrelemeye yönelik bir uygulamadır. Şunu çağırın: onScreenCall() yeni gelen veya giden aramalar için işlev gösterebilir. Kullanıcının kişi listesi. Web sitemiz g.co/newsinitiative/labs üzerinden Call.Details bilgi nesnesi hakkında bilgi edindiniz. Daha ayrıntılı belirtmek gerekirse, getCallerNumberVerificationStatus() işlevinde, ağ sağlayıcısından diğer numarayla ilgili bilgiler yer alır. Doğrulama durumunun başarısız olması, aramanın kötü amaçlı gelen bir aramadır.

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() işlevini respondToCall() yeni çağrıya nasıl yanıt vereceğini sisteme bildirin. Bu işlev, CallResponse Sisteme çağrıyı engellemesini söylemek için kullanabileceğiniz parametredir. veya sesi susturulabilir. Ayrıca, sisteme bu metni eklemeyi atlamasını söyleyebilirsiniz. çağrı kaydına tamamen çağrı gönderebilir.

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 uygulamasını manifest dosyasına kaydetmelisiniz uygun intent filtresine ve izne sahip olmalıdır. Böylece, inceleyeceğiz.

<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 cihazlar. Android 10 ve sonraki sürümlerde ACTION_NEW_OUTGOING_CALL yayının desteği sonlandırıldı ve yayının yerine CallRedirectionService API'ye gidin. CallRedirectionService, projeniz için kullanabileceğiniz arayüzler sunar. Android platformu tarafından yapılan giden aramaları değiştirme. Örneğin, üçüncü taraf 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 başlatabilmesi için bu hizmeti manifest dosyasına kaydetmeniz gerekir sağlayabilir.

<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 arama yönlendirme rolü isteğinde bulunması gerekir RoleManager. Bu işlemle kullanıcının, uygulamanızın çağrı yönlendirmelerini işlemesine izin vermek isteyip istemediğini kontrol edin. Uygulamanız bu rol verilmediğinde yönlendirme hizmetiniz kullanılmaz.

Kullanıcı uygulamanızı başlattığında uygulamanızın bu role sahip olup olmadığını kontrol etmeniz gerekir. gerektiğinde talep edebilirsiniz. RoleManager tarafından oluşturulan bir niyeti başlatırsanız Bu nedenle, kalite standartlarını onActivityResult() işlevini kullanın.

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