इस पेज का अनुवाद Cloud Translation API से किया गया है.

एआईडीएल और HIDL ऑडियो एचएएल की तुलना

हमारा सुझाव है कि पार्टनर और SoC वेंडर, Android 14 से शुरू होने वाले वर्शन में, मौजूदा HIDL HAL को AIDL HAL से बदलें.

HIDL Audio HAL से AIDL Audio HAL पर आसानी से ट्रांज़िशन करने के लिए, इस पेज पर कुछ मुख्य अंतर हाइलाइट किए गए हैं. इस पेज पर, ऑडियो एचएएल के लिए AIDL और HIDL इंटरफ़ेस के बीच की मैपिंग भी दिखती है.

AIDL और HIDL Audio HAL को लागू करने में अंतर

HIDL स्ट्रक्चर और AIDL स्ट्रक्चर के बीच ये मुख्य अंतर हैं:

एआईडीएल ऑडियो कोर एचएएल में, एचआईडीएल एचएएल की एक्सएमएल फ़ाइलों में, पूरे सिस्टम के पैरामीटर की जगह IConfig इंटरफ़ेस लाया गया है. फ़्रेमवर्क, वेंडर कॉन्फ़िगरेशन फ़ाइल के बजाय, कोर एचएएल से ये पैरामीटर पढ़ता है. उदाहरण के लिए, उपयोगकर्ता को कंट्रोल करने के लिए, Core HAL में IConfig.getSurroundSoundConfig वाले तरीके से, सराउंड साउंड फ़ॉर्मैट की सूची दिखाई जाती है.

AIDL Audio Effects HAL में, HIDL Effects HAL की एक्सएमएल फ़ाइलों में तय किया गया effectProxy लॉजिक, ऑडियो फ़्रेमवर्क में ले जाया जाता है. ऑडियो फ़्रेमवर्क, IFactory.queryEffects का इस्तेमाल करके सिस्टम में मौजूद सभी इफ़ेक्ट इंस्टेंस और IFactory.queryProcessing का इस्तेमाल करके सभी इफ़ेक्ट प्रोसेसिंग के बारे में क्वेरी करता है.
ऑडियो डिवाइस टाइप के लिए डिवाइस शब्द के इस्तेमाल से होने वाली गड़बड़ी से बचने के लिए, HIDL Audio HAL में IDevice का नाम बदलकर AIDL Audio HAL में IModule कर दिया गया है.
IPrimaryDevice को AIDL Audio HAL में बदल दिया गया है. मौजूदा ऑडियो मोड और स्क्रीन रोटेशन के बारे में अपडेट, हर IModule इंस्टेंस को भेजे जाते हैं. ब्लूटूथ सिंक्रोनस कनेक्शन ओरिएंटेड (बीटी एससीओ) और बोलकर इस्तेमाल करने की सुविधा वाली प्रोफ़ाइल (एचएफ़पी) से जुड़े पैरामीटर, एक खास IBluetooth इंटरफ़ेस से मैनेज किए जाते हैं. खास ITelephony इंटरफ़ेस, टेलीफ़ोन से जुड़े कंट्रोल उपलब्ध कराता है. इन दोनों इंटरफ़ेस के इंस्टेंस, IModule इंटरफ़ेस के मुख्य इंस्टेंस से वापस पाए जा सकते हैं. ज़्यादा जानकारी के लिए, मुख्य एचएएल और सुविधा से जुड़े फ़ंक्शन की तुलना करने वाली टेबल देखें.
IDevicesFactory को AIDL Audio HAL से हटा दिया गया है, ताकि कोई काम दोबारा न हो. HAL मॉड्यूल (यानी, IModule इंटरफ़ेस इंस्टेंस) अब सीधे सेवा मैनेजर के साथ रजिस्टर किए जाते हैं. इसके लिए, इंस्टेंस के नाम के तौर पर उनके नाम का इस्तेमाल किया जाता है, जैसे कि bluetooth या r_submix. सिर्फ़ primary मॉड्यूल अपवाद है, जो इंस्टेंस नाम default के तहत रजिस्टर होता है.

