AudioFormat Clase

Definición

[Android.Runtime.Register("android/media/AudioFormat", DoNotGenerateAcw=true)]
public class AudioFormat : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/media/AudioFormat", DoNotGenerateAcw=true)>]
type AudioFormat = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herencia

Object

Object

AudioFormat

Atributos

RegisterAttribute

Implementaciones

IParcelable IJavaObject IJavaPeerable IDisposable

Comentarios

La AudioFormat clase se usa para acceder a una serie de constantes de configuración de canales y formato de audio. Se usan por ejemplo en AudioTrack y AudioRecord, como valores válidos en parámetros individuales de constructores como AudioTrack#AudioTrack(int, int, int, int, int, int), donde el cuarto parámetro es una de las AudioFormat.ENCODING_* constantes. Las AudioFormat constantes también se usan en MediaFormat para especificar valores relacionados con audio que se usan habitualmente en medios, como para MediaFormat#KEY_CHANNEL_MASK.

La AudioFormat.Builder clase se puede usar para crear instancias de la AudioFormat clase de formato. Consulte para AudioFormat.Builder obtener documentación sobre la mecánica de la configuración y la creación de estas instancias. Aquí se describen los conceptos principales que la AudioFormat clase le permite transmitir en cada instancia, son: <ol><li>sample rate<li>codificando<máscaras> de canal li</ol>

Estrechamente asociado con AudioFormat es la noción de un fotograma de audio, que se usa en toda la documentación para representar la unidad completa de tamaño mínimo de los datos de audio.

<h4 id="sampleRate">Frecuencia de muestreo</h4>

Expresado en Hz, la frecuencia de muestreo en una AudioFormat instancia expresa el número de muestras de audio para cada canal por segundo en el contenido que está reproduciendo o grabando. No es la velocidad de muestreo a la que se representa o genera el contenido. Por ejemplo, un sonido a una velocidad de muestreo multimedia de 8000Hz se puede reproducir en un dispositivo que funciona a una velocidad de muestreo de 48000Hz; La conversión de frecuencia de muestreo se controla automáticamente mediante la plataforma, no se reproducirá a 6 veces la velocidad.

A partir de la API android.os.Build.VERSION_CODES#M, se admiten velocidades de muestreo de hasta 192kHz para AudioRecord y AudioTrack, con la conversión de frecuencia de muestreo realizada según sea necesario. Para mejorar la eficacia y evitar conversiones de pérdida, se recomienda que coincida con la frecuencia de muestreo de AudioRecord y AudioTrack con la frecuencia de muestreo del dispositivo de punto de conexión, y limite la frecuencia de muestreo a no más de 48kHz a menos que haya funcionalidades de dispositivo especiales que garantizan una tasa más alta.

<h4 id="encoding">Encoding</h4>

La codificación de audio se usa para describir la representación de bits de los datos de audio, que puede ser PCM lineal o audio comprimido, como AC3 o DTS.

Para PCM lineal, la codificación de audio describe el tamaño de muestra, 8 bits, 16 bits o 32 bits, y la representación de muestra, entero o float. <ul><li>#ENCODING_PCM_8BIT: la muestra de audio es un entero de 8 bits sin signo en el intervalo [0, 255], con un desplazamiento de 128 para cero. Normalmente, esto se almacena como un Java byte en una matriz de bytes o ByteBuffer. Dado que el Java byte es <em>signed</em>, tenga cuidado con las operaciones matemáticas y conversiones, ya que el bit más significativo se invierte. </li><li>#ENCODING_PCM_16BIT: la muestra de audio es un entero de 16 bits con signo que normalmente se almacena como un Java corto en una matriz corta, pero cuando el short se almacena en un byteBuffer, es endian nativo (en comparación con el valor predeterminado Java big endian). El corto tiene una gama completa de [-32768, 32767], y a veces se interpreta como datos Q.15 de punto fijo. </li><li>#ENCODING_PCM_FLOAT: introducido en la API android.os.Build.VERSION_CODES#LOLLIPOP, esta codificación especifica que la muestra de audio es un float de precisión única IEEE de 32 bits. El ejemplo se puede manipular como un Java float en una matriz float, aunque dentro de un ByteBuffer se almacena en orden de bytes endian nativo. El intervalo nominal de datos de ENCODING_PCM_FLOAT audio es [-1.0, 1.0]. Depende de la implementación si el máximo positivo de 1,0 se incluye en el intervalo. Los valores fuera del intervalo nominal se fijan antes de enviarlos al dispositivo de punto de conexión. Tenga en cuenta que el control de NaN no está definido; Los subnormales se pueden tratar como cero; y las infinidades generalmente se fijan igual que otros valores para AudioTrack – intentan evitar las infinidades porque pueden generar fácilmente un NaN. <br> Para lograr una mayor profundidad de bits de audio que un corto entero de 16 bits con signo, se recomienda usar ENCODING_PCM_FLOAT para la captura de audio, el procesamiento y la reproducción. Los floats se manipulan eficazmente mediante CPU modernas, tienen mayor precisión que enteros con signo de 24 bits y tienen un intervalo dinámico mayor que enteros con signo de 32 bits. AudioRecord a partir de la API android.os.Build.VERSION_CODES#M y AudioTrack a partir de la API android.os.Build.VERSION_CODES#LOLLIPOP admiten ENCODING_PCM_FLOAT. </li><li>#ENCODING_PCM_24BIT_PACKED: introducido en la API android.os.Build.VERSION_CODES#S, esta codificación especifica que la muestra de audio es un entero de 24 bits con signo de precisión extendida almacenado como un entero de 3 Java bytes en una ByteBuffer matriz de bytes o en native endian (vea java.nio.ByteOrder#nativeOrder()). Cada ejemplo tiene un rango completo de [-8388608, 8388607] y se puede interpretar como datos Q.23 de punto fijo. </li><li>#ENCODING_PCM_32BIT: introducido en la API android.os.Build.VERSION_CODES#S, esta codificación especifica que la muestra de audio es un entero de 32 bits con signo de precisión extendida almacenado como un entero de 4 Java bytes en una ByteBuffer matriz de bytes o en native endian (vea java.nio.ByteOrder#nativeOrder()). Cada ejemplo tiene un rango completo de [-2147483648, 2147483647] y se puede interpretar como datos Q.31 de punto fijo. </li></ul>

