با جدیدترین نسخه آلفای Telecom، به تجربه برنامه VoIP خود «رؤیت‌پذیری بومی» اضافه کنید

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

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

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

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

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

بهتر از آن، کاربران اکنون می‌توانند مستقیماً از شماره‌گیر سیستم بومی خود با مخاطب «پروتکل صدا ازطریق اینترنت» تماس بگیرند و تجربه ارتباط را ساده‌تر کنند.

روش کار:

برای موافقت با این ویژگی، مراحل زیر را انجام دهید:

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

کنترل دقیق: مستثنا کردن گزارش تماس

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

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

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

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

شروع به کار

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

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

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

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

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