اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مقارنة بين AIDL وHIDL Audio HAL
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

بدءًا من Android 14، ننصح الشركاء ومورّدي شرائح المعالجة المتكاملة باستبدال تنفيذ HIDL HAL الحالي بتنفيذ AIDL HAL.

لتسهيل الانتقال السلس من HIDL Audio HAL إلى AIDL Audio HAL، تم تمييز بعض الاختلافات الرئيسية في هذه الصفحة. تعرض هذه الصفحة أيضًا التعيين بين واجهات AIDL وHIDL لملف تعريف برمجة التطبيقات Audio HAL.

الفرق بين تنفيذ AIDL وHIDL Audio HAL

في ما يلي اختلافات HIDL الرئيسية عن AIDL:

في AIDL Audio Core HAL، تم تقديم واجهة IConfig كبديل للمَعلمات على مستوى النظام في ملفات XML في HIDL HAL. يقرأ إطار العمل هذه المَعلمات من Core HAL بدلاً من ملف إعدادات المورِّد. على سبيل المثال، يتم توفير قائمة تنسيقات الصوت المحيطي التي يتم عرضها للمستخدم للتحكم فيها من خلال الأسلوب IConfig.getSurroundSoundConfig في Core HAL.

في AIDL Audio Effects HAL، يتم نقل منطق effectProxy المحدَّد في ملفات XML في HIDL Effects HAL إلى إطار عمل الصوت. يبحث إطار العمل الصوتي عن جميع نُسخ التأثير في النظام باستخدام IFactory.queryEffects، وجميع عمليات معالجة التأثير باستخدام IFactory.queryProcessing.
لتجنُّب الالتباس الناتج عن استخدام مصطلح الجهاز لأنواع أجهزة الصوت، تم إعادة تسمية IDevice في HIDL Audio HAL إلى IModule في AIDL Audio HAL.
تم استبدال IPrimaryDevice في AIDL Audio HAL. يتم إرسال آخر المعلومات حول وضع الصوت الحالي وتدوير الشاشة إلى كل مثيل من IModule. تعالج واجهة IBluetooth المخصّصة المَعلمات المرتبطة بالاتصال المتزامن عبر البلوتوث (BT SCO) وملف الإعدادات بلا لمس الجهاز (HFP). توفّر واجهة ITelephony مخصّصة عناصر تحكّم متعلقة بخدمات الهاتف. يمكن استرداد نُسخ من كلتا الواجهات من النسخة الأساسية لواجهة IModule. اطّلِع على جداول المقارنة حول HAL الأساسية والوظائف ذات الصلة بالميزات للحصول على مزيد من المعلومات.
تمت إزالة IDevicesFactory في AIDL Audio HAL لتجنُّب التكرار. يتم الآن تسجيل وحدات HAL (أي، مثيلات واجهة IModule) مباشرةً مع "مدير الخدمات" باستخدام أسمائها لأسماء المثيلات، مثل bluetooth أو r_submix. الاستثناء الوحيد هو وحدة primary التي يتم تسجيلها تحت اسم المثيل default.

تعيين واجهة برمجة التطبيقات لنظام التشغيل Android (AIDL) وواجهة HIDL لنظام التشغيل Android (HAL) للصوت

تعرض الجداول في الأقسام التالية عملية الربط بين واجهات HIDL وAIDL Audio HAL. راجِع ملف README الخاص بواجهة برمجة التطبيقات لوحدة التحكّم في الصوت لمزيد من المعلومات عن بنية الدليل.

Core HAL

تقع جميع واجهات HIDL ضمن حزمة android.hardware.audio@N.M، حيث يشيرN.M إلى الإصدار Major.Minor. تتوفّر جميع واجهات AIDL ضمن حزمة android.hardware.audio.core.

