So sánh lớp trừu tượng phần cứng (HAL) cho âm thanh HIDL và AIDL

Kể từ Android 14, các đối tác và nhà cung cấp SoC nên thay thế việc triển khai HAL HIDL hiện tại bằng việc triển khai HAL AIDL.

Để tạo điều kiện chuyển đổi suôn sẻ từ HIDL Audio HAL sang AIDL Audio HAL, một số điểm khác biệt chính được nêu bật trên trang này. Trang này cũng cho thấy cách ánh xạ giữa giao diện AIDL và HIDL của HAL âm thanh.

Sự khác biệt giữa cách triển khai AIDL và HIDL Audio HAL

Sau đây là những điểm khác biệt chính giữa cấu trúc HIDL và cấu trúc AIDL:

  • Trong AIDL Audio Core HAL, giao diện IConfig được giới thiệu để thay thế các tham số trên toàn hệ thống trong các tệp XML trong HIDL HAL. Khung này đọc các thông số này từ Core HAL thay vì tệp cấu hình của nhà cung cấp. Ví dụ: danh sách các định dạng âm thanh vòm hiển thị để người dùng kiểm soát được cung cấp bởi phương thức IConfig.getSurroundSoundConfig trong Core HAL.

    Trong AIDL Audio Effects HAL (HAL hiệu ứng âm thanh AIDL), logic effectProxy được xác định trong các tệp XML trong HIDL Effects HAL được chuyển sang khung âm thanh. Khung âm thanh truy vấn tất cả các thực thể hiệu ứng trong hệ thống bằng IFactory.queryEffects và tất cả các quá trình xử lý hiệu ứng bằng IFactory.queryProcessing.

  • Để tránh nhầm lẫn khi sử dụng thuật ngữ thiết bị cho các loại thiết bị âm thanh, IDevice trong HIDL Audio HAL được đổi tên thành IModule trong AIDL Audio HAL.

  • IPrimaryDevice được thay thế trong AIDL Audio HAL. Thông tin cập nhật về chế độ âm thanh và chế độ xoay màn hình hiện tại sẽ được gửi đến mọi thực thể IModule. Các tham số liên quan đến Cấu hình rảnh tay (HFP) và Cấu hình kết nối đồng bộ Bluetooth (BT SCO) được xử lý bằng giao diện IBluetooth chuyên dụng. Giao diện ITelephony chuyên dụng cung cấp các chế độ điều khiển dành riêng cho điện thoại. Bạn có thể truy xuất các thực thể của cả hai giao diện này từ thực thể chính của giao diện IModule. Hãy xem bảng so sánh về HAL lõi và Chức năng liên quan đến tính năng để biết thêm thông tin.

  • Xoá IDevicesFactory trong AIDL Audio HAL để tránh dư thừa. Các mô-đun HAL (tức là các thực thể giao diện IModule) hiện được đăng ký trực tiếp với Trình quản lý dịch vụ bằng cách sử dụng tên của các mô-đun này cho tên thực thể, chẳng hạn như bluetooth hoặc r_submix. Trường hợp ngoại lệ duy nhất là mô-đun primary đăng ký dưới tên thực thể default.

Ánh xạ AIDL và HIDL Audio HAL

Các bảng trong các phần sau đây cho thấy mối liên kết giữa giao diện HIDL và AIDL Audio HAL. Xem Tệp HAL README âm thanh để biết thêm thông tin về cấu trúc thư mục.

Core HAL

Tất cả giao diện HIDL đều nằm trong gói android.hardware.audio@N.M, trong đó N.M biểu thị phiên bản Major.Minor. Tất cả giao diện AIDL đều nằm trong gói android.hardware.audio.core.

Giao diện API HIDL và tệp cấu hình Giao diện API AIDL
IDevicesFactory Gói đăng ký IModule với ServiceManager.
IDevice IModule
IPrimaryDevice ITelephony
IBluetooth
IStream
IStreamIn
IStreamOut		 StreamDescriptor
IStreamIn
IStreamCommon
IStreamOut
audio_policy_configuration.xml
audio_policy_engine_configuration.xml		 IConfig
IModule
Tệp Chính sách âm thanh có thể định cấu hình Sử dụng phương thức triển khai HIDL cho Android 14.

