Cihaz türü sınırı

Android sesinde, ses cihazı türünü belirtmek için audio_devices_t kullanılır. Bir veya daha fazla belirtilen cihazı filtrelemek ya da seçmek için ses kaynak kodunda bit alanı olarak yaygın şekilde kullanılır. Android 11'den önce 30 ses giriş/çıkış cihazı türü sınırı vardı ve yeni ses sistemi türleri eklemek için yedek yuva yoktu. Yeni ses sistemi türlerinin eklenmesine olanak tanımak için ses sistemi türlerinin sayısı üzerindeki sınırı kaldırdık.

Ses sistemi türlerinin sayısıyla ilgili sınırı kaldırmak için ses sistemi türleri artık bit maskeleri yerine numaralandırılmış değerler olarak kullanılıyor.

Mevcut tüm ses sistemi türleri olduğu gibi kalır. Giriş veya çıkış cihazlarını ayırt etmek için AUDIO_DEVICE_BIT_IN kullanılmaya devam eder. Yeni ses sistemi türleri eklenirken mevcut değerler arasındaki boşluklarda numaralandırılmış değerler kullanılır.

OEM'ler, yeni numaralandırılmış ses sistemi türleri eklendiğinde beklenmedik sonuçlara neden olabileceğinden audio_devices_t değerini bit maskesi olarak kullanmamalıdır.

Örnekler ve kaynak

Android 11'den önce, bit maskeleri olarak iki tipik ses sistemi türü kullanımı vardı.

  • Birden çok ses cihazını temsil etmek için audio_devices_t değerini kullanma.
  • audio_devices_t değerinin, belirtilen bir kategorideki ses sistemi türlerini içerip içermediğini kontrol etme.

Birden fazla ses sistemi türünü temsil etmek için DeviceTypeSet adlı bir sınıf kullanılır. Bu sınıf, /libaudiofoundation/include/media/AudioContainers.h içindeki std::set kapsayıcısıdır.audio_devices_t Sınıf, tedarikçi tarafından sunulan libaudiofoundation kitaplığında tanımlanmalıdır. C kodunda birden fazla ses cihazı türünü temsil etmek için bir dizi veya audio_devices_t listesi kullanılabilir.

Tek bir cihaz türünün belirtilen bir kategoride olup olmadığını kontrol etmek için /system/media/audio/include/system/audio.h içinde yardımcı işlevleri audio_is_.*_device kullanın. Birden fazla ses sistemi türü için libaudiofoundation içindeki yardımcı işlevleri kullanın. Örneğin, AudioContainers.h içinde areAllOfSameDeviceType (DeviceTypeSet, std::function) kullanarak belirtilen tüm ses sistemi türlerinin aynı türde olup olmadığını kontrol edin.

Uygulama

OEM'lerin, ses HAL uygulamasından ses sistemi türü bit alanı gösterimini kaldırması gerekir.

  1. Bit alanındaki cihazların tüm depolama alanını kaldırın.

    audio_devices_t, birden fazla ses sistemi türünü temsil etmek için kullanılmamalıdır. Bunun yerine liste veya vektör kullanın.

  2. Cihaz türü karşılaştırmaları için bit işlemlerini kullanmayı bırakın.

    Android 11'den önce ses sistemi türleri bit alanı olarak kullanılabilir. Bu durumda, cihaz türü karşılaştırmaları için bit işlemleri kullanmak yaygındır. Yeni, numaralandırılmış ses sistemi türleri eklendiğinde bit işlemleri beklenmedik sonuçlara neden olabilir. Bunun yerine yardımcı işlevleri kullanabilirsiniz. Tek bir ses sistemi türü varsa iki değeri karşılaştırmak için doğrudan karşılaştırma kullanın. Bir ses cihazı türünün belirtilen bir kategoride olup olmadığını kontrol etmek için /system/media/audio/include/system/audio.h yardımcı işlevlerini kullanın. Örneğin, audio_is_output_device(audio_devices_t device).

  3. Ses sistemi türü grupları için önceden tanımlanmış değerleri kullanmayı bırakın.

    Ses sistemi türü grupları için AUDIO_DEVICE_OUT_ALL, system/media/audio/include/system/audio-base-utils.h içinde önceden tanımlanmış bazı değerler vardır. Bu değerlerin tümü ayrılmıştır ancak yeni numaralandırılmış ses sistemi türleri eklendiğinde doğru olmayacakları için desteği sonlandırılabilir. audio-base-utils.h içinde tanımlanan yeni ses sistemi türü grupları vardır. Bunlar, AUDIO_DEVICE_OUT_ALL_ARRAY gibi ses sistemi türlerinin dizileridir.

  4. Yönlendirme için set_parameters yerine create_audio_patch() ve release_audio_patch() yöntemlerini uygulayın.

    set_parameters yöntemi, ses sistemi türlerini bit alanı olarak kullandığından yeni numaralandırılmış ses sistemi türleri eklenirse beklenmedik sonuçlar oluşabilir.

    Şu anda iki tür ses yaması gereklidir:

    • Oynatma için cihaz yamalarına karıştırma
    • Yama karıştırmak için kullanılan cihaz (kayıt için)

    Sonraki güncellemelerde cihazdan cihaza ek yamalar gerekebilir.

    Ses yaması oluştururken yama tutma yeri belirtilmezse ses yaması tanımlayabilen benzersiz bir yama tutma yeri oluşturmak için ses HAL'si gerekir. Aksi takdirde, ses HAL'si ses yamasını güncellemek için verilen ses yaması tutamacını kullanmalıdır.

    Eski bir ses HAL'si ve AOSP HIDL sarmalayıcısı kullanılıyorsa eski ses HAL'si, ana HAL sürümünü 3.0 olarak ayarlamalıdır.

    Ses yaması özelliğini etkinleştirmek için ses HAL'inin ana HAL sürümünü 3.0 veya daha yüksek bir sürüme ayarlaması gerekir. Daha fazla bilgi için varsayılan HIDL uygulaması bölümündeki Device::supportsAudioPatches() konusuna bakın. Bu bilgiler Cuttlefish için ses HAL'inde de bulunabilir.

Özelleştirme

Bu özelliği devre dışı bırakmak veya ses sistemi türlerinin eklenmesini sağlayan çerçevedeki ses sistemi yeniden düzenlemesini geri almak mümkün değildir.

Eklenen tüm ses sistemi türleri, tek bir bit kümesiyle cihaz türünü temsil etmeye olanak tanır. Bu nedenle, mevcut HAL uygulamaları çalışmaya devam eder.

Yeni ses sistemi türleri eklenirse ve OEM'ler bunları kullanmak isterse ses HAL uygulamalarını yükseltip HIDL 6.0 veya sonraki bir sürüme geçmeleri gerekir. Akışı yönlendirmek için set_parameters kullanmak, yeni ses sistemi türleri eklendiğinde beklenmedik sonuçlara neden olabileceğinden ana HAL sürümünü 3.0'a yükseltmek ve create_audio_patch ile release_audio_patch yöntemlerini uygulamak zorunludur.

Doğrulama

OEM'lerin yapması gereken işlem, HAL uygulamalarını güncellemektir. Ses HAL'si için VTS, uygulamanın beklendiği gibi çalışıp çalışmadığını doğrulamak için kullanılabilir. Tüm testleri VTS dosyalarında bulabilirsiniz.