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

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

مقارنة بين AIDL وHIDL Audio HAL

بدءًا من Android 14، ننصح الشركاء ومورّدي شرائح النظام على الرقاقة (SoC) باستبدال عملية التنفيذ الحالية لطبقة تجريد الأجهزة (HAL) المستندة إلى لغة تعريف واجهة HIDL بعملية تنفيذ لطبقة تجريد الأجهزة (HAL) المستندة إلى لغة تعريف واجهة AIDL.

لتسهيل الانتقال السلس من HIDL Audio HAL إلى AIDL Audio HAL، تم توضيح بعض الاختلافات الرئيسية في هذه الصفحة. تعرض هذه الصفحة أيضًا عملية الربط بين واجهات AIDL وHIDL الخاصة بطبقة تجريد الأجهزة (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.
يحلّ AIDL Audio HAL محل IPrimaryDevice. يرسل إطار العمل تحديثات حول وضع الصوت الحالي وتدوير الشاشة إلى كل مثيل من IModule. تتعامل واجهة IBluetooth مخصّصة مع المَعلمات ذات الصلة بالاتصال المتزامن الموجّه عبر البلوتوث (BT SCO) وملف "بدون لمس الجهاز" (HFP). توفّر واجهة ITelephony مخصّصة عناصر تحكّم خاصة بالاتصالات الهاتفية. يمكنك استرداد مثيلات كلتا الواجهتين من المثيل الأساسي لواجهة IModule. لمزيد من المعلومات، راجِع جداول المقارنة في Core HAL والوظائف ذات الصلة بالميزات.
تتم إزالة IDevicesFactory في AIDL Audio HAL لتجنُّب التكرار. يتم الآن تسجيل وحدات HAL (أي مثيلات واجهة IModule) مباشرةً في "مدير الخدمات" باستخدام أسماء مثيلات الوحدات، مثل bluetooth أو r_submix. الاستثناء الوحيد هو الوحدة primary التي يتم تسجيلها ضمن اسم المثيل default.

ربط واجهات AIDL وHIDL Audio HAL

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

Core HAL

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

واجهات برمجة التطبيقات وملفات الإعداد في HIDL	واجهات AIDL API
`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 وعناصر ملفات الإعداد	طُرق واجهة برمجة التطبيقات 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	طُرق واجهة برمجة التطبيقات 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`	`StreamDescriptor.Command.pause` `.start`
‫`IStream.start` `IStream.stop` (ساحات مشاركات MMAP)	‫`StreamDescriptor.Command.start` أو `.burst` `.pause` (الإدخال) و/أو `.flush` (الإخراج)
`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	طُرق واجهة برمجة التطبيقات 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 من ملف الإعدادات لأنّ عنصر الإعدادات هذا غير مستخدَم في النظام. يجب تفعيل ميزة "التحكّم الديناميكي في النطاق" على جميع الأجهزة. <ahref="#fnref1" rev="footnote"> </ahref="#fnref1">

الوظائف المتعلّقة بالميزة

طُرق واجهة برمجة التطبيقات HIDL	واجهة برمجة تطبيقات 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	التعليقات
`IDevice.initCheck` `IDevice.close`	ينشر وحدة HAL نفسها باستخدام `ServiceManager` فقط عند اكتمال عملية التهيئة بنجاح. في هذه الحالة، يُعتبر الحساب مغلقًا نهائيًا ولا يمكن إعادة فتحه.
`IDevice.supportsAudioPatches` `IStreamOut.supportsPauseAndResume` `IStreamOut.supportsDrain`	يجب توفير إمكانية تطبيق التصحيحات والإيقاف المؤقت والاستئناف والتفريغ.
`IStreamOut.getRenderPosition` `IStreamOut.getNextWriteTimestamp`	قديم

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

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

تغييرات أخرى

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

لتحسين قابلية اختبار واجهات برمجة تطبيقات HAL، نقدّم في إصدار AIDL خيارات تصحيح الأخطاء التي تستخدمها اختبارات VTS وتتوفّر من خلال النوع ModuleDebug القابل للتسلسل. توجّه هذه الخيارات طبقة HAL لمحاكاة وظائف معيّنة (مثل توصيل الأجهزة الخارجية)، والتي تتطلّب عادةً تدخّلاً يدويًا واستخدام معدّات اختبار خارجية.
عندما يضبط إطار العمل أو مجموعات اختبار VTS السمة sys.audio.restart.hal للنظام على 1، يجب إعادة تشغيل خدمات HAL. يتولّى الملف audioserver.rc عملية إعادة التشغيل. أثناء تنفيذ طبقة تجريد الأجهزة (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	واجهات AIDL API
`IEffectsFactory`	`IFactory`
`IEffect`	`IEffect`
`audio_effects.xml`	`IEffect`

Effect Factory

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

واجهات المؤثرات

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات AIDL API (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 API (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`	يتم التعامل معها من خلال معاملة binder المضمّنة `AIBinder_dump`.

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

تعريف HIDL (android.hardware.audio.effect@X.X)	تعريف AIDL
`Types.hal`	`Flags.aidl` `Parameter.aidl`

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

واجهات HIDL API (android.hardware.audio.effect@X.X)	واجهات AIDL API (android.hardware.audio.effect)
`I$EffectType$.hal`	`$EffectType$.aidl`