در اولین انتشار کتابخانه Jetpack Telecom، CallsManager معرفی شد که جایگزین API قدیمی ConnectionService برای ساده‌سازی ادغام VoIP شد. CallsManager مدیریت چرخه تماس و مسیریابی صوتی را ساده می‌کند و در عین حال امکان تعامل با سطوح کنترل از راه دور مانند ساعت‌های هوشمند، دستگاه‌های بلوتوث و Android Auto را فراهم می‌کند. علاوه بر این، از افزونه‌های تماس برای ویژگی‌های غنی‌تر - مانند مدیریت شرکت‌کنندگان، آیکون‌های سفارشی، بی‌صدا کردن تماس و خلاصه جلسه در سطوح کنترل از راه دور - پشتیبانی می‌کند و در عین حال سازگاری با اندروید O (سطح API 26) را نیز حفظ می‌کند.

با تکیه بر این پایه، Jetpack Telecom نسخه ۱.۱.۰ قابلیت مشاهده و راحتی در سطح بومی را برای برنامه‌های VoIP شخص ثالث فراهم می‌کند. این آخرین نسخه، قابلیت‌های جدید و قدرتمندی از جمله تاریخچه تماس یکپارچه، حذف گزارش تماس و قابلیت پاسخ به تماس بومی را معرفی می‌کند و مدیریت تماس را برای کاربران بیش از پیش یکپارچه می‌سازد.

در اینجا نگاهی دقیق‌تر به ویژگی‌های جدید و نحوه پیاده‌سازی این ویژگی‌ها در برنامه‌هایتان می‌اندازیم.

پر کردن شکاف شماره‌گیری: تاریخچه تماس یکپارچه و تماس‌های برگشتی

از گذشته، کاربران برای مشاهده سابقه تماس VoIP خود یا پاسخ به یک تماس از دست رفته، مجبور بودند برنامه‌های شخص ثالث را به صورت جداگانه باز کنند. با ویژگی جدید ثبت تماس یکپارچه، برنامه‌های شماره‌گیر سیستم اکنون می‌توانند گزارش‌های تماس را مستقیماً از برنامه‌های VoIP شخص ثالث نمایش دهند.

حتی بهتر از آن، کاربران اکنون می‌توانند مستقیماً از طریق شماره‌گیر سیستم خود، با یک مخاطب VoIP تماس مجدد برقرار کنند و تجربه ارتباطی را ساده‌تر کنند.

چگونه کار می‌کند:

برای فعال کردن این قابلیت، مراحل زیر را انجام دهید:

1. ثبت نام برای Callbacks: برنامه VoIP شما باید یک intent جدید با محافظت سیستمی به نام TelecomManager.ACTION_CALL_BACK ثبت کند.
2. ثبت تماس: از TelecomManager.addCall (یا APIهای مرتبط با Jetpack) برای اطمینان از ثبت خودکار تماس توسط سیستم استفاده کنید.
3. مدیریت شناسه‌های تماس: وقتی یک تماس ثبت می‌شود، CallControlScope.getCallId یک UUID منحصر به فرد ارائه می‌دهد. شماره‌گیر سیستم هنگام ایجاد callback intent دقیقاً از همین TelecomManager.EXTRA_UUID استفاده می‌کند.
4. شروع فراخوانی مجدد: برنامه شما باید جزئیات فراخوانی مرتبط با این UUID را ذخیره و مدیریت کند. هنگامی که شماره‌گیر سیستم، قصد فراخوانی مجدد را با EXTRA_UUID فعال می‌کند، برنامه شما می‌تواند به طور یکپارچه شناسه را حل کرده و فراخوانی را با جزئیات صحیح آغاز کند.

کنترل دقیق: حذف گزارش تماس

ما می‌دانیم که هر تماس VoIP نباید در تاریخچه شماره‌گیر بومی سیستم قابل مشاهده باشد. چه به دلایل حریم خصوصی، ارتباطات زودگذر یا رفتار خاص برنامه، شما نیاز به کنترل آنچه که نمایش داده می‌شود دارید.

برای حل این مشکل، ما قابلیت Call Log Exclusion را معرفی می‌کنیم. اکنون می‌توانید با تنظیم مقدار بولی isLogExcluded روی true در CallAttributesCompat ، از ثبت تماس‌های خاص در گزارش‌های تماس سیستم جلوگیری کنید. با پیکربندی این پرچم، تماس کاملاً از گزارش‌های سیستم پنهان می‌ماند و شماره‌گیر بومی آن را نمایش نمی‌دهد.

نکته مهم در مورد سازگاری

این ویژگی‌های یکپارچه‌ی ثبت وقایع و فراخوانی مجدد برای دستگاه‌هایی که اندروید ۱۶.۱ (SDK 36.1) و بالاتر را اجرا می‌کنند، در دسترس هستند. برای کامپایل برنامه‌ی خود با Android SDK 36.1 به اینجا مراجعه کنید.

شروع کنید

ما توسعه‌دهندگان را تشویق می‌کنیم که این یکپارچه‌سازی‌ها را آزمایش کنند و بررسی کنند که چگونه تاریخچه تماس یکپارچه و تماس‌های برگشتی می‌توانند تجربه کاربری روزانه برنامه‌های VoIP شما را بهبود بخشند.

برای کمک به شما در شروع کار و مشاهده‌ی این APIها در عمل، یک برنامه‌ی نمونه گردآوری کرده‌ایم که ادغام‌های جدید را نشان می‌دهد.

• نمونه برنامه را اینجا ببینید: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

برای شروع پیاده‌سازی این ویژگی‌ها، همین امروز یادداشت‌های انتشار و مستندات را بررسی کنید!

توجه: اگرچه APIهای Jetpack Telecom نسخه ۱.۱.۰ برای ادغام در دسترس هستند، اما قابلیت شماره‌گیر سیستم برای ارائه گزارش‌های تماس بومی به صورت مرحله‌ای و با شروع Google Meet معرفی می‌شود. برای محافظت در برابر هرزنامه، شماره‌گیرهای بومی از لیست‌های مجاز بسته امن برای کنترل نمایش VoIP استفاده می‌کنند. برای آزمایش محلی پیاده‌سازی‌های پاسخ به تماس و گزارش‌گیری، توصیه می‌کنیم از برنامه Telecom Sample Dialer متن‌باز به عنوان محیط شبیه‌ساز خود استفاده کنید.