From 9b1407fd593c8e939488936a93e4af1b4a68ea6e Mon Sep 17 00:00:00 2001 From: Guru Nagarajan Date: Mon, 22 Apr 2013 13:54:33 -0700 Subject: Audio edits. modified: audio.jd Change-Id: Iffeace6ce6509b75329c1eecedc3745e4b323086 --- src/devices/audio.jd | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/src/devices/audio.jd b/src/devices/audio.jd index a64b7b7e..9f6cfd09 100644 --- a/src/devices/audio.jd +++ b/src/devices/audio.jd @@ -116,7 +116,7 @@ page.title=Audio
  • hardware/libhardware/include/hardware/audio_effect.h - represents effects that can - be applied to audio such as downmixing, echo, or noise supression. + be applied to audio such as downmixing, echo, or noise suppression.
  • See the implementation for the Galaxy Nexus at device/samsung/tuna/audio for an example.

    @@ -282,21 +282,20 @@ inputSource). In Android 4.2, the following sources are exposed to develo
  • android.media.MediaRecorder.AudioSource.DEFAULT
  • -

    The default pre-processing effects that are applied for each AudioSource is +

    The default pre-processing effects that are applied for each AudioSource are specified in the /system/etc/audio_effects.conf file. To specify your own default effects for every AudioSource, create a /system/vendor/etc/audio_effects.conf file and specify any pre-processing effects that you need to turn on. For an example, -see the implementation for the Nexus 10 in device/samsung/manta/audio_effects.conf +see the implementation for the Nexus 10 in device/samsung/manta/audio_effects.conf

    Warning: For the VOICE_RECOGNITION use case, do not enable -the noise supression pre-processing effect. This effect is already turned off by default, but if you enable -it in your own audio_effects.conf file, it is ignored by all of the -Google Apps that use voice recognition..

    +the noise suppression pre-processing effect. It should not be turned on by default when recording from this audio source, +and you should not enable it in your own audio_effects.conf file. Turning on the effect by default will cause the device to fail +the compatibility requirement +regardless of whether is was on by default due to configuration file, or the audio HAL implementation's default behavior.

    -The following example enables pre-processing for the VOIP AudioSource and Camcorder AudioSource. -If you turn these on, then the app developer does not need to explicilty request -to use these effects when they are requesting the particular AudioSource. -

    +

    The following example enables pre-processing for the VoIP AudioSource and Camcorder AudioSource. +By declaring the AudioSource configuration in this manner, the framework will automatically request from the audio HAL the use of those effects

     pre_processing {
    @@ -325,13 +324,13 @@ with the exception of voice recognition (VOICE_RECOGNITION).

  • Effects / pre-processing must be disabled by default
  • -For other sources, you could tune sources with the following effects: +

    Examples of tuning different effects for different sources are: