تربط طبقة تجريد الأجهزة الصوتية (HAL) في Android واجهات برمجة التطبيقات ذات المستوى الأعلى
المخصّصة للإطارات الصوتية بandroid.media
برامج تشغيل الصوت والأجهزة الأساسية. يحدِّد Audio HAL الواجهة
المعيار التي تستدعيها خدمات الصوت. يجب تنفيذ Audio HAL ليعمل
معدات الصوت بشكل صحيح.
تقدّم هذه الصفحة نظرة عامة على Audio HAL وتقدّم تفاصيل حول واجهة برمجة التطبيقات ومتطلبات التنفيذ.
واجهة Audio HAL
بدءًا من الإصدار 14 من Android، يتم تحديد واجهة Audio HAL باستخدام AIDL. في الإصدارات السابقة، يتم تحديد واجهة HAL للصوت باستخدام HIDL. ننصح الشركاء وبائعي شرائح المعالجة المتقدّمة (SoC) بإعادة تنفيذ واجهة HAL للصوت من أجل توفير واجهة AIDL.
لا تتوفّر واجهات برمجة التطبيقات الجديدة لـ HAL للميزات التي تمت إضافتها في الإصدار 14 من Android والإصدارات الأحدث إلا عند تنفيذ واجهة AIDL. اعتبارًا من Android 14، لم تتم إضافة أي واجهة برمجة تطبيقات جديدة إلى تنفيذ HIDL.
يؤدي التبديل إلى AIDL وإيقاف الإصدارات السابقة الكبرى من Audio HAL نهائيًا وإزالتها إلى توفير مساحة على القرص وذاكرة الوصول العشوائي (RAM) على الأجهزة. يؤدي ذلك إلى توفير تجربة مستخدم سلسة والسماح بتوفير ميزات جديدة تظهر للمستخدمين النهائيين.
اطّلِع على مقارنة بين AIDL وHIDL Audio HAL لمزيد من المعلومات عن الاختلافات بين AIDL وHIDL Audio HAL.
واجهة برمجة التطبيقات Audio HAL
يحتوي Audio HAL على واجهات برمجة التطبيقات التالية:
- Core HAL هي واجهة برمجة التطبيقات الرئيسية التي يستخدمها AudioFlinger لتشغيل الصوت والتحكّم في توجيهه.
يستخدم إطار عمل التأثيرات واجهة برمجة التطبيقات Effects HAL API للتحكّم في التأثيرات الصوتية. يمكنك أيضًا ضبط تأثيرات المعالجة المُسبَقة مثل التحكّم التلقائي في الكسب وتقليل الضوضاء من خلال واجهة برمجة التطبيقات Effects HAL API.
Common HAL API هي مكتبة لأنواع البيانات الشائعة التي تستخدمها واجهات برمجة التطبيقات Core و Effects HAL API. لا تتضمّن واجهة HAL الشائعة أي واجهات أو اختبارات VTS مرتبطة بها، لأنّها تحدّد هياكل البيانات فقط.
راجِع واجهة برمجة التطبيقات لنظام HAL للصوت في AIDL وواجهة برمجة التطبيقات لنظام HAL للصوت في HIDL للحصول على تفاصيل محدّدة متعلقة بواجهتَي AIDL وHIDL على التوالي.
المتطلبات
بالإضافة إلى تنفيذ Audio HAL وإنشاء ملف إعدادات ملف سياسة الصوت، عليك الالتزام بمتطلبات HAL التالية:
إذا كان ملف تعريف إدخال واحد يتيح تسجيل ميزة "الاستجابة للصوت" (التسجيل من مخزن مؤقت لمعالج الإشارات الرقمية للكلمة الرئيسية)، يجب أن يتيح التنفيذ عدد عمليات البث النشطة في هذا الملف الشخصي بما يتوافق مع عدد الجلسات المتزامنة التي تتيحها واجهة برمجة التطبيقات لميزة "الاستجابة للصوت".
التزامن بين إرسال المكالمات الصوتية وتسجيلها من معالج التطبيق كما هو موضح بالتفصيل في صفحة التسجيل المتزامن