alma.acsplugins.alarmsystem.gui.sound

Class AlarmSound

java.lang.Object

java.util.TimerTask

alma.acsplugins.alarmsystem.gui.sound.AlarmSound

All Implemented Interfaces:

java.lang.Runnable

public class AlarmSound
extends java.util.TimerTask

A class to play sounds for alarms.

The class emits a sound every TIME_INTERVAL seconds if the table contains alarms not seen by the user. The sound depends on the highest priority of the alarms not seen i.e. every priority has its own specific sound.

It is possible to inhibit the sound for a given period of time, INHIBIT_TIME. After INHIBIT_TIME seconds, the sounds will be re-enabled.

In case of error playing a sound, objects of this class do nothing because we do not want to trigger a failure in the application neither to present a dialog to the operator. Apart of that, if the audio system is in use by another application then it might happen that it is not possible to reserve a new line and play the sound.;

Note: after testing in tf-ohg I have found that the STE sound environment is quite problematic. for example in my account there were 4 mixers but I have tried another one that add only one and in that case it was not possible to find a line to play the sound. With my account, even with 4 mixers available the process was able to play the sound but not in the speakers.
To limit the risk that the sound is played in the wrong device or that the line obtained by default is not available because locked by another application and so n, I decided to play the sound in all available devices with the risk to play it twice.

Since:

ACS 8.1.0

Author:

acaproni

Constructor Summary

Constructors

Constructor and Description
AlarmSound(AlarmTableModel model) Constructor

Method Summary

Modifier and Type	Method and Description
void	addSoundListener(AlarmSoundListener listener) Add or remove a listener
void	close() Close the timer.
int	getSoundLevel() Return the inhibit sound level
void	inhibit(int level) Set the level of the alarm to which a sound has to be played.
void	run() The task to emit the sound.

Methods inherited from class java.util.TimerTask

cancel, scheduledExecutionTime

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AlarmSound

public AlarmSound(AlarmTableModel model)

Constructor

Parameters:

model - The table model

Method Detail

inhibit

public void inhibit(int level)

Set the level of the alarm to which a sound has to be played.

Parameters:

level - The new level of the sound to play; level must be in the same range of soundLevel.

See Also:

AlarmSound#soundLevel}

getSoundLevel

public int getSoundLevel()

Return the inhibit sound level

Returns:

thethe inhibit sound level

See Also:

AlarmSound#soundLevel}

close

public void close()

Close the timer.

run

public void run()

The task to emit the sound.

Specified by:

run in interface java.lang.Runnable

Specified by:

run in class java.util.TimerTask

addSoundListener

public void addSoundListener(AlarmSoundListener listener)

Add or remove a listener

Parameters:

listener - If not null add the listener; otherwise remove the listener