AudioFormat (Java Platform SE 8 )

java.lang.Object
- javax.sound.sampled.AudioFormat

public class AudioFormat
extends Object

AudioFormat是类指定一个特定的安排，在一个健全的数据流。通过检查存储在音频格式中的信息，您可以发现如何在二进制声音数据中解释比特。

每一数据线都有一个与它的数据流相关联的音频格式。源（回放）数据线的音频格式表示什么样的数据线预计将接收输出。对于一个目标（捕获）数据线，音频格式指定可以从该行读取的数据的种类。声音文件也有音频格式，当然。的AudioFileFormat类封装到另外一个AudioFormat，文件的具体信息。同样，一个AudioInputStream有AudioFormat。

的AudioFormat类适应一些常见的声音文件的编码技术，包括脉冲编码调制（PCM），μ律编码，和A律编码。这些编码技术是预定义的，但服务提供商可以创建新的编码类型。编码一个特定的格式，采用的是由其encoding字段命名。

除了编码，音频格式还包括其他属性，进一步指定数据的精确排列。这些包括信道的数目，采样速率，样本大小，字节顺序，帧速率和帧大小。声音可能有不同数量的音频通道：一个用于单声道，两个立体声。采样率测量了每通道每秒的声压的“快照”（样本）的多少。（如果声音是立体声，而不是单声道，两个样本实际上是测量在每个时刻的时间：一个为左声道，另一个为正确的通道；然而，采样率仍然测量每通道的数量，所以率是相同的，无论通道的数量。这是一个标准使用的术语）的样本大小表示有多少位是用来存储每个快照；8和16是典型的值。16位样本（或任何其他样本大小大于一个字节），字节顺序是重要的；每个样本的字节排列的“小端”或“大端”风格。如PCM编码，帧由所有通道的样品在给定的时间点，所以一帧的大小（以字节为单位）等于一个样本的大小（以字节为单位）的通道数倍。然而，随着编码帧可以包含一系列的样品一束压缩数据的一些其他种类，以及额外的，非样本数据。对于这样的编码，在解码成PCM采样率和样本大小的参考数据，所以它们是完全不同的帧速率和帧大小。

一个AudioFormat对象可以包括一组属性。房地产是一对键和值：关键是String型，相关的属性值是一个任意的对象。属性指定附加格式规范，如压缩格式的比特率。属性主要用来作为一种工具来传输音频格式的附加信息和来自服务提供商的信息。因此，在matches(AudioFormat)方法忽略性能。然而，依靠安装服务商的方法，如(AudioFormat, AudioFormat) isConversionSupported可以考虑性能，取决于各自的服务提供者实现。

下表列出了服务提供商应该使用的一些常见属性，如果适用的话：

Audio Format Properties
Property key	Value type	描述
"bitrate"	`Integer`	average bit rate in bits per second
"vbr"	`Boolean`	`true`, if the file is encoded in variable bit rate (VBR)
"quality"	`Integer`	encoding/conversion quality, 1..100

鼓励服务提供商（插件）的供应商，寻求其他已经建立的属性在第三方插件的信息，并遵循相同的约定。

从以下版本开始：: 一点三
另请参见：: DataLine.getFormat()， AudioInputStream.getFormat()， AudioFileFormat， FormatConversionProvider

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`AudioFormat.Encoding` `Encoding`类名称的数据表示用于音频流的具体类型。

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`bigEndian` 指示音频数据存储在大端或小端序。
`protected int`	`channels` 此格式的音频信道的数量（单声道的1，立体声的2）。
`protected AudioFormat.Encoding`	`encoding` 这种格式使用的音频编码技术。
`protected float`	`frameRate` 每秒播放或记录的帧的数目，用于具有此格式的声音。
`protected int`	`frameSize` 有此格式的声音的每一帧中的字节数。
`protected float`	`sampleRate` 每秒播放或记录的样本数，为具有此格式的声音。
`protected int`	`sampleSizeInBits` 有此格式的声音的每个样本中的比特数。

构造方法摘要

