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

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

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

سدّ الفجوة في برنامج الاتصال: سجلّ المكالمات الموحّد ووظائف معاودة الاتصال

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

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

آلية العمل:

للانضمام إلى هذه الميزة، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

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

البدء

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

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

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

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

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