裝置類型限制

在 Android 音訊中，audio_devices_t 用於代表音訊裝置類型。它廣泛用於音訊原始碼做為位元欄位，可篩選或選取一或多部指定裝置。在 Android 11 之前，最多只能有 30 種音訊輸入/輸出裝置類型，且沒有可新增音訊裝置類型的備用運算單元。我們已移除音訊裝置類型數量的限制，以便新增音訊裝置類型。

為移除音訊裝置類型數量的限制，音訊裝置類型現在是枚舉值，而非位元遮罩。

所有現有的音訊裝置類型都會維持不變。AUDIO_DEVICE_BIT_IN 仍會用於區分輸入或輸出裝置。新增音訊裝置類型時，會在現有值之間的空隙中列舉值。

OEM 不應將 audio_devices_t 用於位元遮罩，因為這可能會在新增枚舉音訊裝置類型時導致意外結果。

範例和來源

在 Android 11 之前，音訊裝置類型做為位元遮罩的兩種常見用途如下：

  • 使用 audio_devices_t 值代表多個音訊裝置。
  • 檢查 audio_devices_t 值是否包含特定類別的音訊裝置類型。

為了代表多種音訊裝置類型，我們使用 /libaudiofoundation/include/media/AudioContainers.h 中的 DeviceTypeSet 類別，這是 audio_devices_t 的 std::set 容器。這個類別會在供應商提供的 libaudiofoundation 程式庫中宣告。如要在 C 程式碼中表示多個音訊裝置類型，您可以使用陣列或 audio_devices_t 清單。

如要檢查單一裝置類型是否屬於特定類別，請在 /system/media/audio/include/system/audio.h 中使用輔助函式 audio_is_.*_device。如果有多個音訊裝置類型，請在 libaudiofoundation 中使用輔助函式。舉例來說，您可以使用 AudioContainers.h 中的 areAllOfSameDeviceType (DeviceTypeSet, std::function)，檢查所有指定的音訊裝置類型是否為相同類型。

實作

原始設備製造商 (OEM) 需要從音訊 HAL 實作中移除音訊裝置類型位元欄位表示法。

  1. 移除微欄位的所有裝置儲存空間。

    audio_devices_t 不應用於代表多種音訊裝置類型。請改用清單或向量。

  2. 停止使用位元運算來比較裝置類型。

    在 Android 11 之前，音訊裝置類型可以當做位元欄位使用。在這種情況下，通常會使用位元運算來比較裝置類型。新增枚舉音訊裝置類型時，位元運算可能會導致意外結果。請改用輔助函式。如果只有一種音訊裝置類型，請使用直接比較方式比較這兩個值。如要檢查音訊裝置類型是否屬於指定類別，請在 /system/media/audio/include/system/audio.h 中使用輔助函式。例如：audio_is_output_device(audio_devices_t device)

  3. 停止對音訊裝置類型群組使用預先定義的值。

    在 system/media/audio/include/system/audio-base-utils.h 中，針對音訊裝置類型的群組 (AUDIO_DEVICE_OUT_ALL) 有幾個預先定義的值。所有這些值都已保留，但可能會淘汰，因為在新增枚舉音訊裝置類型時，這些值將不正確。audio-base-utils.h 中定義了新的音訊裝置類型群組，這些群組是音訊裝置類型的陣列，例如 AUDIO_DEVICE_OUT_ALL_ARRAY。

  4. 請實作 create_audio_patch() 和 release_audio_patch() 方法來進行路由，而非 set_parameters。

    set_parameters 方法會將音訊裝置類型用作位元欄位，因此如果新增列舉的音訊裝置類型，可能會出現意外結果。

    目前需要兩種音訊修補程式：

    • 用於播放的裝置修補程式
    • 用於錄製的混音裝置

    在後續的更新中，裝置可能需要額外的修補程式。

    建立音訊修補程式時，如未指定修補程式控點，則需要音訊 HAL 可產生用於識別音訊修補程式的專屬修補程式控制代碼。否則，音訊 HAL 應使用指定的音訊修補程式句柄來更新音訊修補程式。

    如果使用舊版音訊 HAL 和 Android 開放原始碼計畫 HIDL 包裝函式，舊版音訊 HAL 應將主要 HAL 版本設為 3.0。

    如要啟用音訊修補功能，音訊 HAL 應將主要 HAL 版本設為 3.0 以上版本。詳情請參閱 預設 HIDL 實作項目中的 Device::supportsAudioPatches()，也可以查看 Cuttlefish 的音訊 HAL。

自訂

您無法關閉這項功能，也無法在架構中還原音訊裝置重構，因此無法新增音訊裝置類型。

新增的所有音訊裝置類型都允許使用單一位元組合來代表裝置類型，因此目前的 HAL 實作方式仍可正常運作。

如果新增了音訊裝置類型，且原始設備製造商 (OEM) 想使用這些類型，就必須升級音訊 HAL 實作方式，並改用 HIDL 6.0 以上版本。您必須將主要 HAL 版本升級至 3.0，並實作 create_audio_patch 和 release_audio_patch 方法，因為在新增音訊裝置類型時，使用 set_parameters 來路由串流可能會導致非預期的結果。

驗證

原始設備製造商 (OEM) 需要更新 HAL 實作項目。您可以使用音訊 HAL 的 VTS，驗證實作是否正常運作。您可以在 VTS 檔案中找到所有測試。