واجهات HIDL API وملفات الإعداد	واجهات برمجة التطبيقات AIDL
`IDevicesFactory`	تسجيل النطاق `IModule` من قِبل `ServiceManager`
`IDevice`	`IModule`
`IPrimaryDevice`	`ITelephony` `IBluetooth`
`IStream` `IStreamIn` `IStreamOut`	`StreamDescriptor` `IStreamIn` `IStreamCommon` `IStreamOut`
`audio_policy_configuration.xml` `audio_policy_engine_configuration.xml`	`IConfig` `IModule`
ملفات سياسة الصوت القابلة للضبط	استخدِم آلية تنفيذ HIDL لنظام التشغيل Android 14.

منافذ الصوت والملفات الشخصية الديناميكية والمسارات والتعديلات

في هذا الجدول، يتم تحديد عناصر ملفات XML باستخدام الأقواس الحادة.

طرق واجهة HIDL API وعناصر ملفات الضبط	طرق واجهة برمجة التطبيقات AIDL
`<attachedDevices>` `<defaultOutputDevice>` `<mixPorts>` `<devicePorts>`	`IModule.getAudioPorts`
`IDevice.getAudioPort` `IDevice.setConnectedState`	`IModule.getAudioPort` `IModule.connectExternalDevice` `IModule.disconnectExternalDevice`
`IStream.getSupportedProfiles`	`IModule.connectExternalDevice`
<`routes`>	`IModule.getAudioRoutes`
`IDevice.createAudioPatch` `IDevice.updateAudioPatch` `IDevice.releaseAudioPatch` `IStream.getDevices` `IStream.setDevices` مواصفات الجهاز في `IDevice.openInputStream` `IDevice.openOutputStream`	`IModule.setAudioPatch` `IModule.setAudioPortConfig` `IModule.resetAudioPatch`

إعدادات منفذ الصوت وعمليات البث

طرق واجهة HIDL API	طرق واجهة برمجة التطبيقات AIDL
`IStream.getAudioProperties` `IStream.setAudioProperties` `IStreamIn.getAudioSource`	`IModule.getAudioPortConfigs` `IModule.setAudioPortConfig`
`IDevice.openInputStream` `IDevice.openOutputStream` `IStreamIn.prepareForReading` `IStreamOut.prepareForWriting` `IStream.createMmapBuffer`	`IModule.openInputStream` `IModule.openOutputStream`
`IStream.close`	`IStreamCommon.close`
`IStreamIn.updateSinkMetadata` `IStreamOut.updateSourceMetadata`	`IStreamIn.updateMetadata` `IStreamOut.updateMetadata`
`IStream.standby`	`StreamDescriptor.Command.standby`
`IStream.pause` `IStream.resume` `IStream.start` `IStream.stop`	`StreamDescriptor.Command.pause` `.start` `.start` `.drain`
`IStreamOut.drain` `IStreamOut.flush`	`StreamDescriptor.Command.drain` `.flush`
`IStreamOut.setCallback` `IStreamOut.clearCallback`	`IModule.openOutputStream` `IStreamCommon.close`
`IStreamOut.getPresentationPosition` و`IStreamIn.getCapturePosition` `IStreamOut.getLatency` `IStream.getMmapPosition` `IStreamIn.getInputFramesLost`	`StreamDescriptor.Reply.observable` `StreamDescriptor.Reply.latencyMs` `StreamDescriptor.Reply.hardware` `StreamDescriptor.Reply.xrunFrames`
`IDevice.getInputBufferSize` `IStreamOut.getLatency` `IStream.getBufferSize` `IStream.getFrameSize` `IStream.getFrameCount`	إنّ `IModule.setAudioPatch` ووقت الاستجابة الاسمي والحد الأدنى لحجم التخزين المؤقت هي جزء من بنية `AudioPatch` التي يعرضها HAL. يشكّل حجم المخزن المؤقت الفعلي بالإطارات جزءًا من بنية `StreamDescriptor` ، بالإضافة إلى حجم الإطار بالبايت. يمكن حساب حجم المخزن المؤقت بالكيلوبايت عن طريق ضرب هذين الرقمين.

