AudioPermission class represents access rights to the audio
* system resources. An AudioPermission contains a target name
* but no actions list; you either have the named permission or you don't.
* * The target name is the name of the audio permission (see the table below). * The names follow the hierarchical property-naming convention. Also, an asterisk * can be used to represent all the audio permissions. *
* The following table lists the possible AudioPermission target names.
* For each name, the table provides a description of exactly what that permission
* allows, as well as a discussion of the risks of granting code the permission.
*
* *
| Permission Target Name | *What the Permission Allows | *Risks of Allowing this Permission | *
|---|---|---|
| play | *Audio playback through the audio device or devices on the system. * Allows the application to obtain and manipulate lines and mixers for * audio playback (rendering). | *In some cases use of this permission may affect other * applications because the audio from one line may be mixed with other audio * being played on the system, or because manipulation of a mixer affects the * audio for all lines using that mixer. | *
| record | *Audio recording through the audio device or devices on the system. * Allows the application to obtain and manipulate lines and mixers for * audio recording (capture). | *In some cases use of this permission may affect other * applications because manipulation of a mixer affects the audio for all lines * using that mixer. * This permission can enable an applet or application to eavesdrop on a user. | *
* * @author Kara Kytle * @since 1.3 */ /* * (OLD PERMISSIONS TAKEN OUT FOR 1.2 BETA) * *
*
* @author Kara Kytle
* @since 1.3
*/
/*
* The AudioPermission class represents access rights to the audio
* system resources. An AudioPermission contains a target name
* but no actions list; you either have the named permission or you don't.
*
* The target name is the name of the audio permission (see the table below). * The names follow the hierarchical property-naming convention. Also, an asterisk * can be used to represent all the audio permissions. *
* The following table lists all the possible AudioPermission target names. * For each name, the table provides a description of exactly what that permission * allows, as well as a discussion of the risks of granting code the permission. *
* *
| Permission Target Name | *What the Permission Allows | *Risks of Allowing this Permission | *
|---|---|---|
| play | *Audio playback through the audio device or devices on the system. | *Allows the application to use a system device. Can affect other applications, * because the result will be mixed with other audio being played on the system. | *
| record | *Recording audio from the audio device or devices on the system, * commonly through a microphone. | *Can enable an applet or application to eavesdrop on a user. | *
| playback device access | *Direct access to the audio playback device(s), including configuration of the * playback format, volume, and balance, explicit opening and closing of the device, * etc. | *Changes the properties of a shared system device and therefore * can affect other applications. | *
| playback device override | *Manipulation of the audio playback device(s) in a way that directly conflicts * with use by other applications. This includes closing the device while it is in * use by another application, changing the device format while another application * is using it, etc. | *Changes the properties of a shared system device and therefore * can affect other applications. | *
| record device access | *Direct access to the audio recording device(s), including configuration of the * the record format, volume, and balance, explicit opening and closing of the device, * etc. | *Changes the properties of a shared system device and therefore * can affect other applications. | *
| record device override | *Manipulation of the audio recording device(s) in a way that directly conflicts * with use by other applications. This includes closing the device while it is in * use by another application, changing the device format while another application * is using it, etc. | *Changes the properties of a shared system device and therefore * can affect other applications. | *
*
* @author Kara Kytle
*/
public class AudioPermission extends BasicPermission {
/**
* Creates a new AudioPermission object that has the specified
* symbolic name, such as "play" or "record". An asterisk can be used to indicate
* all audio permissions.
* @param name the name of the new AudioPermission
*
* @throws NullPointerException if name is null.
* @throws IllegalArgumentException if name is empty.
*/
public AudioPermission(String name) {
super(name);
}
/**
* Creates a new AudioPermission object that has the specified
* symbolic name, such as "play" or "record". The actions
* parameter is currently unused and should be null.
* @param name the name of the new AudioPermission
* @param actions (unused; should be null)
*
* @throws NullPointerException if name is null.
* @throws IllegalArgumentException if name is empty.
*/
public AudioPermission(String name, String actions) {
super(name, actions);
}
}