يمكنك الدمج مع إطار عمل Android Telecom باستخدام مكتبة Core-Telecom Jetpack لضمان تعامل نظام التشغيل مع مكالمات بروتوكول نقل الصوت عبر الإنترنت (VoIP) باعتبارها ميزة أساسية، تمامًا مثل المكالمات التقليدية المستندة إلى شرائح SIM. تتيح عملية الدمج هذه توحيد إدارة المكالمات وتحسين معالجة الصوت وتوفير التوافق مع الأجهزة الخارجية، مثل سماعات الرأس والساعات.
عملية التنفيذ المطلوبة
للتأهّل لبرنامج AEP، يجب أن يلتزم تطبيقك بالمتطلبات التالية:
- تسجيل المكالمات: يجب تسجيل جميع مكالمات VoIP الواردة والصادرة في إطار عمل Telecom باستخدام واجهة برمجة التطبيقات CallsManager#addCall.
- إدارة الحالة: استخدِم CallControlScope وبنيات المكتبة الأخرى لتعكس بدقة دورة حياة حالة المكالمة وإدارتها، بما في ذلك حالات الاتصال والرنين والنشاط والتعليق والفصل.
- التعامل مع الصوت: لا تستخدِم واجهات برمجة التطبيقات Audio أو Bluetooth مباشرةً لإدارة أولويّة الصوت وتوجيهه، بل اعتمد على إطار عمل Telecom للتعامل مع سيناريوهات المكالمات المتزامنة وتغييرات أجهزة الصوت.
- الإشعارات: استخدِم واجهة برمجة التطبيقات callStyle لعرض إشعارات بنمط المكالمات تتوافق مع نظام Android.
- مراحل نشاط الخدمة التي تعمل في المقدّمة: يمكنك إدارة مراحل نشاط أي خدمات تعمل في المقدّمة ضرورية لإجراء المكالمة وفقًا لأفضل ممارسات Android وقيوده.
- التكامل مع الأجهزة الخارجية: تتم مزامنة حالة المكالمة وعناصر التحكّم مع الأجهزة الخارجية المتصلة، مثل سماعات الرأس التي تعمل بالبلوتوث وأجهزة Wear OS وAndroid Auto.
- سيناريوهات المكالمات المتعددة: التعامل بسلاسة مع التفاعلات مع المكالمات الأخرى، مثل المكالمات الواردة عبر شريحة SIM أو المكالمات من تطبيقات VoIP الأخرى، ما يضمن سلوكًا صوتيًا وتجربة مستخدم يمكن التنبؤ بهما.
قابلية تطبيق الإرشادات
تنطبق هذه الإرشادات على ما يلي:
- توفّر التطبيقات إمكانات الاتصال عبر بروتوكول الإنترنت (VoIP).
- جميع أشكال الأجهزة التي يتوفّر عليها التطبيق
الإعفاءات
تنطبق الإعفاءات التالية على هذا الإرشاد:
- التطبيقات التي لا يمكنها من الناحية الفنية استخدام تبعيات AndroidX بسبب
عوائق فنية مثل:
- تعارضات العناصر الاعتمادية لحزمة تطوير البرامج (SDK)
- قيود "مشروع Android المفتوح المصدر" (AOSP)
- القيود المفروضة على نظام الإصدار الخاص بالمصنّع الأصلي للجهاز (OEM)
- يمكن منح إعفاءات مؤقتة للتطبيقات التي تواجه مشاكل كبيرة في المنصة أو المكتبة تمنع عملية نقل البيانات بشكل مستقر، بشرط توفُّر جدول زمني واضح لحل المشكلة وقبول Google لها.
- يمكن للتطبيقات استخدام إطار عمل بديل مكافئ يوفّر جودة وإمكانات للمستخدمين واستقرارًا وتوافقًا مماثلاً في جميع أنحاء النظام المتكامل. يُرجى التواصل مع فريق الدعم إذا كان لديك إطار عمل مناسب للنظر فيه.
مستندات الميزات والمراجع
تقدّم المراجع التالية إرشادات حول التنفيذ وتفاصيل فنية بشأن إطار عمل Android Telecom. هذه المراجع مخصّصة لك فقط ولا تتضمّن متطلبات إضافية للبرنامج.
- إنشاء تطبيق اتصال
- نظرة عامة على إطار عمل الاتصالات
- دمج سجلّ المكالمات
- توفير إمكانية الوصول إلى تجربة تطبيق VoIP