AudioInputStream (Java Platform SE 7)

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

すべての実装されたインタフェース:

Closeable, AutoCloseable
```
public class AudioInputStream
extends InputStream
```
オーディオ入力ストリームは、オーディオの形式および長さが指定されている入力ストリームです。長さはバイト数ではなくサンプルフレーム数で表します。いくつかのメソッドを使用して、ストリームから指定したバイト数、あるいは未指定のバイト数を読み込むことができます。オーディオ入力ストリームは、読み込まれた最終バイトを記録します。任意のバイト数をスキップし、後ろの位置へ移動して読み込むことができます。オーディオ入力ストリームは、マークをサポートします。マークを設定すると現在の位置が記憶され、あとでその位置に戻ることができます。
AudioSystem クラスには、AudioInputStream オブジェクトを操作する多くのメソッドがあります。たとえば、メソッドを使用すると次の操作を実行できます。
- 外部オーディオファイル、ストリーム、または URL からオーディオ入力ストリームを取得します。
- オーディオ入力ストリームから外部ファイルを書き出します。
- オーディオ入力ストリームを別のオーディオ形式に変換します。
導入されたバージョン:

1.3

関連項目:
AudioSystem、Clip.open(AudioInputStream)

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`protected AudioFormat`	`format` ストリームに含まれるオーディオデータの形式です。
`protected long`	`frameLength` ストリームの長さ (サンプルフレーム単位) です。
`protected long`	`framePos` このストリームの現在の位置、サンプルフレーム単位 (ゼロから始まる) です。
`protected int`	`frameSize` 各フレームのサイズ (バイト単位) です。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`AudioInputStream(InputStream stream, AudioFormat format, long length)` 指定された入力ストリームからのオーディオデータを使用して、要求された形式およびサンプルフレーム数で表される長さをもつオーディオ入力ストリームを構築します。
`AudioInputStream(TargetDataLine line)` 指定されたターゲットデータラインからデータを読み込むオーディオ入力ストリームを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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)` 指定したバイト数を、このオーディオ入力ストリームからスキップおよび破棄します。

クラス 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
```
    オーディオ入力ストリームからデータの次のバイトを読み込みます。オーディオ入力ストリームのフレームサイズは、1 バイトにする必要があります。そうでない場合は、IOException がスローされます。
    
    定義:
    
    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
```
    このオーディオ入力ストリームを閉じて、そのストリームに関連付けられたすべてのシステムリソースを解放します。
    
    定義:
    
    close、インタフェース: Closeable
    
    定義:
    
    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
    
    戻り値:
    このストリームが mark メソッドと reset メソッドをサポートしている場合は true、そうでない場合は false
    関連項目:
    mark(int), reset()

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス AudioInputStream

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

format

frameLength

frameSize

framePos

コンストラクタの詳細

AudioInputStream

AudioInputStream

メソッドの詳細

getFormat

getFrameLength

read

read

read

skip

available

close

mark

reset

markSupported