एआईडीएल और HIDL ऑडियो एचएएल मैपिंग

नीचे दिए गए सेक्शन में दी गई टेबल में, HIDL और AIDL ऑडियो HAL इंटरफ़ेस के बीच की मैपिंग दिखाई गई है. डायरेक्ट्री के स्ट्रक्चर के बारे में ज़्यादा जानकारी के लिए, Audio HAL की README फ़ाइल देखें.

कोर एचएएल

सभी HIDL इंटरफ़ेस, android.hardware.audio@N.M पैकेज में होते हैं. यहां N.M से Major.Minor वर्शन का पता चलता है. सभी AIDL इंटरफ़ेस, android.hardware.audio.core पैकेज में मौजूद होते हैं.

HIDL API इंटरफ़ेस और कॉन्फ़िगरेशन फ़ाइलें	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`
कॉन्फ़िगर की जा सकने वाली ऑडियो नीति की फ़ाइलें	Android 14 के लिए HIDL लागू करें.

ऑडियो पोर्ट, डाइनैमिक प्रोफ़ाइल, रूट, और पैच

इस टेबल में, एक्सएमएल फ़ाइलों के एलिमेंट को ऐंगल ब्रैकेट का इस्तेमाल करके दिखाया गया है.

HIDL API इंटरफ़ेस के तरीके और कॉन्फ़िगरेशन फ़ाइल के एलिमेंट	AIDL API इंटरफ़ेस के तरीके
`<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 API इंटरफ़ेस के तरीके
`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` स्ट्रक्चर का हिस्सा हैं. फ़्रेम में असल बफ़र साइज़, `StreamDescriptor` स्ट्रक्चर का हिस्सा होता है. साथ ही, फ़्रेम साइज़ बाइट में भी होता है. बाइट में बफ़र साइज़ का हिसाब लगाने के लिए, इन दोनों संख्याओं को गुणा करें.

ऑडियो इफ़ेक्ट से जुड़ा कनेक्शन

HIDL API इंटरफ़ेस के तरीके	AIDL API इंटरफ़ेस के तरीके
`IDevice.addDeviceEffect` `IDevice.removeDeviceEffect`	`IModule.addDeviceEffect` `IModule.removeDeviceEffect`
`IStream.addEffect` `IStream.removeEffect`	`IStreamCommon.addEffect` `IStreamCommon.removeEffect`

पूरे सिस्टम का कॉन्फ़िगरेशन

सिस्टम-वाइड कॉन्फ़िगरेशन, IConfig के ज़रिए दिया जाना चाहिए. इसे पहले ऑडियो नीति की एक्सएमएल कॉन्फ़िगरेशन फ़ाइलों (जैसे, audio_policy_configuration.xml और audio_policy_engine_configuration.xml) में तय किया गया था. हालांकि, एआईडीएल पर आसानी से ट्रांज़िशन करने के लिए, वेंडर के पास अब भी उन एक्सएमएल फ़ाइलों का इस्तेमाल करने का विकल्प है जिनका इस्तेमाल उन्होंने पहले सिस्टम-वाइड कॉन्फ़िगरेशन सेट करने के लिए किया था. IConfig को लागू करने के रेफ़रंस में, वह कोड शामिल होता है जो एआईडीएल डेटा टाइप का इस्तेमाल करके, एक्सएमएल फ़ाइल से जानकारी दिखाने के लिए ज़रूरी है. इससे, एक्सएमएल से एआईडीएल में बदलाव करने की सुविधा मिलती है.

