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

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

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

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

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

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

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

روش کار:

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

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

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

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

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

یادداشت مهم درباره سازگاری

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

شروع به کار

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

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

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

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

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