با جدیدترین نسخه آلفای Telecom، قابلیت رؤیت بومی را به تجربه برنامه VoIP خود اضافه کنید

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

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

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

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

در گذشته، کاربران برای مشاهده سابقه تماس VoIP یا پاسخ دادن به تماس بی‌پاسخ باید برنامه‌های طرف سوم را به‌صورت جداگانه باز می‌کردند. با ویژگی جدید گزارش تماس یکپارچه، برنامه‌های شماره‌گیر سیستم اکنون می‌توانند گزارش‌های تماس را مستقیماً از برنامه‌های 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 استفاده می‌کنند. برای آزمایش محلی پیاده‌سازی‌های ثبت و فراخوانی، توصیه می‌کنیم از برنامه متن‌باز Telecom Sample Dialer به‌عنوان محیط شبیه‌ساز خود استفاده کنید.