في نظام التشغيل Android 14 والإصدارات الأحدث، يتم تحديد واجهة Audio HAL باستخدام Stable AIDL. ننصح الشركاء ومورّدي نظام على شريحة بإعادة تنفيذ طبقة تجريد الأجهزة الصوتية (HAL) لتوفير واجهة AIDL.
تؤدي إضافة مكتبة libaudiohal إلى توفير دعم إطار العمل لطبقة تجريد الأجهزة (HAL) المستندة إلى لغة تعريف واجهة Android (AIDL).
مع تنفيذ AIDL، يتم نقل مواصفات إعداد سياسة الصوت إلى AIDL HAL. وبفضل هذا التغيير، يحصل "مدير سياسات الصوت" (APM) على الإعدادات من طبقة تجريد الأجهزة (HAL) بدلاً من استهلاكها من ملف XML الذي يوفّره المورّد.
Audio AIDL HAL API
يصف هذا القسم واجهات برمجة التطبيقات Core وEffects وCommon HAL الخاصة بلغة AIDL.
استخدِم التنفيذ التلقائي لواجهة AIDL API في
/hardware/interfaces/audio/aidl/default/
كمرجع عند تنفيذ إصدارات جديدة من طبقات تجريد الأجهزة الصوتية (HAL) التي تتفاعل مع برامج تشغيل النواة.
راجِع ملف README الخاص بطبقة تجريد الأجهزة الصوتية (HAL) للاطّلاع على بنية دليل طبقة تجريد الأجهزة الصوتية (HAL) لواجهة تعريف لغة AIDL.
Core HAL
في ما يلي بعض الواجهات الرئيسية في Core HAL التي تستخدم AIDL:
-
IModule.aidlهي نقطة الدخول إلى واجهة برمجة التطبيقات. - تكون عمليات البث أحادية الاتجاه، ويستخدمها AudioFlinger لإرسال الصوت أو تلقّيه من طبقة HAL وإليها من خلال
IStreamOut.aidlوIStreamIn.aidl. - توفّر
ITelephony.aidlعناصر تحكّم خاصة بوظائف الاتصال الهاتفي. - توفّر
IBluetooth.aidlعناصر تحكّم في BT SCO وHFP كانت متوفّرة فيIPrimaryModuleفي واجهة برمجة التطبيقات HIDL. - توفّر
IConfig.aidlمَعلمات الضبط على مستوى النظام. - يوفر
ISoundDose.aidlميزة "جرعة الصوت". يمكنك الاطّلاع على مقدار التعرّض للأصوات لمزيد من المعلومات. - يتوفّر أحدث إصدار من Core HAL API قيد التطوير في
/hardware/interfaces/audio/aidl/android/hardware/audio/core/. - يتوفّر أحدث إصدار تم إصداره من واجهة برمجة تطبيقات Core HAL في
/hardware/interfaces/audio/aidl/aidl_api/android.hardware.audio.core/.
طبقة تجريد الأجهزة للتأثيرات
في ما يلي بعض الواجهات الرئيسية لطبقة تجريد الأجهزة (HAL) الخاصة بالمؤثرات، باستخدام AIDL:
-
IFactory.aidlهي نقطة الدخول إلى واجهة برمجة التطبيقات. - يحتوي
Descriptor.aidlعلى جميع المعلومات، مثل الإمكانات والسمات، الخاصة بتنفيذ المؤثر. - يحدّد
Capability.aidlإمكانات التأثير التي لا تتغيّر في وقت التشغيل. - يحدّد
Parameter.aidlجميع المَعلمات التي يدعمها مثيل التأثير. - يُستخدَم
IEffect.aidlلضبط عناصر تأثير معيّنة والتحكّم فيها. حِزم قابلة للتسلسل خاصة بالتأثيرات ومسمّاة باسم التأثير
يتوفّر أحدث إصدار من واجهة برمجة التطبيقات Effects HAL قيد التطوير في
/hardware/interfaces/audio/aidl/android/hardware/audio/effect/.يتوفّر أحدث إصدار تم إصداره من Effects HAL API في
/hardware/interfaces/audio/aidl/aidl_api/android.hardware.audio.effect.
يمكنك الاطّلاع على التأثيرات الصوتية لمزيد من المعلومات.
Common HAL
تتوفّر في Common HAL بنى البيانات والواجهات المشترَكة بين مختلف طبقات تجريد الأجهزة (HAL)، مثل طبقات تجريد الأجهزة الخاصة بتقنية البلوتوث وطبقات تجريد الأجهزة الأساسية وطبقات تجريد الأجهزة الخاصة بتأثيرات الصوت.
يتوفّر أحدث إصدار من Common AIDL HAL قيد التطوير في
/hardware/interfaces/audio/aidl/android/hardware/audio/common/.يتوفّر أحدث إصدار تم إصداره من واجهة برمجة التطبيقات Common HAL API في
/hardware/interfaces/audio/aidl/aidl_api/android.hardware.audio.common/current/android/hardware/audio/common/.
أنواع البيانات الثابتة الشائعة
تُستخدم تعريفات بنية البيانات الثابتة من قِبل كل من طبقات تجريد الأجهزة (HAL) وإطار العمل.
يتوفّر أحدث إصدار من أنواع البيانات الثابتة قيد التطوير في
/system/hardware/interfaces/media/aidl/android/media/audio/common/.يتوفّر أحدث إصدار تم إطلاقه من أنواع البيانات الثابتة في
/system/hardware/interfaces/media/aidl_api/android.media.audio.common.types/.
اختبار واجهة برمجة التطبيقات Audio AIDL HAL
يتم توفير اختبارات VTS جديدة لواجهة AIDL.
لا تتضمّن نسخة HAL الجديدة أي تغييرات يمكن أن تؤثر في الأمان.