AudioInputStream (Java Platform SE 8 )

java.lang.Object
- java.io.InputStream
- - javax.sound.sampled.AudioInputStream

All Implemented Interfaces:

Closeable ， AutoCloseable
```
public class AudioInputStream
extends InputStream
```
音频输入流是具有指定音频格式和长度的输入流。长度以采样帧而不是字节表示。提供了几种从流中读取一定数量的字节的方法，或者是未指定的字节数。音频输入流跟踪读取的最后一个字节。您可以跳过任意数量的字节以获得稍后的位置进行阅读。音频输入流可以支持标记。设置标记时，会记住当前的位置，以便以后可以返回。
AudioSystem类包含许多操纵AudioInputStream对象的方法。例如，方法让你：
- 从外部音频文件，流或URL获取音频输入流
- 从音频输入流写入一个外部文件
- 将音频输入流转换为不同的音频格式
从以下版本开始：

1.3

另请参见：

AudioSystem ， Clip.open(AudioInputStream)

Field Summary

Fields
Modifier and Type	Field and Description
`protected AudioFormat`	`format` 流中包含的音频数据的格式。
`protected long`	`frameLength` 这个流的长度，采样帧。
`protected long`	`framePos` 这个流中的当前位置，在采样帧中（从零开始）。
`protected int`	`frameSize` 每个帧的大小，以字节为单位。

构造方法摘要

构造方法
Constructor and Description
`AudioInputStream(InputStream stream, AudioFormat format, long length)` 使用来自指定输入流的音频数据构建音频输入流，该音频输入流在采样帧中具有请求的格式和长度。
`AudioInputStream(TargetDataLine line)` 构建从所指示的目标数据线读取其数据的音频输入流。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`int`	`available()` 返回从该音频输入流中可以读取（或跳过）的最大字节数，而不会阻塞。
`void`	`close()` 关闭此音频输入流并释放与流相关联的任何系统资源。
`AudioFormat`	`getFormat()` 获取此音频输入流中声音数据的音频格式。
`long`	`getFrameLength()` 获取流的长度，以采样帧而不是字节表示。
`void`	`mark(int readlimit)` 标记此音频输入流中的当前位置。
`boolean`	`markSupported()` 测试此音频输入流是否支持 `mark`和 `reset`方法。
`int`	`read()` 从音频输入流读取数据的下一个字节。
`int`	`read(byte[] b)` 从音频输入流读取一些字节数，并将它们存储到缓冲器阵列 `b` 。
`int`	`read(byte[] b, int off, int len)` 从音频流读取指定的最大数据字节数，将它们放入给定的字节数组。
`void`	`reset()` 将此音频输入流重新定位到上次调用其 `mark`方法时的位置。
`long`	`skip(long n)` 跳过并丢弃该音频输入流中指定数量的字节。

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

- 字段详细信息
  - format
```
protected AudioFormat format
```
    流中包含的音频数据的格式。
  - frameLength
```
protected long frameLength
```
    这个流的长度，采样帧。
  - frameSize
```
protected int frameSize
```
    每个帧的大小，以字节为单位。
  - framePos
```
protected long framePos
```
    这个流中的当前位置，在采样帧中（从零开始）。
- 构造方法详细信息
  - AudioInputStream
```
public AudioInputStream(InputStream stream,
                        AudioFormat format,
                        long length)
```
    使用来自指定输入流的音频数据构建音频输入流，该音频输入流在采样帧中具有请求的格式和长度。
    
    参数
    
    stream - 此 AudioInputStream对象所基于的流
    
    format - 此流的音频数据的格式
    
    length - 此流中数据的样本帧中的长度
  - AudioInputStream
```
public AudioInputStream(TargetDataLine line)
```
    构建从所指示的目标数据线读取其数据的音频输入流。流的格式与目标数据行的格式相同，长度为AudioSystem＃NOT_SPECIFIED。
    
    参数
    
    line - 此流获取其数据的目标数据行。
    
    另请参见：
    
    AudioSystem.NOT_SPECIFIED
- 方法详细信息
  - getFormat
```
public AudioFormat getFormat()
```
    获取此音频输入流中声音数据的音频格式。
    
    结果
    
    描述此流格式的音频格式对象
  - getFrameLength
```
public long getFrameLength()
```
    获取流的长度，以采样帧而不是字节表示。
    
    结果
    
    样品框架中的长度
  - read