ربط التأثيرات الصوتية

طرق واجهة HIDL API	طرق واجهة برمجة التطبيقات AIDL
`IDevice.addDeviceEffect` `IDevice.removeDeviceEffect`	`IModule.addDeviceEffect` `IModule.removeDeviceEffect`
`IStream.addEffect` `IStream.removeEffect`	`IStreamCommon.addEffect` `IStreamCommon.removeEffect`

الإعدادات على مستوى النظام

يجب تقديم الإعدادات على مستوى النظام التي تم تحديدها سابقًا في ملفات إعدادات XML الخاصة بسياسة الصوت (أي audio_policy_configuration.xml و audio_policy_engine_configuration.xml) من خلال IConfig. ومع ذلك، لتسهيل عملية الانتقال إلى AIDL، لا يزال بإمكان المورّدين استخدام ملفات XML نفسها التي استخدموها سابقًا لضبط الإعدادات على مستوى النظام. يحتوي التطبيق المرجعي لـ IConfig على الرمز البرمجي اللازم لتمثيل المعلومات من ملف XML باستخدام أنواع بيانات AIDL، ما يسهّل التحويل من XML إلى AIDL.

عناصر ملف إعداد HIDL	طرق واجهة برمجة التطبيقات AIDL
`<globalConfiguration>` ~~`<speaker_drc_enabled>`~~¹ `<call_screen_mode_supported>` `<engine_library>`	تم تقسيمها إلى طريقتَين مختلفتَين: `ITelephony.getSupportedAudioModes` `IConfig.getEngineConfig`
`<volumes>` أو `<volumeGroups>`، `<ProductStrategies>`	`IConfig.getEngineConfig`
`<surroundSound>`	`IConfig.getSurroundSoundConfig`

تتم إزالة speaker_drc_enabled من ملف الضبط لأنّه لا يتم استخدام عنصر الضبط هذا داخل النظام. يجب أن تكون ميزة DRC مفعّلة على جميع الأجهزة. <ahref="#fnref1" rev="footnote"> </ahref="#fnref1">

الوظائف ذات الصلة بالميزات

