English | Site Directory

Android - An Open Handset Alliance Project

javax.sound.sampled
public class

javax.sound.sampled.AudioInputStream

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

Summary

Fields

protected      AudioFormat  format   
protected      long  frameLength   
protected      long  framePos   
protected      int  frameSize   

Public Constructors

          AudioInputStream(InputStream stream, AudioFormat format, long length)
          AudioInputStream(TargetDataLine line)

Public Methods

        int  available()
Answers a int representing then number of bytes that are available before this InputStream will block.
        void  close()
Close the InputStream.
        AudioFormat  getFormat()
        long  getFrameLength()
        void  mark(int readlimit)
Set a Mark position in this InputStream.
        boolean  markSupported()
Answers a boolean indicating whether or not this InputStream supports mark() and reset().
        int  read(byte[] b, int off, int len)
Reads at most length bytes from the Stream and stores them in byte array b starting at offset.
        int  read(byte[] b)
Reads bytes from the Stream and stores them in byte array b.
        int  read()
Reads a single byte from this InputStream and returns the result as an int.
        void  reset()
Reset this InputStream to the last marked location.
        long  skip(long n)
Skips n number of bytes in this InputStream.
Methods inherited from class java.io.InputStream
Methods inherited from class java.lang.Object
Methods inherited from interface java.io.Closeable

Details

Fields

protected AudioFormat format

protected long frameLength

protected long framePos

protected int frameSize

Public Constructors

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

public AudioInputStream(TargetDataLine line)

Public Methods

public int available()

Answers a int representing then number of bytes that are available before this InputStream will block. This method always returns 0. Subclasses should override and indicate the correct number of bytes available.

Throws

IOException

public void close()

Close the InputStream. Concrete implementations of this class should free any resources during close. This implementation does nothing.

Throws

IOException

public AudioFormat getFormat()

public long getFrameLength()

public void mark(int readlimit)

Set a Mark position in this InputStream. The parameter readLimit indicates how many bytes can be read before a mark is invalidated. Sending reset() will reposition the Stream back to the marked position provided readLimit has not been surpassed.

This default implementation does nothing and concrete subclasses must provide their own implementations.

Parameters

readlimit the number of bytes to be able to read before invalidating the mark.

public boolean markSupported()

Answers a boolean indicating whether or not this InputStream supports mark() and reset(). This class provides a default implementation which answers false.

public int read(byte[] b, int off, int len)

Reads at most length bytes from the Stream and stores them in byte array b starting at offset. Answer the number of bytes actually read or -1 if no bytes were read and end of stream was encountered.

Parameters

b the byte array in which to store the read bytes.
off the offset in b to store the read bytes.
len the maximum number of bytes to store in b.

Throws

IOException

public int read(byte[] b)

Reads bytes from the Stream and stores them in byte array b. Answer the number of bytes actually read or -1 if no bytes were read and end of stream was encountered.

Parameters

b the byte array in which to store the read bytes.

Throws

IOException

public int read()

Reads a single byte from this InputStream and returns the result as an int. The low-order byte is returned or -1 of the end of stream was encountered. This abstract implementation must be provided by concrete subclasses.

Throws

IOException

public void reset()

Reset this InputStream to the last marked location. If the readlimit has been passed or no mark has been set, throw IOException. This implementation throws IOException and concrete subclasses should provide proper implementations.

Throws

IOException

public long skip(long n)

Skips n number of bytes in this InputStream. Subsequent read()'s will not return these bytes unless reset() is used. This method may perform multiple reads to read n bytes. This default implementation reads n bytes into a temporary buffer. Concrete subclasses should provide their own implementation.

Parameters

n the number of bytes to skip.

Throws

IOException
Build m5-rc15i - 10 Jun 2008 13:54