构造方法
Constructor and Description
`AudioFormat(AudioFormat.Encoding encoding, float sampleRate, int sampleSizeInBits, int channels, int frameSize, float frameRate, boolean bigEndian)` 构建与给定的参数 `AudioFormat`。
`AudioFormat(AudioFormat.Encoding encoding, float sampleRate, int sampleSizeInBits, int channels, int frameSize, float frameRate, boolean bigEndian, Map<String,Object> properties)` 构建与给定的参数 `AudioFormat`。
`AudioFormat(float sampleRate, int sampleSizeInBits, int channels, boolean signed, boolean bigEndian)` 构建一个线性PCM编码和给定参数的 `AudioFormat`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`int`	`getChannels()` 获取信道数。
`AudioFormat.Encoding`	`getEncoding()` 获取在此格式中的声音的编码类型。
`float`	`getFrameRate()` 每秒帧中的帧速率。
`int`	`getFrameSize()` 以字节获取帧大小。
`Object`	`getProperty(String key)` 获取由键指定的属性值。
`float`	`getSampleRate()` 获得样本率。
`int`	`getSampleSizeInBits()` 获取样本的大小。
`boolean`	`isBigEndian()` 指示音频数据存储在大端或小端字节序。
`boolean`	`matches(AudioFormat format)` 指示此格式是否与指定的格式匹配。
`Map<String,Object>`	`properties()` 获取一个属性不可修改的Map。
`String`	`toString()` 返回一个字符串，描述的格式，如：“PCM签署22050赫兹16位单大端”。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - encoding
```
protected AudioFormat.Encoding encoding
```
    这种格式使用的音频编码技术。
  - sampleRate
```
protected float sampleRate
```
    每秒播放或记录的样本数，为具有此格式的声音。
  - sampleSizeInBits
```
protected int sampleSizeInBits
```
    有此格式的声音的每个样本中的比特数。
  - channels
```
protected int channels
```
    此格式的音频信道的数量（单声道的1，立体声的2）。
  - frameSize
```
protected int frameSize
```
    有此格式的声音的每一帧中的字节数。
  - frameRate
```
protected float frameRate
```
    每秒播放或记录的帧的数目，用于具有此格式的声音。
  - bigEndian
```
protected boolean bigEndian
```
    指示音频数据存储在大端或小端序。
- Constructor Detail
  - AudioFormat
```
public AudioFormat(AudioFormat.Encoding encoding,
                   float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   int frameSize,
                   float frameRate,
                   boolean bigEndian)
```
    构建与给定的参数 AudioFormat。编码指定用来表示数据的约定。其他参数是在 class description进一步解释。
    
    参数
    
    encoding -音频编码技术
    
    sampleRate -每秒采样数
    
    sampleSizeInBits在每个样本的位数
    
    channels -通道数（1单、2立体声，等等）
    
    frameSize -在每帧中的字节数
    
    frameRate -每秒的帧数
    
    bigEndian -指示是否为单一样本的数据存储在大端字节序（ false意味着小端）
  - AudioFormat
```
public AudioFormat(AudioFormat.Encoding encoding,
                   float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   int frameSize,
                   float frameRate,
                   boolean bigEndian,
                   Map<String,Object> properties)
```
    构建与给定的参数 AudioFormat。编码指定用来表示数据的约定。其他参数是在 class description进一步解释。
    
    参数
    
    encoding -音频编码技术
    
    sampleRate -每秒采样数
    
    sampleSizeInBits在每个样本的位数
    
    channels -通道数（1单、2立体声，等等）
    
    frameSize -在每帧中的字节数
    
    frameRate -每秒的帧数
    
    bigEndian -指示是否为单一样本的数据存储在大端字节序（ false意味着小端）
    
    properties -含有格式 Map<String,Object>对象属性
    
    从以下版本开始：
    
    一点五
  - AudioFormat
```
public AudioFormat(float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   boolean signed,
                   boolean bigEndian)
```
    构建一个线性PCM编码和给定参数的 AudioFormat。帧大小设置为从每个通道中包含一个示例所需的字节数，并且将该帧速率设置为采样速率。
    
    参数
    
    sampleRate -每秒采样数
    
    sampleSizeInBits在每个样本的位数
    
    channels -通道数（1单、2立体声，等等）
    
    signed指示数据是否有符号或无符号
    
    bigEndian -指示是否为单一样本的数据存储在大端字节序（ false意味着小端）
- 方法详细信息
  - getEncoding
```
public AudioFormat.Encoding getEncoding()
```
    获取在此格式中的声音的编码类型。
    
    结果
    
    编码类型
    
    另请参见：
    
    AudioFormat.Encoding.PCM_SIGNED， AudioFormat.Encoding.PCM_UNSIGNED， AudioFormat.Encoding.ULAW， AudioFormat.Encoding.ALAW
  - getSampleRate
```
public float getSampleRate()
```
    获得样本率。压缩格式，返回值是未压缩的音频数据的采样率。当这audioformat用于查询（例如 AudioSystem.isConversionSupported）或功能（例如 DataLine.Info.getFormats），对 AudioSystem.NOT_SPECIFIED意味着任何采样率的采样率是可以接受的。 AudioSystem.NOT_SPECIFIED也回来时，采样率不是这个音频格式定义。
    
    结果
    
    每秒采样数，或 AudioSystem.NOT_SPECIFIED
    
    另请参见：
    
    getFrameRate()， AudioSystem.NOT_SPECIFIED
  - getSampleSizeInBits