طرق واجهة HIDL API	واجهة برمجة التطبيقات AIDL
`IDevice.setMasterVolume` `IDevice.getMasterVolume` `IDevice.setMicMute` `IDevice.getMicMute` `IDevice.setMasterMute` `IDevice.getMasterMute`	`IModule.\*`
`IPrimaryDevice.getTtyMode` `IPrimaryDevice.setTtyMode` `IPrimaryDevice.getHacEnabled` `IPrimaryDevice.setHacEnabled` `IPrimaryDevice.setVoiceVolume`	`ITelephony.TelecomConfig.\*`
`IPrimaryDevice.setBtScoHeadsetDebugName` `IPrimaryDevice.getBtScoNrecEnabled` `IPrimaryDevice.setBtScoNrecEnabled` `IPrimaryDevice.getBtScoWidebandEnabled` `IPrimaryDevice.setBtScoWidebandEnabled,` `IPrimaryDevice.getBtHfpEnabled` `IPrimaryDevice.setBtHfpEnabled` `IPrimaryDevice.setBtHfpSampleRate` `IPrimaryDevice.setBtHfpVolume`	`IBluetooth.ScoConfig.\` `IBluetooth.HfpConfig.\`
`IPrimaryDevice.setMode` `IPrimaryDevice.updateRotation`	`ITelephony.switchAudioMode` `IModule.updateAudioMode` `IModule.updateScreenRotation`
`IDevice.setScreenState` `IDevice.getMicrophones`	`IModule.updateScreenState` `IModule.getMicrophones`
`IDevice.getHwAvSync` `IStream.setHwAvSync`	`IModule.generateHwAvSyncId` `IStreamCommon.updateHwAvSyncId`
`IStreamIn.setGain` `IStreamIn.setMicrophoneDirection` `IStreamIn.setMicrophoneFieldDimension`	`IStreamIn.setHwGain` `IStreamIn.setMicrophoneDirection` `IStreamIn.setMicrophoneFieldDimension`
`IStreamOut.getDualMonoMode` `IStreamOut.setDualMonoMode` `IStreamOut.getPlaybackRateParameters` `IStreamOut.setPlaybackRateParameters` `IStreamOut.selectPresentation` `IStreamOut.getAudioDescriptionMixLevel` `IStreamOut.setAudioDescriptionMixLevel` `IStreamOut.setLatencyMode` `IStreamOut.getRecommendedLatencyModes`	`IStreamOut.\*`
`IStreamOut.setEventCallback` `IStreamOut.setLatencyModeCallback`	`IModule.openOutputStream` (يتم دمج عمليات معاودة الاتصال في `IStreamOutEventCallback`)
`IDevice.get/setParameters` `IStream.get/setParameters`	`IModule.get/setVendorParameters` `IStreamCommon.get/setVendorParameters`

الطرق القديمة

طرق واجهة HIDL API	التعليقات
`IDevice.initCheck` `IDevice.close`	لا تنشر وحدة HAL نفسها باستخدام `ServiceManager` إلا عند اكتمال عملية الإعداد بنجاح. وفي هذه المرحلة، تصبح المراجعة نهائية ولا يمكن إغلاقها.
`IDevice.supportsAudioPatches` `IStreamOut.supportsPauseAndResume` `IStreamOut.supportsDrain`	يجب أن تتوفّر إمكانية استخدام الرموز البرمجية الإضافية وإيقاف البث مؤقتًا واستئنافه وإيقاف الجهاز نهائيًا.
`IStreamOut.getRenderPosition` `IStreamOut.getNextWriteTimestamp`	قديم

إضافات المورّدين

في HIDL API، يتم تنفيذ إضافات المورّدين باستخدام الطريقتَين getParameters أو setParameters من واجهات IDevice وIStream. تقبل هذه methods سلاسل عشوائية. في واجهة برمجة التطبيقات AIDL، تتوفّر طُرق مقابلة، مثل getVendorParameters أو setVendorParameters، التي تأخذ نُسخًا عشوائية من Parcelable باستخدام التضمين ضمن ParcelableHolders.

تغييرات أخرى

في ما يلي التغييرات العامة الأخرى:

لتحسين إمكانية اختبار واجهات برمجة التطبيقات HAL، في إصدار AIDL، لدينا خيارات تصحيح الأخطاء التي تستخدمها اختبارات VTS والتي تتوفّر من خلال ModuleDebug parcelable. تُوجّه هذه الخيارات HAL إلى تقليد وظائف معيّنة (مثل توصيل الأجهزة الخارجية)، والتي تتطلّب في غيرها تدخلًا يدويًا واستخدام معدات اختبار خارجية.
يجب إعادة تشغيل خدمات HAL عند ضبط قيمة سمة النظام sys.audio.restart.hal على 1. تتم إعادة التشغيل من خلال audioserver.rc. أثناء تنفيذ HAL، استخدِم اسم خدمة HAL المناسب المدرَج فيملف audioserver.rc. في Android 14، تمت إضافة الاسم vendor.audio-hal-aidl خصيصًا لإصدار AIDL من HAL.

HAL للتأثيرات

تقع جميع واجهات HIDL ضمن حزمة android.hardware.audio.effect@N.M* ، حيث يشير N.M إلى الإصدار Major.Minor. تقع جميع واجهات AIDL ضمن حزمة android.hardware.audio.effect.

واجهات HIDL API وملفات الإعداد	واجهات برمجة التطبيقات AIDL
`IEffectsFactory`	`IFactory`
`IEffect`	`IEffect`
`audio_effects.xml`	`IEffect`

Effect Factory

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات واجهة برمجة التطبيقات AIDL (android.hardware.audio.effect)
`IEffectsFactory.getAllDescriptors`	`IFactory.queryEffects` مع مَعلمة UUID فارغة
`IEffectsFactory.getDescriptor`	`IFactory.queryEffects` باستخدام مَعلمة UUID
`IEffectsFactory.createEffect`	`IFactory.createEffect`
`audio_effects.xml`	`IFactory.queryProcessing` `IFactory.queryEffects`

واجهات التأثيرات

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات واجهة برمجة التطبيقات AIDL (android.hardware.audio.effect)
`IEffect.init`	`IEffect.open`
`IEffect.setConfig`	`IEffect.setParameter`
`IEffect.enable`	`IEffect.command(CommandId::START)`
`IEffect.disable`	`IEffect.command(CommandId::STOP)`
`IEffect.reset`	`IEffect.command(CommandId::RESET)`
`IEffect.getDescriptor`	`IEffect.getDescriptor`
`IEffect.command`	يمكنك الربط بـ `IEffect.command` أو `IEffect.setParameter` أو `IEffect.getParameter` استنادًا إلى نوع طلب HIDL القديم.
لا ينطبق	`IEffect.getState`
`IEffect.setParameter`	`IEffect.setParameter`
`IEffect.getParameter`	`IEffect.getParameter`

أوامر التأثير

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات برمجة تطبيقات AIDL (android.hardware.audio.effect)
`EFFECT_CMD_INIT`	`IEffect.open`
`EFFECT_CMD_RESET`	`CommandId.RESET`
`EFFECT_CMD_ENABLE`	`IEffect.command(CommandId::START)`
`EFFECT_CMD_DISABLE`	`IEffect.command(CommandId::STOP)`
`EFFECT_CMD_SET_PARAM_DEFERRED`	تم إيقافه نهائيًا في Effects AIDL HAL
`EFFECT_CMD_SET_PARAM_COMMIT`	تم إيقافه نهائيًا في Effects AIDL HAL
`EFFECT_CMD_SET_CONFIG` `EFFECT_CMD_SET_PARAM` `EFFECT_CMD_SET_DEVICE` `EFFECT_CMD_SET_VOLUME` `EFFECT_CMD_SET_AUDIO_MODE` `EFFECT_CMD_SET_CONFIG_REVERSE` `EFFECT_CMD_SET_INPUT_DEVICE` `EFFECT_CMD_SET_FEATURE_CONFIG` `EFFECT_CMD_SET_AUDIO_SOURCE`	`IEffect.setParameter`
`EFFECT_CMD_GET_PARAM` `EFFECT_CMD_GET_CONFIG` `EFFECT_CMD_GET_CONFIG_REVERSE` `EFFECT_CMD_GET_FEATURE_SUPPORTED_CONFIGS` `EFFECT_CMD_GET_FEATURE_CONFIG` `VISUALIZER_CMD_MEASURE` `EFFECT_CMD_FIRST_PROPRIETARY` (يشبه `VISUALIZER_CMD_CAPTURE`)	`IEffect.getParameter`
`EFFECT_CMD_OFFLOAD`	متوقّف نهائيًا في AIDL، يتم التعامل مع عمليات التبديل بين وضعَي "التخليص من الموارد" و"عدم التخليص من الموارد" في إطار العمل.
`EFFECT_CMD_DUMP`	تتم معالجتها من خلال معاملة الربط المضمّنة `AIBinder_dump`.

تعريف مَعلمات التأثير الشائعة

تعريف HIDL‏ (android.hardware.audio.effect@X.X)	تعريف لغة تعريف واجهة نظام Android ‏(AIDL)
`Types.hal`	`Flags.aidl` `Parameter.aidl`

تعريف التأثيرات المحدّدة

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات واجهة برمجة التطبيقات AIDL (android.hardware.audio.effect)
`I$EffectType$.hal`	`$EffectType$.aidl`