إرشادات برنامج AEP: إطار عمل الاتصالات في Android

يمكنك التكامل مع إطار عمل Android Telecom باستخدام مكتبة Core-Telecom Jetpack لضمان تعامُل نظام التشغيل مع مكالمات نقل الصوت عبر بروتوكول الإنترنت (VoIP) كميزة أساسية ، على غرار المكالمات التقليدية المستندة إلى شريحة SIM. يؤدي هذا التكامل إلى توحيد إدارة المكالمات وتحسين معالجة الصوت وتفعيل التوافق مع الأجهزة البعيدة، مثل سماعات الرأس والساعات.

التنفيذ المطلوب

للتأهّل لبرنامج "تجربة Android المحسّنة"، يجب أن يلتزم تطبيقك بالمتطلبات التالية:

رقم التعريف الإرشادات
AEP-TC-GAA تسجيل المكالمات: يجب تسجيل جميع مكالمات نقل الصوت عبر بروتوكول الإنترنت (VoIP) الواردة والصادرة في إطار عمل Telecom باستخدام واجهة برمجة التطبيقات CallsManager#addCall.
AEP-TC-GAB إدارة الحالة: استخدِم CallControlScope وبُنى المكتبة الأخرى لمحاكاة مراحل نشاط المكالمة وإدارتها بدقة، بما في ذلك حالات الاتصال، والرنين، والنشطة، والمعلّقة، والمنقطعة.
AEP-TC-GAC معالجة الصوت: لا تستخدِم واجهات برمجة التطبيقات "الصوتية" أو واجهات برمجة تطبيقات "البلوتوث" مباشرةً لإدارة أولويّة الصوت وتوجيهه، بل اعتمد على إطار عمل Telecom لمعالجة سيناريوهات المكالمات المتزامنة والتغييرات في الأجهزة الصوتية.
AEP-TC-GAD الإشعارات: استخدِم واجهة برمجة التطبيقات callStyle لعرض إشعارات بنمط المكالمات تتوافق مع نظام Android.
AEP-TC-GAE مراحل نشاط الخدمة التي تعمل في المقدّمة: أدر مراحل نشاط أي "خدمات تعمل في المقدّمة" ضرورية للمكالمة بما يتوافق مع أفضل الممارسات والقيود في Android.
AEP-TC-GAF التكامل مع مساحات العرض البعيدة: تتم مزامنة حالة المكالمة وعناصر التحكّم مع مساحات العرض البعيدة المتصلة، مثل سماعات الرأس البلوتوث وأجهزة Wear OS وAndroid Auto.
AEP-TC-GAG سيناريوهات المكالمات المتعدّدة: يتم التعامل بسلاسة مع التفاعلات الناتجة عن المكالمات الأخرى، مثل مكالمات شريحة SIM الواردة أو المكالمات الواردة من تطبيقات نقل الصوت عبر بروتوكول الإنترنت (VoIP) الأخرى، ما يضمن أداءً صوتيًا وتجربة مستخدم متوقّعين.

قابلية تطبيق الإرشادات

تنطبق هذه الإرشادات على ما يلي:

  • التطبيقات التي توفّر إمكانات نقل الصوت عبر بروتوكول الإنترنت (VoIP)
  • جميع أشكال الأجهزة التي يتوفّر عليها التطبيق

الإعفاءات

تنطبق الإعفاءات التالية على هذه الإرشادات:

رقم التعريف إعفاء
التطبيقات التي لا يمكنها من الناحية الفنية استخدام تبعيات AndroidX بسبب عوائق فنية، مثل:
AEP-TC-EAA التعارضات في تبعيات حزمة تطوير البرامج (SDK)
AEP-TC-EAB قيود مشروع Android مفتوح المصدر (AOSP)
AEP-TC-EAC قيود نظام الإصدار الخاص بمصنّع المعدات الأصلية (OEM)
AEP-TC-EAD قد يتم منح إعفاءات مؤقتة للتطبيقات التي تواجه مشاكل كبيرة في النظام الأساسي أو المكتبة تمنع إجراء عملية نقل بيانات مستقرة، شرط أن يكون هناك جدول زمني واضح لحلّ المشكلة وأن تكون Google قد قبلت المشكلة.
AEP-TC-EAE يمكن للتطبيقات استخدام إطار عمل بديل مكافئ يوفّر جودة وإمكانات للمستخدم واستقرارًا وتوافقًا مماثلَين في جميع أنحاء النظام. يُرجى التواصل مع فريق الدعم إذا كان لديك إطار عمل مناسب تريد أن نأخذه في الاعتبار.

مستندات الميزات والمراجع

توفّر المراجع التالية إرشادات التنفيذ والتفاصيل الفنية حول إطار عمل Android Telecom. هذه المراجع هي للاطلاع فقط ولا تحتوي على متطلبات إضافية للبرنامج.