JavaTM 2 Platform
Standard Ed. 5.0

javax.sound.sampled.spi
クラス FormatConversionProvider

java.lang.Object
  上位を拡張 javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider
extends Object

形式変換プロバイダは、1 つ以上の入力形式から 1 つ以上の出力形式への形式変換サービスを提供します。コンバータには、オーディオデータの符号化または復号化、あるいはその両方を行う codec、コード変換器などが含まれます。形式コンバータは、サポートされる変換の判別、および変換されたデータを読み込めるオーディオストリームを取得するためのメソッドを提供します。

ソース形式は着信オーディオデータの形式を表します。この形式は変換されます。

ターゲット形式は、処理済の変換されたオーディオデータの形式です。これは、getAudioInputStream メソッドの 1 つによって返されたストリームから読み込めるデータ形式です。

導入されたバージョン:
1.3

コンストラクタの概要
FormatConversionProvider()
           
 
メソッドの概要
abstract  AudioInputStream getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)
          指定されたオーディオ入力ストリームから、指定されたエンコーディングでオーディオ入力ストリームを取得します。
abstract  AudioInputStream getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)
          指定されたオーディオ入力ストリームから、指定された形式でオーディオ入力ストリームを取得します。
abstract  AudioFormat.Encoding[] getSourceEncodings()
          このプロバイダが提供する形式変換サービスのソース形式エンコーディングのセットを取得します。
abstract  AudioFormat.Encoding[] getTargetEncodings()
          このプロバイダが提供する形式変換サービスのターゲット形式エンコーディングのセットを取得します。
abstract  AudioFormat.Encoding[] getTargetEncodings(AudioFormat sourceFormat)
          特定のソース形式について形式コンバータがサポートするターゲット形式エンコーディングのセットを取得します。
abstract  AudioFormat[] getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)
          形式コンバータがサポートする指定されたエンコーディングを持つターゲット形式のセットを取得します。
 boolean isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)
          特定の形式から特定のエンコーディングへの変換を形式コンバータがサポートするかどうかを示します。
 boolean isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)
          特定の形式から別の形式への変換を形式コンバータがサポートしているかどうかを示します。
 boolean isSourceEncodingSupported(AudioFormat.Encoding sourceEncoding)
          指定されたソース形式エンコーディングからの変換を形式コンバータがサポートしているかどうかを示します。
 boolean isTargetEncodingSupported(AudioFormat.Encoding targetEncoding)
          指定されたターゲット形式エンコーディングへの変換を形式コンバータがサポートしているかどうかを示します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

FormatConversionProvider

public FormatConversionProvider()
メソッドの詳細

getSourceEncodings

public abstract AudioFormat.Encoding[] getSourceEncodings()
このプロバイダが提供する形式変換サービスのソース形式エンコーディングのセットを取得します。

戻り値:
ソース形式エンコーディングの配列。配列は常に少なくとも 1 の長さを持つ

getTargetEncodings

public abstract AudioFormat.Encoding[] getTargetEncodings()
このプロバイダが提供する形式変換サービスのターゲット形式エンコーディングのセットを取得します。

戻り値:
ターゲット形式エンコーディングの配列。配列は常に少なくとも 1 の長さを持つ

isSourceEncodingSupported

public boolean isSourceEncodingSupported(AudioFormat.Encoding sourceEncoding)
指定されたソース形式エンコーディングからの変換を形式コンバータがサポートしているかどうかを示します。

パラメータ:
sourceEncoding - サポートについて照会するソース形式エンコーディング
戻り値:
エンコーディングがサポートされている場合は true、そうでない場合は false

isTargetEncodingSupported

public boolean isTargetEncodingSupported(AudioFormat.Encoding targetEncoding)
指定されたターゲット形式エンコーディングへの変換を形式コンバータがサポートしているかどうかを示します。

パラメータ:
targetEncoding - サポートについて照会するターゲット形式エンコーディング
戻り値:
エンコーディングがサポートされている場合は true、そうでない場合は false

getTargetEncodings

public abstract AudioFormat.Encoding[] getTargetEncodings(AudioFormat sourceFormat)
特定のソース形式について形式コンバータがサポートするターゲット形式エンコーディングのセットを取得します。このソース形式に対してサポートされるターゲット形式エンコーディングがない場合、長さ 0 の配列が返されます。

戻り値:
サポートされるターゲット形式エンコーディングの配列

isConversionSupported

public boolean isConversionSupported(AudioFormat.Encoding targetEncoding,
                                     AudioFormat sourceFormat)
特定の形式から特定のエンコーディングへの変換を形式コンバータがサポートするかどうかを示します。

パラメータ:
targetEncoding - 送出データの望ましいエンコーディング
sourceFormat - 着信データの形式
戻り値:
変換がサポートされている場合は true、そうでない場合は false

getTargetFormats

public abstract AudioFormat[] getTargetFormats(AudioFormat.Encoding targetEncoding,
                                               AudioFormat sourceFormat)
形式コンバータがサポートする指定されたエンコーディングを持つターゲット形式のセットを取得します。このソース形式に対してサポートされる、指定されたエンコーディングのターゲット形式がない場合、長さ 0 の配列が返されます。

戻り値:
サポートされるターゲット形式の配列

isConversionSupported

public boolean isConversionSupported(AudioFormat targetFormat,
                                     AudioFormat sourceFormat)
特定の形式から別の形式への変換を形式コンバータがサポートしているかどうかを示します。

パラメータ:
targetFormat - 送出データの望ましい形式
sourceFormat - 着信データの形式
戻り値:
変換がサポートされている場合は true、そうでない場合は false

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(AudioFormat.Encoding targetEncoding,
                                                     AudioInputStream sourceStream)
指定されたオーディオ入力ストリームから、指定されたエンコーディングでオーディオ入力ストリームを取得します。

パラメータ:
targetEncoding - 処理後のストリームの望ましいエンコーディング
sourceStream - 処理するデータの読み込み元のストリーム
戻り値:
指定されたターゲットエンコーディングで処理されたデータの読み込み元のストリーム
例外:
IllegalArgumentException - 提供された形式変換がサポートされていない場合

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(AudioFormat targetFormat,
                                                     AudioInputStream sourceStream)
指定されたオーディオ入力ストリームから、指定された形式でオーディオ入力ストリームを取得します。

パラメータ:
targetFormat - 処理後のストリームの望ましいデータ形式
sourceStream - 処理するデータの読み込み元のストリーム
戻り値:
指定された形式で処理されたデータの読み込み元のストリーム
例外:
IllegalArgumentException - 提供された形式変換がサポートされていない場合

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。