إتاحة ظهور تطبيقات VoIP على واجهة الجهاز من خلال الإصدار الأولي الأخير من Telecom

قدّم الإصدار الأولي من مكتبة Jetpack Telecom CallsManager، ليحلّ محل واجهة برمجة التطبيقات القديمة ConnectionService من أجل تبسيط عملية دمج بروتوكول VoIP. تسهّل واجهة برمجة التطبيقات CallsManager إدارة دورة حياة المكالمات وتوجيه الصوت، وتتيح التفاعل مع مساحات العرض البعيدة، مثل الساعات الذكية والأجهزة التي تتضمّن بلوتوث وAndroid Auto. بالإضافة إلى ذلك، تتيح هذه الواجهة استخدام إضافات المكالمات لتوفير ميزات أكثر ثراءً، مثل إدارة المشاركين والرموز المخصّصة وكتم صوت المكالمات وملخّص الاجتماع على الأجهزة البعيدة، مع الحفاظ على التوافق مع الأنظمة القديمة حتى Android O (مستوى واجهة برمجة التطبيقات 26).

استنادًا إلى هذا الأساس، يوفّر الإصدار 1.1.0 من Jetpack Telecom مستوى رؤية وراحة على مستوى التطبيقات الأصلية لتطبيقات VoIP التابعة لجهات خارجية. يقدّم هذا الإصدار الأخير إمكانات جديدة فعّالة، بما في ذلك سجلّ المكالمات الموحّد، واستبعاد سجلّ المكالمات، ووظيفة معاودة الاتصال المضمّنة، ما يجعل إدارة المكالمات أكثر سلاسة من أي وقت مضى للمستخدمين.

في ما يلي نظرة عن كثب على الميزات الجديدة وكيفية تنفيذها في تطبيقاتك.

سدّ الفجوة في برامج الاتصال: سجلّ المكالمات الموحّد وميزة "معاودة الاتصال"

في السابق، كان على المستخدمين فتح تطبيقات خارجية فردية للاطّلاع على سجلّ مكالمات VoIP أو معاودة الاتصال بمكالمة فائتة. من خلال ميزة تسجيل المكالمات المدمجة الجديدة، يمكن الآن لتطبيقات الاتصال التلقائي على النظام عرض سجلّات المكالمات مباشرةً من تطبيقات VoIP التابعة لجهات خارجية.

والأفضل من ذلك هو أنّه يمكن للمستخدمين الآن بدء معاودة الاتصال بجهة اتصال عبر بروتوكول VoIP مباشرةً من برنامج الاتصال الأصلي في النظام، ما يسهّل تجربة التواصل.

طريقة العمل:

للموافقة على هذه الميزة، اتّبِع الخطوات التالية:

1. التسجيل لتلقّي عمليات معاودة الاتصال: يجب أن يسجّل تطبيق VoIP نية جديدة محمية من النظام: TelecomManager.ACTION_CALL_BACK.
2. تسجيل المكالمة: استخدِم TelecomManager.addCall (أو واجهات برمجة تطبيقات Jetpack ذات الصلة) لضمان تسجيل النظام للمكالمة تلقائيًا.
3. إدارة معرّفات المكالمات: عند تسجيل مكالمة، يوفّر CallControlScope.getCallId معرّفًا فريدًا عالميًا (UUID). يستخدم برنامج الاتصال في النظام هذا الرمز TelecomManager.EXTRA_UUID بالضبط عند إنشاء نية معاودة الاتصال.
4. بدء معاودة الاتصال: يجب أن يخزّن تطبيقك تفاصيل المكالمة المرتبطة بمعرّف UUID هذا ويديرها. عندما يشغّل برنامج الاتصال في النظام نية معاودة الاتصال باستخدام EXTRA_UUID، يمكن لتطبيقك حلّ المعرّف بسلاسة وبدء المكالمة بالتفاصيل الصحيحة.

التحكّم الدقيق: استبعاد سجلّ المكالمات

ندرك أنّه ليس من الضروري أن تظهر كل مكالمة عبر بروتوكول VoIP في سجلّ برنامج الاتصال الأصلي للنظام. وسواء كان ذلك لأسباب تتعلق بالخصوصية أو التواصل المؤقت أو السلوك الخاص بالتطبيق، يجب أن تتحكّم في ما يتم عرضه.

لحلّ هذه المشكلة، سنطرح ميزة استبعاد سجلّ المكالمات. يمكنك الآن منع تسجيل مكالمات معيّنة في سجلّات المكالمات على النظام من خلال ضبط القيمة المنطقية isLogExcluded على true ضمن CallAttributesCompat. من خلال ضبط هذه العلامة، تظل المكالمة مخفية تمامًا من سجلات النظام، ولن يعرضها برنامج الاتصال الأصلي.

ملاحظة مهمة حول التوافق

تتوفّر ميزات التسجيل المدمجة وعمليات الاستدعاء للأجهزة التي تعمل بالإصدار Android 16.1 (SDK 36.1) والإصدارات الأحدث. يُرجى الرجوع هنا لتجميع تطبيقك باستخدام الإصدار 36.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.

البدء

نشجّع المطوّرين على اختبار عمليات الدمج هذه واستكشاف كيف يمكن لسجل المكالمات الموحّد وعمليات معاودة الاتصال تحسين تجربة المستخدم اليومية لتطبيقات VoIP.

لمساعدتك في البدء والاطّلاع على واجهات برمجة التطبيقات هذه أثناء العمل، جمعنا نموذج تطبيق يوضّح عمليات الدمج الجديدة.

• يمكنك الاطّلاع على نموذج التطبيق هنا: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

يمكنك الاطّلاع على ملاحظات الإصدار والمستندات لبدء تنفيذ هذه الميزات اليوم.

ملاحظة: على الرغم من أنّ واجهات برمجة التطبيقات Jetpack Telecom v1.1.0 متاحة للدمج، يتم طرح إمكانية عرض سجلّات المكالمات الأصلية في برنامج الاتصال بالنظام على مراحل، بدءًا من Google Meet. للحماية من الرسائل غير المرغوب فيها، تستخدم برامج الاتصال الأصلية قوائم مسموح بها للحزم الآمنة من أجل التحكّم في عرض بروتوكول VoIP. لإجراء اختبار محلي لعمليات تنفيذ عمليات معاودة الاتصال والتسجيل، ننصحك باستخدام تطبيق Telecom Sample Dialer المفتوح المصدر كبيئة محاكاة.