Ses dozu

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Android 14, ses dozu ölçümlerini sürekli olarak izleyerek ve kullanıcılara zararlı maruz kalma seviyeleri hakkında uyarılar göndererek ses dozu için ses çerçevesi ve ses HAL'inde destek sağlar.

Ses dozu, belirli bir süre boyunca ses basıncı seviyelerinin ölçümüdür. Ses dozunu izleyerek kullanıcıları sesin zarar verici etkilerinden korumaya yardımcı olabiliriz. aşırı veya uzun süre sese maruz kalma ile daha iyi işitme koruması sunar. kulaklığınızı taşınabilir Android cihazlarda kullanarak ve mikrofona bağlanma olasılığını işitme engeli.

Güvenli dinleme cihazlarıyla ilgili yeni standartlar yönetmeliklere uygundur IEC62368-1 3. sürümde işitme korumasıyla ilgili gereksinimler (giriş gerektirir) ve EN50332-3 (abonelerle sınırlı erişim) yayınladı.

Ses dozu işlevi, OEM'lerin yeni işitme güvenliği yönetmeliklerine uymasını sağlar. OEM'ler, ses dozunu desteklemek için tüm özelleştirmeler ve sertifikalar için arayüz spesifikasyonlarına ve yönetmeliklerine uymalıdır. Özelleştirilmiş bir OEM uygulaması, ses dozunun AOSP varsayılan uygulamasını atlayabilir veya değiştirebilir. Ancak, AOSP uygulamasını kullanmanız önemle tavsiye edilir.

Ses dozu hesaplaması

IEC62368-1 3. sürüm ve EN50332-3'teki standartlar, hesaplanan ses dozunu (CSD) hesaplayarak maruz kalmayı ölçme CSD (şimdiki değeri) anlık maruz kalma düzeyleri (MEL) entegre edilerek hesaplanır. Yedi günlük birikmiş CSD değerlerinin sürekli kayan penceresi ses dozu hesaplaması.

IEC62368-1 3. baskısının 10.6.3.2 numaralı bölümüne göre, CSD değeri %100 sınırına ulaşırsa sistem, her %100 artışta kullanıcıyı ses seviyeleri konusunda uyarır. Kullanıcı Uyarı kabul edilmezse ses, önceden tanımlanmış radyasyona düşer IEC62368-1 Tablo 39'un enerji kaynağı sınıfı 1 (RS1) değeri.

IEC62368-1 3. sürümün 10.6.3.3 bölümünde belirtildiği gibi, sesle birlikte doz uyarıları görüyorsanız sistem, MEL değeri, Tablo 39'da belirtilen radyasyon enerji kaynağı sınıfı 2'yi (RS2) aşıyor IEC62368-1.

Bu yönetmeliklere uygun sertifika almak ve CSD değerlerini daha alakalı hale getirmek için sistemin, kullanıcılar tarafından algılanan doğru çıkış değerlerini (ör. medya oynatma çıkışı) kullanması gerekir. CSD hesaplamasında, kullanıcının maruz kaldığı gerçek ses basıncı seviyelerine yakın değerler kullanılması önemlidir.

Mimari

Çerçevelerin yakalandığı yere bağlı olarak, dönüştürücülerin donanım özellikleri ve efektleri, oluşturulan karelerin güç düzeyini etkileyebilir. Doğru bir çıkış ses basıncı seviyesi ölçümü elde etmek için HAL'i, MEL değerlerini doğrudan temel donanımdan alacak ve dijital sinyal işlemcisi (DSP) veya hoparlör özellikleri (ör. empedans, hassasiyet ve frekans yanıtı) tarafından uygulanan olası etkileri hesaba katacak şekilde genişlettik.

HAL, yedek mekanizma olarak MEL değerlerini sağlayamazsa CSD'yi analiz edip hesaplar. Ses çerçevesindeki bu hesaplama, HAL'den bildirilen oluşturulmuş çıkışla ve ses DSP'sine gönderilen karelerle ilgili bilgilere dayanır.

Ses dozu iki bileşene sahiptir: SoundDoseHelper ve Şekil 1'de gösterildiği gibi SoundDoseManager,:

Şekil 1. Ses dozu özelliğinin mimari bileşenleri.

SoundDoseHelper

systemserver sürecinde bulunan SoundDoseHelper sınıfı, tüm ilgili ses dozlama verileri için ana toplama noktası olmalıdır. AudioService sınıfı, SoundDoseHelper sınıfını yönetir.

SoundDoseHelper sınıfı aşağıdakilerden sorumludur:

• Yeni dozaj bilgilerini işleme
• Kalıcı ses dozu değerleri
• audioserver kilitlendiğinde durumu kurtarma
• Sistem kullanıcı arayüzü bildirimlerini tetikleme
• Sesi azaltma

SoundDoseManager