Cổng âm thanh, hồ sơ động, tuyến và bản vá

Trong bảng này, các phần tử của tệp XML được chỉ định bằng dấu nhọn.

Các phương thức giao diện API HIDL và phần tử tệp cấu hình Phương thức giao diện 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
Thông số kỹ thuật của thiết bị trong IDevice.openInputStream
IDevice.openOutputStream		 IModule.setAudioPatch
IModule.setAudioPortConfig
IModule.resetAudioPatch

Cấu hình và luồng cổng âm thanh

Phương thức giao diện API HIDL Phương thức giao diện 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 và 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, độ trễ danh nghĩa và dung lượng bộ nhớ đệm tối thiểu đều là một phần của cấu trúc AudioPatch do HAL trả về. Dung lượng bộ nhớ đệm thực tế trong khung là một phần của cấu trúc StreamDescriptor, cùng với kích thước khung hình tính bằng byte. Bạn có thể tính dung lượng bộ nhớ đệm tính bằng byte bằng cách nhân hai số này với nhau.

Kết nối Audio Effects

Phương thức giao diện API HIDL Phương thức giao diện API AIDL
IDevice.addDeviceEffect
IDevice.removeDeviceEffect		 IModule.addDeviceEffect
IModule.removeDeviceEffect
IStream.addEffect
IStream.removeEffect		 IStreamCommon.addEffect
IStreamCommon.removeEffect

Cấu hình trên toàn hệ thống

Cấu hình trên toàn hệ thống từng được xác định trước đó trong các tệp cấu hình XML của chính sách âm thanh (cụ thể là audio_policy_configuration.xml và audio_policy_engine_configuration.xml) phải được cung cấp thông qua IConfig. Tuy nhiên, để dễ dàng chuyển đổi sang AIDL, nhà cung cấp vẫn có thể sử dụng chính các tệp XML mà họ từng dùng để thiết lập cấu hình trên toàn hệ thống. Quy trình triển khai tham chiếu cho IConfig chứa mã cần thiết để trình bày thông tin từ tệp XML bằng cách sử dụng các loại dữ liệu AIDL, hỗ trợ chuyển đổi từ XML sang AIDL.

Các phần tử tệp cấu hình HIDL Phương thức giao diện API AIDL
<globalConfiguration>
<speaker_drc_enabled>1

<call_screen_mode_supported>
<engine_library>		 Được tách thành hai phương thức khác nhau:
ITelephony.getSupportedAudioModes
IConfig.getEngineConfig
<volumes>, HOẶC
<volumeGroups>, <ProductStrategies> 		IConfig.getEngineConfig
<surroundSound> IConfig.getSurroundSoundConfig

  1. speaker_drc_enabled bị xoá khỏi tệp cấu hình vì mục cấu hình này không được sử dụng trong hệ thống. Tất cả thiết bị phải bật tính năng DRC. <ahref="#fnref1" rev="footnote"> </ahref="#fnref1">

Chức năng liên quan đến tính năng

Phương thức giao diện API HIDL Giao diện 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 (các lệnh gọi lại được kết hợp vào IStreamOutEventCallback)
IDevice.get/setParameters
IStream.get/setParameters		 IModule.get/setVendorParameters
IStreamCommon.get/setVendorParameters

Các phương thức không dùng nữa

Phương thức giao diện API HIDL Bình luận
IDevice.initCheck
IDevice.close		 Mô-đun HAL chỉ tự phát hành bằng ServiceManager khi khởi chạy thành công. Khi đó, tài khoản sẽ được coi là vĩnh viễn và không thể đóng.
IDevice.supportsAudioPatches
IStreamOut.supportsPauseAndResume
IStreamOut.supportsDrain		 Bạn bắt buộc phải hỗ trợ các bản vá, tạm dừng, tiếp tục và xả.
IStreamOut.getRenderPosition
IStreamOut.getNextWriteTimestamp		 Lỗi thời.

Tiện ích của nhà cung cấp

