توفير إمكانية ظهور أصلية لتجربة تطبيق نقل الصوت عبر بروتوكول الإنترنت (VoIP) باستخدام أحدث إصدار ألفا من Telecom

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

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

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

سدّ الفجوة في تطبيق "الهاتف": سجلّ المكالمات الموحّد ووظائف معاودة الاتصال

في السابق، كان على المستخدمين فتح تطبيقات خارجية فردية لعرض سجلّ مكالمات نقل الصوت عبر بروتوكول الإنترنت (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 (حزمة تطوير البرامج SDK 36.1) والإصدارات الأحدث. يُرجى الرجوع إلى هنا لتجميع تطبيقك باستخدام حزمة تطوير البرامج Android SDK 36.1.

البدء

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

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

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

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

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