In this document
This document provides a glossary of audio-related terminology, including a list of widely used, generic terms and a list of terms that are specific to Android.
These are audio terms that are widely used, with their conventional meanings.
- The study of the mechanical properties of sound, for example how the physical placement of transducers such as speakers and microphones on a device affects perceived audio quality.
- A multiplicative factor less than or equal to 1.0, applied to an audio signal to decrease the signal level. Compare to "gain".
- bits per sample or bit depth
- Number of bits of information per sample.
- A single stream of audio information, usually corresponding to one location of recording or playback.
- To decrease the number of channels, e.g. from stereo to mono, or from 5.1 to stereo. This can be accomplished by dropping some channels, mixing channels, or more advanced signal processing. Simple mixing without attenuation or limiting has the potential for overflow and clipping. Compare to "upmixing".
- To temporarily reduce the volume of one stream, when another stream becomes active. For example, if music is playing and a notification arrives, then the music stream could be ducked while the notification plays. Compare to "mute".
- A set of samples, one per channel, at a point in time.
- frames per buffer
- The number of frames handed from one module to the next at once; for example the audio HAL interface uses this concept.
- A multiplicative factor greater than or equal to 1.0, applied to an audio signal to increase the signal level. Compare to "attenuation".
- The units for sample rate or frame rate.
- Time delay as a signal passes through a system.
- One channel.
- See "surround sound". Strictly, since stereo is more than one channel, it is also "multi" channel. But that usage would be confusing.
- To (temporarily) force volume to be zero, independently from the usual volume controls.
- Pulse Code Modulation, the most common low-level encoding of digital audio. The audio signal is sampled at a regular interval, called the sample rate, and then quantized to discrete values within a particular range depending on the bit depth. For example, for 16-bit PCM, the sample values are integers between -32768 and +32767.
- To gradually increase or decrease the level of a particular audio parameter, for example volume or the strength of an effect. A volume ramp is commonly applied when pausing and resuming music, to avoid a hard audible transition.
- A number representing the audio value for a single channel at a point in time.
- sample rate or frame rate
- Number of frames per second; note that "frame rate" is thus more accurate, but "sample rate" is conventionally used to mean "frame rate."
- The use of sound to express feedback or information, for example touch sounds and keyboard sounds.
- Two channels.
- stereo widening
- An effect applied to a stereo signal, to make another stereo signal which sounds fuller and richer. The effect can also be applied to a mono signal, in which case it is a type of upmixing.
- surround sound
- Various techniques for increasing the ability of a listener to perceive sound position beyond stereo left and right.
- To increase the number of channels, e.g. from mono to stereo, or from stereo to surround sound. This can be accomplished by duplication, panning, or more advanced signal processing. Compare to "downmixing".
Hardware and Accessories
These terms are related to audio hardware and accessories.
These technologies connect audio and video components between devices, and are readily visible at the external connectors. The HAL implementor may need to be aware of these, as well as the end user.
- A short range wireless technology. The major audio-related Bluetooth profiles and Bluetooth protocols are described at these Wikipedia articles:
- Digital display interface by VESA.
- High-Definition Multimedia Interface, an interface for transferring audio and video data. For mobile devices, either a micro-HDMI (type D) or MHL connector is used.
- Mobile High-Definition Link is a mobile audio/video interface, often over micro-USB connector.
- phone connector
- A mini or sub-mini phone connector connects a device to wired headphones, headset, or line-level amplifier.
- An adapter from micro-USB to HDMI.
- Sony/Philips Digital Interface Format is an interconnect for uncompressed PCM. See Wikipedia article S/PDIF.
- Universal Serial Bus. See Wikipedia article USB.
These technologies connect internal audio components within a given device, and are not visible without disassembling the device. The HAL implementor may need to be aware of these, but not the end user.See these Wikipedia articles:
Audio Signal Path
These terms are related to the signal path that audio data follows from an application to the transducer, or vice-versa.
These are terms specific to the Android audio framework, or that may have a special meaning within Android beyond their general meaning.
- Advanced Linux Sound Architecture. As the name suggests, it is an audio framework primarily for Linux, but it has influenced other systems. See Wikipedia article ALSA for the general definition. As used within Android, it refers primarily to the kernel audio framework and drivers, not to the user-mode API. See tinyalsa.
- An API and implementation framework for output (post-processing) effects and input (pre-processing) effects. The API is defined at android.media.audiofx.AudioEffect.
- The sound server implementation for Android. AudioFlinger runs within the mediaserver process. See Wikipedia article Sound server for the generic definition.
- audio focus
- A set of APIs for managing audio interactions across multiple independent apps. See Managing Audio Focus and the focus-related methods and constants of android.media.AudioManager.
- The module within AudioFlinger responsible for combining multiple tracks and applying attenuation (volume) and certain effects. The Wikipedia article Audio mixing (recorded music) may be useful for understanding the generic concept. But that article describes a mixer more as a hardware device or a software application, rather than a software module within a system.
- audio policy
- Service responsible for all actions that require a policy decision to be made first, such as opening a new I/O stream, re-routing after a change and stream volume management.
- The primary low-level client API for receiving data from an audio input device such as microphone. The data is usually in pulse-code modulation (PCM) format. The API is defined at android.media.AudioRecord.
- The module within AudioFlinger responsible for sample-rate conversion. See Wikipedia article Resampling (audio) for the generic definition.
- The primary low-level client API for sending data to an audio output device such as a speaker. The data is usually in PCM format. The API is defined at android.media.AudioTrack.
- Usually same as application or app, but sometimes the "client" of AudioFlinger is actually a thread running within the mediaserver system process. An example of that is when playing media that is decoded by a MediaPlayer object.
- Hardware Abstraction Layer. HAL is a generic term in Android. With respect to audio, it is a layer between AudioFlinger and the kernel device driver with a C API, which replaces the earlier C++ libaudio.
- A thread within AudioFlinger that services lower latency "fast tracks" and drives the primary output device.
- fast track
- An AudioTrack client with lower latency but fewer features, on some devices.
- A higher-level client API than AudioTrack, for playing either encoded content, or content which includes multimedia audio and video tracks.
- An AudioFlinger debugging feature, available in custom builds only, for logging audio events to a circular buffer where they can then be dumped retroactively when needed.
- An Android system process that contains a number of media-related services, including AudioFlinger.
- An abstraction for "non-blocking" audio input/output ports used within AudioFlinger. The name can be misleading, as some implementations of the NBAIO API actually do support blocking. The key implementations of NBAIO are for pipes of various kinds.
- normal mixer
- A thread within AudioFlinger that services most full-featured AudioTrack clients, and either directly drives an output device or feeds its sub-mix into FastMixer via a pipe.
- OpenSL ES
- An audio API standard by The Khronos Group. Android versions since API level 9 support a native audio API which is based on a subset of OpenSL ES 1.0.1.
- silent mode
- A user-settable feature to mute the phone ringer and notifications, without affecting media playback (music, videos, games) or alarms.
- A higher-level client API than AudioTrack, used for playing sampled audio clips. It is useful for triggering UI feedback, game sounds, etc. The API is defined at android.media.SoundPool.
- See Media.
- A module within AudioFlinger responsible for synchronizing state among threads. Whereas NBAIO is used to pass data, StateQueue is used to pass control information.
- A grouping of stream types with similar behavior, used by the audio policy service.
- stream type
- An enumeration that expresses a use case for audio output. The audio policy implementation uses the stream type, along with other parameters, to determine volume and routing decisions. Specific stream types are listed at android.media.AudioManager.
- tee sink
- An AudioFlinger debugging feature, available in custom builds only, for retaining a short fragment of recent audio for later analysis. This permits comparison between what was actually played or recorded vs. what was expected.
- A small user-mode API above ALSA kernel with BSD license, recommended for use in HAL implementations.
- A higher-level client API than AudioTrack, used for playing DTMF signals. See the Wikipedia article Dual-tone multi-frequency signaling, and the API definition at android.media.ToneGenerator.
- An audio stream, controlled by the AudioTrack API.
- volume attenuation curve
- A device-specific mapping from a generic volume index to a particular attenuation factor for a given output.
- volume index
- A unitless integer that expresses the desired relative volume of a stream. The volume-related APIs of android.media.AudioManager operate in volume indices rather than absolute attenuation factors.