مروری بر چارچوب مخابراتی

چارچوب Android Telecom (که به سادگی به عنوان "Telecom" نیز شناخته می شود) تماس های صوتی و تصویری را در یک دستگاه مجهز به Android مدیریت می کند. این شامل تماس‌های مبتنی بر سیم‌کارت، مانند تماس‌هایی که از چارچوب تلفنی استفاده می‌کنند، و تماس‌های VoIP که ConnectionService API را اجرا می‌کنند، می‌شود.

اجزای اصلی که Telecom مدیریت می کند ConnectionService و InCallService هستند.

اجرای ConnectionService از فناوری هایی مانند VoIP برای اتصال تماس ها به طرف های دیگر استفاده می کند. رایج ترین اجرای ConnectionService در تلفن، ConnectionService تلفنی است. تماس های اپراتور را متصل می کند.

یک پیاده سازی InCallService یک رابط کاربری برای تماس های مدیریت شده توسط Telecom فراهم می کند و به کاربر امکان کنترل و تعامل با این تماس ها را می دهد. رایج ترین اجرای InCallService برنامه تلفن همراه با یک دستگاه است.

مخابرات به عنوان تابلو برق عمل می کند. تماس‌هایی را که پیاده‌سازی‌های ConnectionService ارائه می‌کنند به رابط‌های کاربر فراخوانی که پیاده‌سازی‌های InCallService ارائه می‌دهند، هدایت می‌کند.

ممکن است به دلایل زیر بخواهید API های Telecom را پیاده سازی کنید:

یک برنامه تلفن جایگزین ایجاد کنید

برای ایجاد جایگزینی برای برنامه پیش‌فرض تلفن در دستگاه Android، InCallService API را پیاده‌سازی کنید. پیاده سازی شما باید شرایط زیر را برآورده کند:

  • نباید قابلیت تماس داشته باشد و باید فقط از رابط کاربری برای تماس تشکیل شده باشد.
  • باید تمام تماس‌هایی را که چارچوب مخابراتی از آن‌ها مطلع است رسیدگی کند و در مورد ماهیت تماس‌ها فرضیاتی ایجاد نکند. به عنوان مثال، نباید تماس‌ها را تماس‌های تلفنی مبتنی بر سیم‌کارت فرض کند، یا محدودیت‌های تماسی را که مبتنی بر یک ConnectionService است، اجرا نکند، مانند اعمال محدودیت‌های تلفنی برای تماس‌های ویدیویی.

برای اطلاعات بیشتر، InCallService را ببینید.

راه حل فراخوانی را ادغام کنید

برای ادغام راه حل تماس خود در اندروید، گزینه های زیر را دارید:

  • پیاده‌سازی ConnectionService API خود مدیریت: این گزینه برای توسعه دهندگان برنامه‌های تماس مستقل که نمی‌خواهند تماس‌های خود را در برنامه تلفن پیش‌فرض نشان دهند، و همچنین تماس‌های دیگری در رابط کاربری‌شان نشان داده نمی‌شود، ایده‌آل است.

    وقتی از ConnectionService خود مدیریتی استفاده می کنید، به برنامه خود کمک می کنید تا نه تنها با تماس تلفنی بومی در دستگاه، بلکه با سایر برنامه های تماس مستقلی که این API را پیاده سازی می کنند، همکاری کند. رابط کاربری خود مدیریت ConnectionService همچنین مسیریابی و فوکوس صدا را مدیریت می کند. برای جزئیات، به ساخت برنامه تماس مراجعه کنید.

  • اجرای رابط برنامه کاربردی ConnectionService مدیریت شده: این گزینه توسعه یک راه حل تماس را تسهیل می کند که به برنامه تلفن دستگاه موجود برای ارائه رابط کاربری برای تماس ها متکی است. به عنوان مثال می توان به اجرای شخص ثالث تماس SIP و خدمات تماس VoIP اشاره کرد. برای جزئیات بیشتر، getDefaultDialerPackage() را ببینید.

    یک ConnectionService به تنهایی تنها ابزار اتصال تماس ها را فراهم می کند. هیچ رابط کاربری مرتبطی ندارد.

  • InCallService و ConnectionService API را پیاده سازی کنید: اگر می خواهید راه حل تماس مبتنی بر ConnectionService خود را ایجاد کنید، با رابط کاربری خودش کامل شود و همچنین همه تماس های اندرویدی دیگر را در همان رابط کاربری نشان دهد، این گزینه ایده آل است. هنگامی که از این رویکرد استفاده می کنید، پیاده سازی InCallService شما نباید هیچ فرضی در مورد منابع تماس هایی که نمایش می دهد داشته باشد. همچنین، اجرای ConnectionService شما باید بدون برنامه پیش‌فرض تلفن روی InCallService سفارشی شما به کار خود ادامه دهد.