Trong API HIDL, các tiện ích của nhà cung cấp được triển khai bằng cách sử dụng phương thức getParameters hoặc setParameters từ giao diện IDevice và IStream. Các phương thức này chấp nhận chuỗi tuỳ ý. Trong API AIDL, có các phương thức tương ứng, chẳng hạn như getVendorParameters hoặc setVendorParameters, lấy các thực thể Parcelable tuỳ ý bằng cách sử dụng tính năng đóng gói trong ParcelableHolders.

Các thay đổi khác

Sau đây là các thay đổi chung khác:

  1. Để cải thiện khả năng kiểm thử của các API HAL, trong phiên bản AIDL, chúng tôi giới thiệu các tuỳ chọn gỡ lỗi mà các kiểm thử VTS sử dụng và có sẵn thông qua gói ModuleDebug. Các tuỳ chọn này hướng dẫn HAL mô phỏng một số chức năng nhất định (ví dụ: kết nối thiết bị bên ngoài), nếu không thì cần phải can thiệp thủ công và sử dụng thiết bị kiểm thử bên ngoài.

  2. Bạn phải khởi động lại các dịch vụ HAL khi giá trị của thuộc tính hệ thống sys.audio.restart.hal được đặt thành 1. Bạn có thể khởi động lại thông qua audioserver.rc. Trong khi triển khai HAL, hãy sử dụng tên dịch vụ HAL thích hợp được liệt kê trong tệp audioserver.rc. Trong Android 14, tên vendor.audio-hal-aidl được thêm riêng cho phiên bản AIDL của HAL.

HAL hiệu ứng

Tất cả giao diện HIDL đều nằm trong gói android.hardware.audio.effect@N.M*, trong đó N.M là phiên bản Major.Minor. Tất cả giao diện AIDL đều nằm trong gói android.hardware.audio.effect.

Giao diện HIDL API và tệp cấu hình Giao diện API AIDL
IEffectsFactory IFactory
IEffect IEffect
audio_effects.xml IEffect

Nhà máy hiệu ứng

Giao diện HIDL API
(android.hardware.audio.effect@X.X)		 Giao diện API AIDL
(android.hardware.audio.effect)
IEffectsFactory.getAllDescriptors IFactory.queryEffects có tham số mã nhận dạng duy nhất (UUID) rỗng
IEffectsFactory.getDescriptor IFactory.queryEffects có tham số UUID
IEffectsFactory.createEffect IFactory.createEffect
audio_effects.xml IFactory.queryProcessing
IFactory.queryEffects

Giao diện hiệu ứng

Giao diện API HIDL
(android.hardware.audio.effect@X.X)		 Giao diện API 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 Liên kết đến IEffect.command,
IEffect.setParameter hoặc
IEffect.getParameter dựa trên loại lệnh HIDL cũ
Không áp dụng IEffect.getState
IEffect.setParameter IEffect.setParameter
IEffect.getParameter IEffect.getParameter

Lệnh hiệu ứng

Giao diện API HIDL
(android.hardware.audio.effect@X.X)		 Giao diện API 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 Ngừng sử dụng trong HAL AIDL của hiệu ứng
EFFECT_CMD_SET_PARAM_COMMIT Ngừng sử dụng trong HAL AIDL của hiệu ứng
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
(tương tự như VISUALIZER_CMD_CAPTURE) 		IEffect.getParameter
EFFECT_CMD_OFFLOAD Không được dùng nữa.
Trong AIDL, các nút chuyển chế độ tải xuống và không tải xuống được xử lý trong khung.
EFFECT_CMD_DUMP Được xử lý bằng giao dịch liên kết tích hợp AIBinder_dump.

Định nghĩa thông số Hiệu ứng phổ biến

Định nghĩa HIDL
(android.hardware.audio.effect@X.X)		 Định nghĩa AIDL
Types.hal Flags.aidl
Parameter.aidl

Định nghĩa về Hiệu ứng cụ thể

Giao diện API HIDL
(android.hardware.audio.effect@X.X)		 Giao diện API AIDL
(android.hardware.audio.effect)
I$EffectType$.hal $EffectType$.aidl