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 が空である場合。