إتاحة ميزة "الرؤية الأصلية" في تجربة تطبيق VoIP من خلال أحدث إصدار تجريبي من شركة الاتصالات

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

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

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

سدّ الفجوة في تطبيق "الهاتف": سجلّ مكالمات موحَّد وميزة "الاتصال مجددًا"

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

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

طريقة العمل:

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

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