تماس های صفحه نمایش

دستگاه‌هایی که Android 10 (سطح API 29) یا بالاتر را اجرا می‌کنند به برنامه شما امکان می‌دهند تماس‌ها را از شماره‌هایی که در دفترچه آدرس کاربر نیستند به‌عنوان تماس‌های هرزنامه احتمالی شناسایی کند. کاربران می توانند انتخاب کنند که تماس های هرزنامه بی سر و صدا رد شود. برای ارائه شفافیت بیشتر به کاربران در هنگام از دست دادن تماس، اطلاعات مربوط به این تماس های مسدود شده در گزارش تماس ثبت می شود. استفاده از Android 10 API الزام به دریافت مجوز READ_CALL_LOG را از کاربر به منظور ارائه قابلیت غربالگری تماس و شناسه تماس گیرنده حذف می کند.

شما از اجرای CallScreeningService برای نمایش تماس ها استفاده می کنید. وقتی شماره در لیست مخاطبین کاربر نیست، تابع onScreenCall() را برای هر تماس ورودی یا خروجی جدید فراخوانی کنید. می توانید شی Call.Details را برای اطلاعات در مورد تماس بررسی کنید. به طور خاص، تابع getCallerNumberVerificationStatus() شامل اطلاعاتی از ارائه‌دهنده شبکه در مورد شماره دیگر است. اگر وضعیت تأیید ناموفق بود، این نشانه خوبی است که تماس از یک شماره نامعتبر یا تماس بالقوه هرزنامه است.

کاتلین

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

جاوا

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() را برای فراخوانی respondToCall() تنظیم کنید تا به سیستم بگویید چگونه به تماس جدید پاسخ دهد. این تابع یک پارامتر CallResponse می گیرد که می توانید با استفاده از آن به سیستم بگویید تماس را مسدود کند، آن را رد کند، انگار که کاربر انجام داده است، یا آن را خاموش کند. همچنین می‌توانید به سیستم بگویید از افزودن این تماس به گزارش تماس‌های دستگاه به‌کلی رد شود.

کاتلین

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

جاوا

// 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 را در فایل مانیفست با فیلتر و مجوز مناسب ثبت کنید تا سیستم بتواند آن را به درستی راه اندازی کند.

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

تغییر مسیر یک تماس

دستگاه‌هایی که Android 10 یا بالاتر دارند، هدف تماس را متفاوت از دستگاه‌هایی که Android 9 یا پایین‌تر دارند، مدیریت می‌کنند. در Android 10 و بالاتر، پخش ACTION_NEW_OUTGOING_CALL منسوخ شده و با CallRedirectionService API جایگزین شده است. CallRedirectionService رابط‌هایی را برای شما فراهم می‌کند تا از آن‌ها برای تغییر تماس‌های خروجی که توسط پلتفرم Android استفاده می‌کنید، استفاده کنید. به عنوان مثال، برنامه های شخص ثالث ممکن است تماس ها را لغو کرده و آنها را از طریق VoIP تغییر مسیر دهند.

کاتلین

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

جاوا

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

شما باید این سرویس را در مانیفست ثبت کنید تا سیستم بتواند آن را به درستی راه اندازی کند.

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

برای استفاده از سرویس تغییر مسیر، برنامه شما باید نقش تغییر مسیر تماس را از RoleManager درخواست کند. این از کاربر می‌پرسد که آیا می‌خواهد به برنامه شما اجازه دهد تا تغییر مسیر تماس را مدیریت کند یا خیر. اگر به برنامه شما این نقش اعطا نشود، از سرویس تغییر مسیر شما استفاده نمی‌شود.

وقتی کاربر برنامه شما را راه اندازی می کند، باید بررسی کنید که آیا برنامه شما این نقش را دارد تا بتوانید در صورت نیاز آن را درخواست کنید. شما یک intent ایجاد شده توسط RoleManager را راه اندازی می کنید، بنابراین مطمئن شوید که تابع onActivityResult() برای مدیریت انتخاب کاربر نادیده می گیرید.

کاتلین

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

جاوا

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