HIDL कॉन्फ़िगरेशन फ़ाइल के एलिमेंट	AIDL API इंटरफ़ेस के तरीके
`<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 API इंटरफ़ेस के तरीके	AIDL API इंटरफ़ेस
`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 में, वेंडर एक्सटेंशन को IDevice और IStream इंटरफ़ेस के getParameters या setParameters तरीकों का इस्तेमाल करके लागू किया जाता है. ये तरीक़े, मनमुताबिक स्ट्रिंग स्वीकार करते हैं. AIDL API में, getVendorParameters या setVendorParameters जैसे मिलते-जुलते तरीके हैं. ये ParcelableHolders में एन्कैप्सलेशन का इस्तेमाल करके, मनमुताबिक Parcelable इंस्टेंस लेते हैं.

अन्य बदलाव

अन्य सामान्य बदलावों के बारे में यहां बताया गया है:

एचएएल एपीआई की जांच करने की सुविधा को बेहतर बनाने के लिए, हमने एआईडीएल वर्शन में डीबग करने के विकल्प जोड़े हैं. इनका इस्तेमाल, वीटीएस टेस्ट में किया जाता है. ये विकल्प, ModuleDebug parcelable के ज़रिए उपलब्ध होते हैं. ये विकल्प, एचएएल को कुछ फ़ंक्शन (उदाहरण के लिए, बाहरी डिवाइसों को कनेक्ट करना) को एमुलेट करने का निर्देश देते हैं. इन फ़ंक्शन को एमुलेट करने के लिए, मैन्युअल तरीके से काम करना पड़ता है और बाहरी टेस्टिंग डिवाइसों का इस्तेमाल करना पड़ता है.
सिस्टम प्रॉपर्टी sys.audio.restart.hal की वैल्यू को 1 पर सेट करने पर, एचएएल की सेवाओं को रीस्टार्ट करना ज़रूरी है. रीस्टार्ट करने के लिए, audioserver.rc का इस्तेमाल किया जाता है. एचएएल को लागू करते समय, audioserver.rc फ़ाइल में दी गई एचएएल सेवा के सही नाम का इस्तेमाल करें. Android 14 में, नाम vendor.audio-hal-aidl को खास तौर पर एचएएल के एआईडीएल वर्शन के लिए जोड़ा गया है.

इफ़ेक्ट एचएएल

सभी HIDL इंटरफ़ेस, android.hardware.audio.effect@N.M* पैकेज में होते हैं. यहां N.M, Major.Minor वर्शन है. सभी AIDL इंटरफ़ेस, android.hardware.audio.effect पैकेज में होते हैं.

HIDL API इंटरफ़ेस और कॉन्फ़िगरेशन फ़ाइलें	AIDL API इंटरफ़ेस
`IEffectsFactory`	`IFactory`
`IEffect`	`IEffect`
`audio_effects.xml`	`IEffect`

इफ़ेक्ट फ़ैक्ट्री

HIDL API इंटरफ़ेस (android.hardware.audio.effect@X.X)	AIDL API इंटरफ़ेस (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 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`	लेगसी HIDL कमांड के टाइप के आधार पर, `IEffect.command`, `IEffect.setParameter` या `IEffect.getParameter` पर मैप करें
लागू नहीं	`IEffect.getState`
`IEffect.setParameter`	`IEffect.setParameter`
`IEffect.getParameter`	`IEffect.getParameter`

इफ़ेक्ट से जुड़े निर्देश

HIDL एपीआई इंटरफ़ेस (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`	इफ़ेक्ट एआईडीएल एचएएल में अब काम नहीं करता
`EFFECT_CMD_SET_PARAM_COMMIT`	इफ़ेक्ट एआईडीएल एचएएल में अब काम नहीं करता
`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`	अब काम नहीं करता. एआईडीएल में, ऑफ़लोड और नॉन-ऑफ़लोड मोड स्विच को फ़्रेमवर्क में मैनेज किया जाता है.
`EFFECT_CMD_DUMP`	इसे पहले से मौजूद बाइंडर ट्रांज़ैक्शन `AIBinder_dump` मैनेज करता है.

इफ़ेक्ट के सामान्य पैरामीटर की परिभाषा

HIDL की परिभाषा (android.hardware.audio.effect@X.X)	एआईडीएल की परिभाषा
`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`