Class AudioPlaybackPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

uno.anahata.asi.swing.audio.AudioPlaybackPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public final class AudioPlaybackPanel
extends JPanel

A reactive panel that encapsulates audio playback functionality.

This panel is a high-salience observer of the autonomous Audio toolkit. It synchronizes the UI dropdown with the session's selected output device and provides the engine for notification sounds and tool-invoked playback.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private final AgiPanel	agiPanel	The parent agi panel providing session context.
private Clip	currentClip	Reference to a short notification clip currently in flight.
private final JProgressBar	playbackLevelBar	Real-time volume meter for playback feedback.
private final org.jdesktop.swingx.JXComboBox	playbackLineComboBox	The dropdown for selecting the hardware playback line.
private final AtomicBoolean	playing	Flag indicating if audio is currently being played.
private EdtPropertyChangeListener	toolkitListener	Listener for toolkit-driven device selection changes.

Fields inherited from class JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
AudioPlaybackPanel(AgiPanel agiPanel)	Constructs a new AudioPlaybackPanel and binds it to the Audio toolkit.

Method Summary

Modifier and Type	Method	Description
private void	bindToToolkit()	Binds the UI listener to the toolkit's property change support.
private Audio	getAudioToolkit()	Resolves the autonomous Audio toolkit from the session.
private void	initPlaybackLineComboBox()	Discovers available playback hardware and populates the UI dropdown.
void	playSound(String resourceName)	Plays a short, non-blocking notification sound from the application's resources.
Runnable	playToggleable(byte[] data, Consumer<Boolean> onStatusChange)	Starts a toggleable audio playback from a byte array.
void	stop()	Stops all currently playing notification sounds and releases resources.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

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

Field Details

agiPanel

private final AgiPanel agiPanel

The parent agi panel providing session context.

playbackLineComboBox

private final org.jdesktop.swingx.JXComboBox playbackLineComboBox

The dropdown for selecting the hardware playback line.

playbackLevelBar

private final JProgressBar playbackLevelBar

Real-time volume meter for playback feedback.

playing

private final AtomicBoolean playing

Flag indicating if audio is currently being played.

currentClip

private volatile Clip currentClip

Reference to a short notification clip currently in flight.

toolkitListener

private EdtPropertyChangeListener toolkitListener

Listener for toolkit-driven device selection changes.

Constructor Details

AudioPlaybackPanel

public AudioPlaybackPanel(AgiPanel agiPanel)

Constructs a new AudioPlaybackPanel and binds it to the Audio toolkit.

Parameters:

agiPanel - The parent AgiPanel.

Method Details

getAudioToolkit

private Audio getAudioToolkit()

Resolves the autonomous Audio toolkit from the session.

Returns:

The toolkit instance or null.

bindToToolkit

private void bindToToolkit()

Binds the UI listener to the toolkit's property change support.

playSound

public void playSound(String resourceName)

Plays a short, non-blocking notification sound from the application's resources.

Parameters:

resourceName - The name of the sound file (e.g., "idle.wav").

playToggleable

public Runnable playToggleable(byte[] data,
 Consumer<Boolean> onStatusChange)

Starts a toggleable audio playback from a byte array.

Parameters:

data - The PCM audio data.

onStatusChange - Callback for play/stop events.

Returns:

A stopper Runnable that cancels the playback task.

stop

public void stop()

Stops all currently playing notification sounds and releases resources.

This method terminates the execution of the currentClip and clears the reference to ensure proper garbage collection. It also resets the global playing state.

initPlaybackLineComboBox

private void initPlaybackLineComboBox()

Discovers available playback hardware and populates the UI dropdown.