裝置類型限制

在 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)，檢查所有指定的音訊裝置類型是否為相同類型。

實作

原始設備製造商需要從音訊 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 檔案中找到。