```
public int read()
         throws IOException
```
    从音频输入流读取数据的下一个字节。音频输入流的帧大小必须是一个字节，否则将抛出IOException 。
    
    Specified by:
    
    read在类别 InputStream
    
    结果
    
    数据的下一个字节，如果达到流的结尾，则为-1
    
    异常
    
    IOException - 如果发生输入或输出错误
    
    另请参见：
    
    read(byte[], int, int) ， read(byte[]) ，
  - read
```
public int read(byte[] b)
         throws IOException
```
    从音频输入流读取一些字节数，并将它们存储到缓冲器阵列b 。实际读取的字节数作为整数返回。该方法阻塞直到输入数据可用，检测到流的结尾，或抛出异常。
    该方法将始终读取整数个帧。如果阵列的长度不是整数帧，则最多可读取b.length - (b.length % frameSize)字节。
    
    重写：
    
    read在类别 InputStream
    
    参数
    
    b - 读取数据的缓冲区
    
    结果
    
    读取到缓冲区中的总字节数，如果没有更多的数据，因为已经到达流的末尾，则为-1
    
    异常
    
    IOException - 如果输入或输出错误发生
    
    另请参见：
    
    read(byte[], int, int) ， read() ， available()
  - read
```
public int read(byte[] b,
                int off,
                int len)
         throws IOException
```
    从音频流读取指定的最大数据字节数，将它们放入给定的字节数组。
    该方法将始终读取整数个帧。如果len未指定整数帧，则最多可读取len - (len % frameSize)字节。
    
    重写：
    
    read在类别 InputStream
    
    参数
    
    b - 读取数据的缓冲区
    
    off - 从数组 b的偏移量，数据将写入数组 b
    
    len - 要读取的最大字节数
    
    结果
    
    读取到缓冲区中的总字节数，如果没有更多的数据，因为已经到达流的末尾，则为-1
    
    异常
    
    IOException - 如果发生输入或输出错误
    
    另请参见：
    
    read(byte[]) ， read() ， skip(long) ， available()
  - skip
```
public long skip(long n)
          throws IOException
```
    跳过并丢弃该音频输入流中指定数量的字节。
    
    重写：
    
    skip在类别 InputStream
    
    参数
    
    n - 要跳过的请求的字节数
    
    结果
    
    实际跳过的字节数
    
    异常
    
    IOException - 如果发生输入或输出错误
    
    另请参见：
    
    read() ， available()
  - available
```
public int available()
              throws IOException
```
    返回从该音频输入流中可以读取（或跳过）的最大字节数，而不会阻塞。此限制仅适用于下一次调用此音频输入流的read或skip方法; 每次调用这些方法时，限制可能会有所不同。根据底层流，如果此流已关闭，则可能会抛出IOException。
    
    重写：
    
    available在类别 InputStream
    
    结果
    
    可以从该音频输入流中读取而不阻塞的字节数
    
    异常
    
    IOException - 如果发生输入或输出错误
    
    另请参见：
    
    read(byte[], int, int) ， read(byte[]) ， read() ， skip(long)
  - close
```
public void close()
           throws IOException
```
    关闭此音频输入流并释放与流相关联的任何系统资源。
    
    Specified by:
    
    close在界面 Closeable
    
    Specified by:
    
    close在界面 AutoCloseable
    
    重写：
    
    close在类 InputStream
    
    异常
    
    IOException - 如果发生输入或输出错误
  - mark
```
public void mark(int readlimit)
```
    标记此音频输入流中的当前位置。
    
    重写：
    
    mark在类别 InputStream
    
    参数
    
    readlimit - 标记位置无效之前可以读取的最大字节数。
    
    另请参见：
    
    reset() ， markSupported()
  - reset
```
public void reset()
           throws IOException
```
    将此音频输入流重新定位到上次调用其 mark方法时的位置。
    
    重写：
    
    reset在类别 InputStream
    
    异常
    
    IOException - 如果发生输入或输出错误。
    
    另请参见：
    
    mark(int) ， markSupported()
  - markSupported
```
public boolean markSupported()
```
    测试此音频输入流是否支持 mark和 reset方法。
    
    重写：
    
    markSupported在类别 InputStream
    
    结果
    
    true如果这个流支持mark和reset方法; false否则
    
    另请参见：
    
    mark(int) ， reset()

Class AudioInputStream

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

format

frameLength

frameSize

framePos

构造方法详细信息

AudioInputStream

AudioInputStream

方法详细信息

getFormat

getFrameLength

read

read

read

skip

available

close

mark

reset

markSupported