En el caso del audio comprimido, la codificación especifica el método de compresión, por ejemplo #ENCODING_AC3 , y #ENCODING_DTS. Los datos de audio comprimidos normalmente se almacenan como bytes en una matriz de bytes o ByteBuffer. Cuando se especifica una codificación de audio comprimido para , AudioTrackcrea una pista directa (no mixta) para la salida a un punto de conexión (como HDMI) capaz de descodificar el audio comprimido. Para (la mayoría) otros puntos de conexión, que no son capaces de descodificar este audio comprimido, primero tendrá que descodificar los datos, normalmente mediante la creación de un MediaCodec. Como alternativa, se puede usar MediaPlayer para la reproducción de archivos o secuencias de audio comprimidos.

Cuando el audio comprimido se envía a través de un directo AudioTrack, no es necesario escribir en múltiplos exactos de la unidad de acceso de audio; esto difiere de MediaCodec los búferes de entrada.

<h4 id="channelMask">Channel mask</h4>

Las máscaras de canal se usan en AudioTrack y AudioRecord para describir las muestras y su disposición en el marco de audio. También se usan en el punto de conexión (por ejemplo, una interfaz de audio USB, una DAC conectada a auriculares) para especificar configuraciones permitidas de un dispositivo determinado. <br>As of API android.os.Build.VERSION_CODES#M, hay dos tipos de máscaras de canal: máscaras de posición del canal y máscaras de índice de canal.

<h5 id="channelPositionMask">Máscaras de posición del canal/máscaras< de posición del canal h5> son las máscaras de canal android originales y se usan desde la API android.os.Build.VERSION_CODES#BASE. Para la entrada y salida, implican una naturaleza posicional: la ubicación de un altavoz o un micrófono para grabar o reproducir. <br>Para una máscara de posición de canal, cada posición de canal permitida corresponde a un bit en la máscara del canal. Si esa posición del canal está presente en el marco de audio, ese bit se establece; de lo contrario, es cero. El orden de los bits (de lsb a msb) corresponde al orden de la muestra de esa posición en el marco de audio. <br>Las máscaras de posición del canal canónico por recuento de canales son las siguientes: <br><table><tr><td>channel count</td td><>channel position mask</td></tr><><tr td>1</td><td>#CHANNEL_OUT_MONO</td></tr tr><><>td 2</td><td/td>#CHANNEL_OUT_STEREO<></tr tr><td><>3</td td><>#CHANNEL_OUT_STEREO | #CHANNEL_OUT_FRONT_CENTER</td></tr tr><><td 4></td td><>#CHANNEL_OUT_QUAD</td></tr tr><><td>5</td td><>#CHANNEL_OUT_QUAD | #CHANNEL_OUT_FRONT_CENTER</td></tr><><tr td>6</td><td/td>#CHANNEL_OUT_5POINT1<></tr tr><><td>7</td td><>#CHANNEL_OUT_5POINT1 | #CHANNEL_OUT_BACK_CENTER</td></tr tr><td><>8</td td><td/td>#CHANNEL_OUT_7POINT1_SURROUND<></tr></table><br>Estas máscaras son un ORed compuesto de máscaras de canal individuales. Por ejemplo #CHANNEL_OUT_STEREO , se compone de #CHANNEL_OUT_FRONT_LEFT y #CHANNEL_OUT_FRONT_RIGHT.

En el diagrama siguiente se representa el diseño de los canales de salida, como se ve por encima del agente de escucha (en el centro en la posición "lis", orientada al canal front-center).

