public class AudioInputStream extends InputStream
AudioSystemクラスには、AudioInputStreamオブジェクトを操作する多くのメソッドがあります。 たとえば、メソッドを使用すると次の操作を実行できます。
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) |
指定したバイト数を、このオーディオ入力ストリームからスキップおよび破棄します。
|
protected AudioFormat format
protected long frameLength
protected int frameSize
protected long framePos
public AudioInputStream(InputStream stream, AudioFormat format, long length)
stream - このAudioInputStreamオブジェクトの基となるストリームformat - このストリームのオーディオ・データの形式length - サンプル・フレーム数で表されるこのストリーム内のデータの長さpublic AudioInputStream(TargetDataLine line)
line - このストリームがデータを取得するターゲット・データ・ライン。AudioSystem.NOT_SPECIFIEDpublic AudioFormat getFormat()
public long getFrameLength()
public int read()
throws IOException
IOExceptionがスローされます。 read、クラスInputStreamIOException - 入出力エラーが発生した場合read(byte[], int, int), read(byte[]), public int read(byte[] b)
throws IOException
bに格納します。 実際に読み込まれたバイト数は整数として返されます。 入力データが読み込めるようになるか、ストリームの終わりが検出されるか、または例外が発生するまで、このメソッドはブロックされます。
このメソッドは常にフレームの整数値を読み込みます。 配列の長さがフレームの整数値になっていない場合は、最大でb.length - (b.length % frameSize) バイトを読み込みます。
read、クラスInputStreamb - データの読込み先のバッファIOException - 入出力エラーが発生した場合read(byte[], int, int), read(), available()public int read(byte[] b,
int off,
int len)
throws IOException
このメソッドは常にフレームの整数値を読み込みます。 lenがフレームの整数値になっていない場合は、最大でlen - (len % frameSize) バイトを読み込みます。
read、クラスInputStreamb - データの読込み先のバッファoff - データが書き込まれる、配列bの先頭からのオフセットlen - 読み込む最大バイト数IOException - 入出力エラーが発生した場合read(byte[]), read(), skip(long), available()public long skip(long n)
throws IOException
skip、クラスInputStreamn - スキップを要求されたバイト数IOException - 入出力エラーが発生した場合read(), available()public int available()
throws IOException
readまたはskipメソッドを次に呼び出したときにかぎり適用されます。制限はこれらのメソッドを呼び出すたびに変えることができます。 このストリームがクローズしている場合、基礎にあるストリームによってはIOExceptionがスローされることがあります。 available、クラスInputStreamIOException - 入出力エラーが発生した場合read(byte[], int, int), read(byte[]), read(), skip(long)public void close()
throws IOException
close、インタフェースCloseableclose、インタフェースAutoCloseableclose、クラスInputStreamIOException - 入出力エラーが発生した場合public void mark(int readlimit)
mark、クラスInputStreamreadlimit - マークされた位置が無効になる前に読込み可能な最大バイト数。reset(), markSupported()public void reset()
throws IOException
markメソッドが呼び出されたときの位置に再設定します。reset、クラスInputStreamIOException - 入出力エラーが発生した場合。mark(int), markSupported()public boolean markSupported()
markメソッドとresetメソッドをサポートしているかどうかを判定します。markSupported、クラスInputStreammarkメソッドとresetメソッドをサポートしている場合はtrue、そうでない場合はfalsemark(int), reset() バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。