```
public int getSampleSizeInBits()
```
    获取样本的大小。压缩格式，返回值是未压缩的音频数据的样本大小。当这audioformat用于查询（例如 AudioSystem.isConversionSupported）或功能（例如 DataLine.Info.getFormats），样本大小 AudioSystem.NOT_SPECIFIED意味着任何样本大小是可以接受的。 AudioSystem.NOT_SPECIFIED也回来时，样本大小是不是这个音频格式定义。
    
    结果
    
    在每个样本的位数，或 AudioSystem.NOT_SPECIFIED
    
    另请参见：
    
    getFrameSize()， AudioSystem.NOT_SPECIFIED
  - getChannels
```
public int getChannels()
```
    获取信道数。当这audioformat用于查询（例如 AudioSystem.isConversionSupported）或功能（例如 DataLine.Info.getFormats），一个 AudioSystem.NOT_SPECIFIED意味着任何返回值（正）通道的数量是可以接受的。
    
    结果
    
    通道数（1单、2立体声等），或 AudioSystem.NOT_SPECIFIED
    
    另请参见：
    
    AudioSystem.NOT_SPECIFIED
  - getFrameSize
```
public int getFrameSize()
```
    以字节获取帧大小。当这audioformat用于查询（例如 AudioSystem.isConversionSupported）或功能（例如 DataLine.Info.getFormats），帧大小 AudioSystem.NOT_SPECIFIED意味着任何帧的大小是可以接受的。 AudioSystem.NOT_SPECIFIED还回来时的帧大小是不是这个音频格式定义。
    
    结果
    
    每个帧中的字节数，或 AudioSystem.NOT_SPECIFIED
    
    另请参见：
    
    getSampleSizeInBits()， AudioSystem.NOT_SPECIFIED
  - getFrameRate
```
public float getFrameRate()
```
    每秒帧中的帧速率。当这audioformat用于查询（例如 AudioSystem.isConversionSupported）或功能（例如 DataLine.Info.getFormats），一个 AudioSystem.NOT_SPECIFIED意味着任何帧速率是可接受的帧速率。 AudioSystem.NOT_SPECIFIED也返回时的帧速率不为这种音频格式定义。
    
    结果
    
    每秒的帧数，或 AudioSystem.NOT_SPECIFIED
    
    另请参见：
    
    getSampleRate()， AudioSystem.NOT_SPECIFIED
  - isBigEndian
```
public boolean isBigEndian()
```
    指示音频数据存储在大端或小端字节序。如果样本大小不超过一个字节，返回值是不相关的。
    
    结果
    
    true如果数据存储在大端字节序， false如果小端
  - properties
```
public Map<String,Object> properties()
```
    获取一个属性不可修改的Map。属性的概念是在 class description进一步解释。
    
    结果
    
    包含所有的属性 Map<String,Object>对象。如果没有确认属性，则返回一个空的Map。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    getProperty(String)
  - getProperty
```
public Object getProperty(String key)
```
    获取由键指定的属性值。属性的概念是在 class description进一步解释。
    如果指定的属性不为特定的文件格式定义，此方法返回null。
    
    参数
    
    key -预期性能的关键
    
    结果
    
    该物业具有指定键的值，或 null如果属性不存在。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    properties()
  - matches
```
public boolean matches(AudioFormat format)
```
    指示此格式是否与指定的格式匹配。要匹配，两种格式必须具有相同的编码，并具有信道数的一致性值、采样速率、样本大小、帧速率和帧大小。该属性的值是一致的如果他们是平等的或指定的格式具有财产价值 AudioSystem.NOT_SPECIFIED。字节顺序（大端或小端）必须相同，如果样本大小大于一个字节。
    
    参数
    
    format格式的测试赛
    
    结果
    
    如果这 true格式相匹配的一 false指定，否则。
  - toString
```
public String toString()
```
    返回一个字符串，描述的格式，如：“PCM签署22050赫兹16位单大端”。字符串的内容可以实现java的声音之间的差异。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    描述格式参数的字符串

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class AudioFormat

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

encoding

sampleRate

sampleSizeInBits

channels

frameSize

frameRate

bigEndian

Constructor Detail

AudioFormat

AudioFormat

AudioFormat

方法详细信息

getEncoding

getSampleRate

getSampleSizeInBits

getChannels

getFrameSize

getFrameRate

isBigEndian

properties

getProperty

matches

toString