javax.sound.sampled

Class AudioInputStream

java.lang.Object

java.io.InputStream

javax.sound.sampled.AudioInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

public class AudioInputStream
extends InputStream

一个音频输入流是一个具有指定音频格式和长度的输入流。长度是在样本帧中表示的，而不是字节。提供了几种方法用于从流中读取一定数量的字节数，或一个未指定的字节数。音频输入流保持了读的最后一个字节的轨道。您可以跳过任意个字节数，以到达以后的阅读位置。一个音频输入流可以支持标记。当你设置一个标记，当前位置被记住，以便你可以返回到它。

的AudioSystem类包括许多方法AudioInputStream对象操作。例如，方法让你：

• 从外部音频文件、流或网址获得音频输入流
• 从一个音频输入流写一个外部文件
• 将音频输入流转换为不同的音频格式

从以下版本开始：

一点三

另请参见：

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

Field Detail

format

protected AudioFormat format

流中包含的音频数据的格式。

frameLength

protected long frameLength

此流的长度，在样本帧中。

frameSize

protected int frameSize

每个帧的大小，以字节为单位。

framePos

protected long framePos

在这个流中的当前位置，在样本帧（基于零）。

Constructor Detail

AudioInputStream

public AudioInputStream(InputStream stream,
                        AudioFormat format,
                        long length)

构造一个有请求的格式和长度的音频输入流，使用从指定的输入流的音频数据。

参数

stream流-这 AudioInputStream对象的基础

format -这流的音频数据格式

length在这流样本数据帧长度

AudioInputStream

public AudioInputStream(TargetDataLine line)

构建一个从目标数据线读取数据的音频输入流。流的格式是目标数据线相同，且长度# 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开始，该数据将被写入

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()