TFL ----- TFC ----- TFR     T is Top
                  |  \       |       /  |
                  |   FL --- FC --- FR  |     F is Front
                  |   |\     |     /|   |
                  |   | BFL-BFC-BFR |   |     BF is Bottom Front
                  |   |             |   |
                  |   FWL   lis   FWR   |     W is Wide
                  |   |             |   |
                 TSL  SL    TC     SR  TSR    S is Side
                  |   |             |   |
                  |   BL --- BC -- BR   |     B is Back
                  |  /               \  |
                  TBL ----- TBC ----- TBR     C is Center, L/R is Left/Right

Todos los canales "T" (superior) están por encima del agente de escucha, todos los canales "BF" (front-front) están por debajo del agente de escucha, todos los demás están en el plano horizontal del agente de escucha. Cuando se usa en combinación, LFE1 y LFE2 están por debajo del agente de escucha, cuando se usa solo, el plano LFE no está definido. Consulte las definiciones de canal para obtener las abreviaturas.

<h5 id="channelIndexMask">Channel index masks/h5< Channel index masks> are introduced in API android.os.Build.VERSION_CODES#M. Permiten la selección de un canal determinado desde el punto de conexión de origen o receptor por número, es decir, el primer canal, el segundo canal, etc. Esto evita problemas con la asignación artificial de posiciones a canales de un punto de conexión, o calculando lo que el bit de posición i sup<>/sup< está dentro de la>máscara de posición del canal de un punto de conexión, etc. <br>Este es un ejemplo en el que las máscaras de índice de canal abordan esta confusión: tratar con un dispositivo USB de 4 canales. El uso de una máscara de posición y, en función del recuento de canales, sería un #CHANNEL_OUT_QUAD dispositivo, pero realmente uno solo está interesado en el canal 0 al canal 3. Después, el dispositivo USB tendría las siguientes máscaras de canal de bits individuales: #CHANNEL_OUT_FRONT_LEFT, #CHANNEL_OUT_FRONT_RIGHTy #CHANNEL_OUT_BACK_LEFT#CHANNEL_OUT_BACK_RIGHT. ¿Pero cuál es el canal 0 y cuál es el canal 3? <br>Para una máscara de índice de canal, cada número de canal se representa como un bit en la máscara, desde el lsb (canal 0) hacia arriba hasta el msb, numéricamente este valor de bit es 1 << channelNumber. Un bit establecido indica que el canal está presente en el marco de audio; de lo contrario, se borra. El orden de los bits también corresponde al orden de muestra del número de canal en el marco de audio. <Br>En el ejemplo anterior de dispositivo USB de 4 canales, el dispositivo tendría una máscara 0xFde índice de canal . Supongamos que queríamos seleccionar solo el primero y el tercer canal; esto correspondería a una máscara 0x5 de índice de canal (el primer y tercer conjunto de bits). Si usa AudioTrack esta máscara de índice de canal, el fotograma de audio constaría de dos muestras, la primera muestra de cada fotograma enrutado al canal 0 y la segunda muestra de cada fotograma enrutado al canal 2. La fórmula (1 << channelCount) - 1asigna las máscaras de índice de canal canónico por recuento de canales.

<h5>Use cases</h5><ul li><>Channel position mask for an endpoint:CHANNEL_OUT_FRONT_LEFT, , CHANNEL_OUT_FRONT_CENTERetc. for HDMI home theater purposes. <li>Channel position mask for an audio stream: Creating an AudioTrack to output movie content, where 5.1 multichannel output is to be written. <máscara de índice de canal li>para un punto de conexión: dispositivos USB para los que la entrada y la salida no corresponden a altavoz o micrófono izquierdo o derecho. <máscara de índice de canal li>para una secuencia de audio:AudioRecord un solo puede querer los canales de audio tercero y cuarto del punto de conexión (es decir, el segundo par de canales) y no le importa la posición a la que corresponde, en cuyo caso la máscara de índice del canal es 0xC. Las sesiones multicanal AudioRecord deben usar máscaras de índice de canal. </ul><h4 id="audioFrame">Audio Frame</h4>

Para PCM lineal, un fotograma de audio consta de un conjunto de muestras capturadas al mismo tiempo, cuyo recuento y asociación de canal se proporcionan mediante la máscara de canal y cuyo contenido de muestra se especifica mediante la codificación. Por ejemplo, un marco PCM estéreo de 16 bits consta de dos muestras PCM lineales de 16 bits, con un tamaño de marco de 4 bytes. En el caso del audio comprimido, un fotograma de audio puede hacer referencia alternativa a una unidad de acceso de bytes de datos comprimidos agrupados lógicamente para la descodificación y el acceso a la secuencia de bits (por ejemplo MediaCodec, ), o a un solo byte de datos comprimidos (por AudioTrack#getBufferSizeInFrames() AudioTrack.getBufferSizeInFrames()ejemplo, ), o el resultado del marco PCM lineal de descodificar los datos comprimidos (por ejemploAudioTrack#getPlaybackHeadPosition() AudioTrack.getPlaybackHeadPosition()), dependiendo del contexto en el que se use el marco de audio. Para los fines de , un formato de AudioFormat#getFrameSizeInBytes()datos comprimido devuelve un tamaño de fotograma de 1 byte.

Java documentación para android.media.AudioFormat.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.