AudioFormat Classe

Definizione

[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

Ereditarietà

Object

Object

AudioFormat

Attributi

RegisterAttribute

Implementazioni

IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

La AudioFormat classe viene usata per accedere a una serie di costanti di configurazione del formato audio e del canale. Ad esempio, vengono usati in AudioTrack e AudioRecord, come valori validi in singoli parametri di costruttori come AudioTrack#AudioTrack(int, int, int, int, int, int), dove il quarto parametro è una delle AudioFormat.ENCODING_* costanti. Le AudioFormat costanti vengono usate anche in MediaFormat per specificare i valori relativi all'audio comunemente usati nei supporti, ad esempio per MediaFormat#KEY_CHANNEL_MASK.

La AudioFormat.Builder classe può essere usata per creare istanze della AudioFormat classe di formato. Per informazioni sulla meccanica della configurazione e sulla compilazione di tali istanze, vedere la AudioFormat.Builder documentazione. Di seguito vengono descritti i concetti principali che la AudioFormat classe consente di comunicare in ogni istanza, ovvero ol <<>li>sample rate<li encoding<li>>channel masks</ol>

Strettamente associato a AudioFormat è la nozione di frame audio, che viene usato in tutta la documentazione per rappresentare l'unità di misura minima completa dei dati audio.

<h4 id="sampleRate">Frequenza< di campionamento/h4>

Espresso in Hz, la frequenza di campionamento in un'istanza AudioFormat esprime il numero di campioni audio per ogni canale al secondo nel contenuto che si sta riproducendo o registrando. Non è la frequenza di campionamento con cui viene eseguito il rendering o la produzione del contenuto. Ad esempio, un suono a una frequenza di campionamento multimediale di 8000Hz può essere riprodotto su un dispositivo che opera a una frequenza di campionamento di 48000Hz; la conversione della frequenza di campionamento viene gestita automaticamente dalla piattaforma, non verrà riprodotta a 6 volte.

A partire dall'API android.os.Build.VERSION_CODES#M, le frequenze di campionamento fino a 192 kHz sono supportate per AudioRecord e AudioTrack, con la conversione della frequenza di campionamento eseguita in base alle esigenze. Per migliorare l'efficienza ed evitare conversioni in perdita, è consigliabile trovare una corrispondenza con la frequenza AudioRecord di campionamento del campione del dispositivo endpoint e AudioTrack limitare la frequenza di campionamento a non più di 48 kHz, a meno che non siano presenti funzionalità speciali del dispositivo che garantiscono una frequenza più elevata.

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

La codifica audio viene usata per descrivere la rappresentazione in bit dei dati audio, che può essere un PCM lineare o audio compresso, ad esempio AC3 o DTS.

Per PCM lineare, la codifica audio descrive le dimensioni del campione, 8 bit, 16 bit o 32 bit e la rappresentazione di esempio, integer o float. <ul><li>#ENCODING_PCM_8BIT: l'esempio audio è un intero senza segno a 8 bit nell'intervallo [0, 255], con un offset di 128 per zero. Questa operazione viene in genere archiviata come byte Java in una matrice di byte o ByteBuffer. Poiché il byte Java è <em>signed</em>, prestare attenzione alle operazioni matematiche e alle conversioni, perché il bit più significativo viene invertito. </li><li>#ENCODING_PCM_16BIT: l'esempio audio è un intero con segno a 16 bit in genere archiviato come Java breve in una breve matrice, ma quando il breve viene archiviato in un ByteBuffer, è endian nativo (rispetto al valore predefinito Java big endian). L'intervallo breve è compreso tra [-32768, 32767], e talvolta viene interpretato come dati A virgola fissa Q.15. </li><li>#ENCODING_PCM_FLOAT: introdotto nell'API android.os.Build.VERSION_CODES#LOLLIPOP, questa codifica specifica che l'esempio audio è un float a precisione singola IEEE a 32 bit. L'esempio può essere modificato come Java float in una matrice float, anche se all'interno di un ByteBuffer viene archiviato in ordine di byte endian nativo. L'intervallo nominale di ENCODING_PCM_FLOAT dati audio è [-1.0, 1.0]. L'implementazione dipende dal fatto che nell'intervallo sia incluso il massimo positivo di 1,0. I valori al di fuori dell'intervallo nominale vengono bloccati prima dell'invio al dispositivo endpoint. Attenzione che la gestione di NaN non è definita; i sottonormali possono essere trattati come zero; e infiniti sono in genere bloccati proprio come altri valori per AudioTrack – cercare di evitare infiniti perché possono generare facilmente un NaN. <br> Per ottenere una maggiore profondità di bit audio rispetto a un intero con segno a 16 bit, è consigliabile usare ENCODING_PCM_FLOAT per l'acquisizione, l'elaborazione e la riproduzione audio. I valori float vengono manipolati in modo efficiente dalle CPU moderne, hanno una precisione maggiore di interi con segno a 24 bit e hanno un intervallo dinamico maggiore di interi con segno a 32 bit. AudioRecorda partire dall'API e dal supporto ENCODING_PCM_FLOATdell'API android.os.Build.VERSION_CODES#Mandroid.os.Build.VERSION_CODES#LOLLIPOP .AudioTrack </li><li>#ENCODING_PCM_24BIT_PACKED: introdotto nell'API android.os.Build.VERSION_CODES#S, questa codifica specifica che l'esempio audio è un intero con segno a 24 bit di precisione estesa archiviato come 3 Java byte in una ByteBuffer matrice di byte o in endian nativo (vedere java.nio.ByteOrder#nativeOrder()). Ogni esempio ha una gamma completa di [-8388608, 8388607], e può essere interpretata come dati A virgola fissa Q.23. </li><li>#ENCODING_PCM_32BIT: introdotto nell'API android.os.Build.VERSION_CODES#S, questa codifica specifica che l'esempio audio è un intero con segno a 32 bit esteso archiviato come 4 Java byte in una ByteBuffer matrice di byte o in endian nativo (vedere java.nio.ByteOrder#nativeOrder()). Ogni esempio ha una gamma completa di [-2147483648, 2147483647], e può essere interpretata come dati A virgola fissa Q.31. </li></ul>

Per l'audio compresso, la codifica specifica il metodo di compressione, ad esempio #ENCODING_AC3 e #ENCODING_DTS. I dati audio compressi vengono in genere archiviati come byte in una matrice di byte o ByteBuffer. Quando viene specificata una codifica audio compressa per un AudioTrackoggetto , crea una traccia diretta (non mista) per l'output in un endpoint (ad esempio HDMI) in grado di decodificare l'audio compresso. Per la maggior parte degli altri endpoint, che non sono in grado di decodificare tale audio compresso, sarà necessario decodificare prima i dati, in genere creando un oggetto MediaCodec. In alternativa, è possibile usare MediaPlayer per la riproduzione di file o flussi audio compressi.

Quando l'audio compresso viene inviato tramite un diretto AudioTrack, non è necessario scrivere in multipli esatti dell'unità di accesso audio. Ciò è diverso dai MediaCodec buffer di input.

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

Le maschere di canale vengono usate in AudioTrack e AudioRecord per descrivere gli esempi e la relativa disposizione nel frame audio. Vengono usati anche nell'endpoint (ad esempio un'interfaccia audio USB, un'applicazione livello dati connessa alle cuffie) per specificare configurazioni consentite di un particolare dispositivo. <br>A partire dall'API android.os.Build.VERSION_CODES#M, esistono due tipi di maschere di canale: maschere di posizione del canale e maschere di indice del canale.

<h5 id="channelPositionMask">Channel position masks</h5> Channel position masks are the original Android channel masks, and are used since API android.os.Build.VERSION_CODES#BASE. Per l'input e l'output, implicano una natura posizionale, ovvero la posizione di un altoparlante o di un microfono per la registrazione o la riproduzione. <br>Per una maschera di posizione del canale, ogni posizione del canale consentita corrisponde a un bit nella maschera di canale. Se tale posizione del canale è presente nel fotogramma audio, tale bit viene impostato, altrimenti è zero. L'ordine dei bit (da lsb a msb) corrisponde all'ordine del campione di tale posizione nel frame audio. <br>Le maschere di posizione del canale canonico in base al numero di canali sono le seguenti: <br><table><><tr td>channel count</td><td>channel position mask</td></tr tr><<>td>1</td td#CHANNEL_OUT_MONO>><</><tr tr><><td>2</td><td>><#CHANNEL_OUT_STEREO</tr><td>><3</td><td#CHANNEL_OUT_FRONT_CENTER>#CHANNEL_OUT_STEREO | </td></tr<>><td 4></td td>><#CHANNEL_OUT_QUAD</td></tr tr><<>td>5</td td#CHANNEL_OUT_FRONT_CENTER><><#CHANNEL_OUT_QUAD | /td></tr><tr><td>6</td><td#CHANNEL_OUT_5POINT1<>/td></tr tr><<>td>7</td td><#CHANNEL_OUT_BACK_CENTER#CHANNEL_OUT_5POINT1 | ></><tr tr>><<td>8</td td/td></td><>#CHANNEL_OUT_7POINT1_SURROUND</tr<>/table><br>Queste maschere sono una composizione ORed di maschere di canale individuali. Ad esempio #CHANNEL_OUT_STEREO , è composto da #CHANNEL_OUT_FRONT_LEFT e #CHANNEL_OUT_FRONT_RIGHT.

Il diagramma seguente rappresenta il layout dei canali di output, come illustrato sopra il listener (al centro nella posizione "lis", rivolto al canale centrale).

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

Tutti i canali "T" (superiore) sono sopra il listener, tutti i canali "BF" (in basso) sono sotto il listener, tutti gli altri si trovano nel piano orizzontale del listener. Se usato in combinazione, LFE1 e LFE2 sono al di sotto del listener, se usato da solo, il piano LFE non è definito. Vedere le definizioni dei canali per le abbreviazioni

<h5 id="channelIndexMask">Channel index masks/h5> Channel index masks vengono introdotti< nell'API android.os.Build.VERSION_CODES#M. Consentono la selezione di un determinato canale dall'endpoint di origine o sink in base al numero, ad esempio il primo canale, il secondo canale e così via. In questo modo si evitano problemi con l'assegnazione artificiale delle posizioni ai canali di un endpoint o la ricerca di ciò che il bit di>posizione sup</<sup> si trova all'interno della maschera di posizione del canale di un endpoint e così via. <br>Ecco un esempio in cui le maschere di indice del canale rispondono a questa confusione: gestione di un dispositivo USB a 4 canali. Usando una maschera di posizione e in base al numero di canali, si tratta di un #CHANNEL_OUT_QUAD dispositivo, ma in realtà si è interessati solo al canale 0 fino al canale 3. Il dispositivo USB avrà quindi le maschere del canale di bit seguenti: #CHANNEL_OUT_FRONT_LEFT, #CHANNEL_OUT_FRONT_RIGHT#CHANNEL_OUT_BACK_LEFT e #CHANNEL_OUT_BACK_RIGHT. Ma qual è il canale 0 e qual è il canale 3? <br>Per una maschera di indice del canale, ogni numero di canale è rappresentato come un bit nella maschera, dall'lsb (canale 0) verso l'alto fino a msb, numericamente questo valore di bit è 1 << channelNumber. Un bit impostato indica che il canale è presente nel frame audio; in caso contrario, viene cancellato. L'ordine dei bit corrisponde anche all'ordine di campionamento del numero di canale nel frame audio. <br>Per l'esempio precedente di dispositivo USB a 4 canali, il dispositivo avrebbe una maschera 0xFdi indice del canale . Si supponga di voler selezionare solo il primo e il terzo canale; corrisponde a una maschera 0x5 di indice del canale (il primo e il terzo bit impostati). Se un AudioTrack oggetto usa questa maschera di indice del canale, il frame audio sarà costituito da due campioni, il primo campione di ogni frame indirizzato al canale 0 e il secondo campione di ogni frame indirizzato al canale 2. Le maschere dell'indice del canale canonico in base al numero di canali vengono fornite dalla formula (1 << channelCount) - 1.

<h5 Casi d'uso</h5<>>ul><li> Channel position mask per un endpoint:CHANNEL_OUT_FRONT_LEFT, CHANNEL_OUT_FRONT_CENTER, e così via per scopi home theater HDMI. <maschera di posizione del canale li>per un flusso audio: creazione di un AudioTrack oggetto per l'output del contenuto del filmato, in cui deve essere scritto l'output multicanale 5.1. <li>Channel index mask per un endpoint: dispositivi USB per i quali l'input e l'output non corrispondono all'altoparlante sinistro o destro o al microfono. <maschera di indice del canale li>per un flusso audio:AudioRecord può essere utile solo il terzo e il quarto canale audio dell'endpoint (ad esempio la seconda coppia di canali) e non importa la posizione a cui corrisponde, nel qual caso la maschera di indice del canale è 0xC. Le sessioni multicanale AudioRecord devono usare le maschere di indice del canale. </ul><h4 id="audioFrame">Audio Frame</h4>

Per PCM lineare, un frame audio è costituito da un set di campioni acquisiti contemporaneamente, il cui conteggio e l'associazione del canale vengono forniti dalla maschera di canale e il cui contenuto di esempio viene specificato dalla codifica. Ad esempio, un frame PCM stereo a 16 bit è costituito da due campioni PCM lineari a 16 bit, con una dimensione del frame di 4 byte. Per l'audio compresso, un frame audio può in alternativa fare riferimento a un'unità di accesso di byte di dati compressi raggruppati logicamente per la decodifica e l'accesso bitstream (ad MediaCodecesempio ) o a un singolo byte di dati compressi (ad AudioTrack#getBufferSizeInFrames() AudioTrack.getBufferSizeInFrames()esempio ) o al frame PCM lineare risultante dalla decodifica dei dati compressi (adAudioTrack#getPlaybackHeadPosition() AudioTrack.getPlaybackHeadPosition() esempio), a seconda del contesto in cui viene usato il frame audio. Ai fini di AudioFormat#getFrameSizeInBytes(), un formato di dati compresso restituisce una dimensione del frame pari a 1 byte.

per android.media.AudioFormat.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.