audioserver sürecinde bulunan ve şu anda etkin olan SoundDoseManager sınıfı AudioFlinger kapsamında ses dozu verilerini HAL'den toplar veya dahili olarak hesaplar. yedek olarak ayarlayabilirsiniz. SoundDoseManager sınıfı, ses dozu verilerini SoundDoseHelper sınıfına gönderir.

MelProcessor ve MelAggregator

HAL, MEL değerlerini sağlamıyorsa MelProcessor ve MelAggregator libaudioutils konumundaki yardımcı programlar dahili ses dozu hesaplaması için kullanılır.

MelProcessor sınıfında, ana hesaplama MelProcessor::process(const void* buffer, size_t bytes) çağrılarak ses örnekleri içeren bir arabellekte gerçekleştirilir. OEM'ler gerekirse HAL uygulamalarında MelProcessor kullanabilir.

MelAggregator sınıfı, MEL değerlerini farklı ses bağlantı noktalarından alır ve CSD değerini yedi günlük bir kaydırmalı pencereyle hesaplar. MelAggregator::aggregateAndAddNewMelRecord_l(MelRecord mel) yöntemi mantığı yürütür. Sonuçlar, AudioService ile iletişim için SoundDoseManager sınıfına gönderilir.

Uygulama

HIDL arayüz uzantılarının desteği Android 14'ten itibaren sonlandırılmıştır. Bu nedenle, hesaplanan MEL değerlerini almak ve karşılaşmaları yayınlamak için yeni HAL arayüzü uyarılar, adı ISoundDose, AIDL Ses HAL kapsamında tanımlanmıştır. Ancak, AIDL Audio HAL'yi entegre etmek için daha fazla zamana ihtiyaç duyan uygulamalar için bağımsız ses dozu AIDL HAL'yi içeren ISoundDoseFactory arayüzü. Bu özellik gelecekte kullanımdan kaldırılacaktır.

Ses dozu desteği için HAL yöntemleri aşağıdaki kodda gösterilmiştir örnek:

/**
 * This interface provides functions related to sound exposure control required for compliance to
 * EN/IEC 62368-1 3rd edition. Implementing this interface is mandatory for devices for which
 * compliance to this standard is mandated and implementing audio offload decoding or other direct
 * playback paths where volume control happens below the audio HAL.
 */
@VintfStability
interface ISoundDose {
    /**
     * Max value in dBA used for momentary exposure warnings as defined by IEC62368-1
     * 3rd edition. This value represents the default RS2 upper bound.
     */
    const int DEFAULT_MAX_RS2 = 100;
    /** Min value of the RS2 threshold in dBA as defined by IEC62368-1 3rd edition. */
    const int MIN_RS2 = 80;

    /**
     * Sets the RS2 upper bound used for momentary exposure warnings. Default value is
     * DEFAULT_MAX_RS2 as specified in IEC62368-1 3rd edition.
     *
     * @param rs2ValueDbA custom RS2 upper bound to use
     * @throws EX_ILLEGAL_ARGUMENT if rs2ValueDbA is greater than DEFAULT_MAX_RS2 or lower
     *                             than MIN_RS2
     */
    void setOutputRs2UpperBound(float rs2ValueDbA);

    /**
     * Gets the RS2 upper bound used for momentary exposure warnings.
     *
     * @return the RS2 upper bound in dBA
     */
    float getOutputRs2UpperBound();

    /**
     * Registers the HAL callback for sound dose computation. If sound dose is supported
     * the MEL values and exposure notifications will be received through this callback
     * only. The internal framework MEL computation will be disabled.
     * It is not possible to unregister the callback. The HAL is responsible to provide
     * the MEL values throughout its lifecycle.
     *
     * @param callback to use when new updates are available for sound dose
     */
    void registerSoundDoseCallback(in IHalSoundDoseCallback callback);

    @VintfStability
    oneway interface IHalSoundDoseCallback {
        /**
         * Called whenever the current MEL value exceeds the set RS2 upper bound.
         *
         * @param currentDbA the current MEL value which exceeds the RS2 upper bound
         * @param audioDevice the audio device where the MEL exposure warning was recorded
         */
        void onMomentaryExposureWarning(float currentDbA, in AudioDevice audioDevice);

        @VintfStability
        parcelable MelRecord {
            /**
             * Array of continuously recorded MEL values >= MIN_RS2 (1 per second).
             * First value in the array was recorded at 'timestamp'.
             */
            float[] melValues;
            /**
             * Corresponds to the time in seconds, as reported by CLOCK_MONOTONIC, when
             * the first MEL entry in melValues was recorded. The timestamp values have
             * to be consistent throughout all audio ports, equal timestamp values will
             * be aggregated.
             */
            long timestamp;
        }

        /**
         * Provides a MelRecord containing continuous MEL values sorted by timestamp.
         * Note that all the MEL values originate from the audio device specified by audioDevice.
         * In case values from multiple devices need to be reported, the caller should execute
         * this callback once for every device.
         *
         * @param melRecord contains the MEL values used for CSD
         * @param audioDevice the audio device where the MEL values were recorded
         */
        void onNewMelValues(in MelRecord melRecord, in AudioDevice audioDevice);
    }
}

