javax.sound.sampled

クラスAudioPermission

java.lang.Object

java.security.Permission

java.security.BasicPermission

javax.sound.sampled.AudioPermission

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

Serializable、Guard

public class AudioPermission
extends BasicPermission

AudioPermissionクラスは、オーディオ・システム・リソースへのアクセス権を表します。AudioPermissionにはターゲット名が含まれますが、アクション・リストは含まれません。指定されたアクセス権を持つか、持たないかのどちらかです。

ターゲット名はオーディオ・アクセス権の名前です(下記を参照)。命名は階層プロパティの命名規約に従います。また、アスタリスクを使用して、すべてのオーディオ・アクセス権を表すこともできます。

AudioPermissionに指定できるターゲット名を次の表に示します。この表では、名前ごとに、アクセス権で許可される正確な機能とコードにアクセス権を付与したときのリスクについて説明します。

アクセス権ターゲット名	アクセス権により許可される機能	このアクセス権を許可した場合のリスク
play	システム上の1つ以上のオーディオ・デバイスを介したオーディオ再生。アプリケーションでは、オーディオ再生(レンダリング)を行うためのラインとミキサーの取得および操作が許可される。	このアクセス権により、1つのラインからのオーディオがシステム上で再生中のほかのオーディオとミックスされる可能性があり、また、ミキサーの操作が、そのミキサーを使用するすべてのラインのオーディオに影響を与えるため、ほかのアプリケーションに影響をおよぼす場合がある。
record	システム上の1つ以上のオーディオ・デバイスを介したオーディオ録音。アプリケーションでは、オーディオ録音(取り込み)を行うためのラインとミキサーの取得および操作が許可される。	このアクセス権を使用するときには、ミキサーの操作は、そのミキサーを使用するすべてのラインのオーディオに影響するため、ほかのアプリケーションに影響を及ぼすことがある。このアクセス権によって、アプレットまたはアプリケーションはユーザーの音を聞くことができる。

導入されたバージョン:

1.3

関連項目:

直列化された形式

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

コンストラクタ

コンストラクタと説明
AudioPermission(String name) 「play」や「record」など、指定されたシンボリック名をもつ新しいAudioPermissionオブジェクトを作成します。
AudioPermission(String name, String actions) 「play」や「record」など、指定されたシンボリック名をもつ新しいAudioPermissionオブジェクトを作成します。

メソッドのサマリー

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

equals, getActions, hashCode, implies, newPermissionCollection

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

checkGuard, getName, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

AudioPermission

public AudioPermission(String name)

「play」や「record」など、指定されたシンボリック名をもつ新しいAudioPermissionオブジェクトを作成します。アスタリスクを使用して、すべてのオーディオのアクセス権を表示することができます。

パラメータ:

name - 新しいAudioPermissionの名前

例外:

NullPointerException - nameがnullである場合。

IllegalArgumentException - nameが空である場合。

AudioPermission

public AudioPermission(String name,
                       String actions)

「play」や「record」など、指定されたシンボリック名をもつ新しいAudioPermissionオブジェクトを作成します。actionsパラメータは現在は使用されていないのでnullを指定してください。

パラメータ:

name - 新しいAudioPermissionの名前

actions - (使用されない。したがってnullでなければならない)

例外:

NullPointerException - nameがnullである場合。

IllegalArgumentException - nameが空である場合。