Yeni HAL arayüzünde geri çağırma özelliği kullanılıyor. kısa süreli karşılaşma hakkında çerçeveyi bilgilendiren ve MEL değerleri sağlayan her çıkış seviyesi RS1'i aştığında. Bu arayüzler uygulandığında çerçeve, CSD raporlaması için bunları kullanır. Bu geri çağırma uygulaması olmadan, AudioFlinger'te yedek uygulama CSD değerlerinin tahminlerini hesaplamak için kullanılır.

Ses dozu bağımsız AIDL desteği

OEM'ler, ses dozunu AIDL ses HAL'sine entegre edene kadar AIDL API'yi ISoundDoseFactory kullanmayı deneyin. ISoundDoseFactory, aşağıda gösterildiği gibi ISoundDose arayüzünü kullanır şu kod örneğine bakalım:

@VintfStability
interface ISoundDoseFactory {
    /**
     * Retrieve the sound dose interface for a given audio HAL module name.
     *
     * If a device must comply to IEC62368-1 3rd edition audio safety requirements and is
     * implementing audio offload decoding or other direct playback paths where volume control
     * happens below the audio HAL, it must return an instance of the ISoundDose interface.
     * The same instance must be returned during the lifetime of the HAL module.
     * If the HAL module does not support sound dose, null must be returned, without throwing
     * any errors.
     *
     * @param module for which we trigger sound dose updates.
     * @return An instance of the ISoundDose interface implementation.
     * @throws EX_ILLEGAL_STATE If there was an error creating an instance.
     */
    @nullable ISoundDose getSoundDose(in @utf8InCpp String module);
}

Sound dose AIDL Audio HAL desteği

Ses doz arayüzü, AIDL Ses HAL'sinin bir parçası olarak uzun vadede desteklenir. aşağıdaki kod örneğinde gösterildiği gibi IModule arayüzünü genişletin:

@VintfStability
interface IModule {
…
    /**
     * Retrieve the sound dose interface.
     *
     * If a device must comply to IEC62368-1 3rd edition audio safety requirements and is
     * implementing audio offload decoding or other direct playback paths where volume control
     * happens below the audio HAL, it must return an instance of the ISoundDose interface.
     * The same instance must be returned during the lifetime of the HAL module.
     * If the HAL module does not support sound dose, null must be returned, without throwing
     * any errors.
     *
     * @return An instance of the ISoundDose interface implementation.
     * @throws EX_ILLEGAL_STATE If there was an error creating an instance.
     */
    @nullable ISoundDose getSoundDose();
}

Bu özellik, IEC62368-1 3. baskı ve EN50332-3'te açıklanan yeni bir düzenlemenin uygulanmasıdır. Bu nedenle, harici API'ler yoktur.

OEM'ler, yeni HAL arayüzlerini uygulayarak ve ses çerçevesine CSD için doğru MEL verileri sağlayarak (önerilen) veya özel bir ses dozu uygulaması sağlayarak cihazlarını sertifikalandırabilir.

Ses dozunun hesaplanmasını etkinleştirme

AOSP, varsayılan olarak sertifika alınmasını sağlayan işitme güvenliği mantığını destekler. .

Android 14'te ses dozunun hesaplanması devre dışıdır varsayılan olarak ayarlanır.

Ses dozunun hesaplanmasını etkinleştirmek için aşağıdaki yönergeleri kullanın ilk 14-QPR1'den başlıyor.

• Ses dozu yönetmelikleri ülkenizde uygulanıyorsa config.xml içinde config_safe_media_volume_enabled true olarak ayarlandı.

• EN50332-3 ve IEC62368-1 10.6.3 ile uyumlu olmak için tedarikçi firmaların config_safe_sound_dosage_enabled bayrağı config.xml kime: true. Kod çözme işlemini devre dışı bırakmayı destekleyen ve ses dozu HAL arayüzlerini uygulamayan cihazlarda config_safe_sound_dosage_enabled, true olarak ayarlanmamalıdır. Böyle durumlarda config_safe_sound_dosage_enabled politikasının true olarak ayarlanması yanlış CSD'ye yol açabilir değerleri ve sertifika sorunları hakkında bildirimler alabilirsiniz.

Aşağıdaki karar grafiğinde, deneme sonuçlarına göre ülke kısıtlamaları ve bayrakların değerleri (CSD veya eski) işitme güvenliği düzeyleri (Android 14'ten önce uygulanan) hesaplanır.

Şekil 2. Ses dozunun hesaplanmasını etkinleştir (Mantıksal Android 14-QPR1).

Doğrulama

OEM'ler, ses dozu için HAL arayüzünü uygularken IModule AIDL ses HAL uygulaması için VtsHalAudioCoreTargetTest tarafından tanımlanan veya bağımsız ses dozu AIDL HAL uygulaması için VtsHalSoundDoseFactoryTargetTest tarafından tanımlanan VTS test durumlarına göre doğrulama yapmalıdır.