org.deepsymmetry.beatlink

Interface BeatListener

All Known Subinterfaces:

MasterListener

All Known Implementing Classes:

MasterAdapter

public interface BeatListener

The listener interface for receiving beat announcements. Classes that are interested in knowing when DJ Link devices report beats can implement this interface. The listener object created from that class is then registered using BeatFinder.addBeatListener(BeatListener). Whenever a new beat starts, the newBeat(Beat) method in the listener object is invoked with it.

Author:

James Elliott

Method Summary

Modifier and Type	Method and Description
void	newBeat(Beat beat) Invoked when a beat is reported on the network.

Method Detail

newBeat

void newBeat(Beat beat)

Invoked when a beat is reported on the network. Even though beats contain far less detailed information than status updates, they can be passed to VirtualCdj.getLatestStatusFor(DeviceUpdate) to find the current detailed status for that device, as long as the Virtual CDJ is active.

To reduce latency, beat announcements are delivered to listeners directly on the thread that is receiving them them from the network, so if you want to interact with user interface objects in this method, you need to use javax.swing.SwingUtilities.invokeLater(Runnable) to do so on the Event Dispatch Thread. Even if you are not interacting with user interface objects, any code in this method must finish quickly, or it will add latency for other listeners, and beat announcements will back up. If you want to perform lengthy processing of any sort, do so on another thread.

Parameters:

beat - the message which announced the start of the new beat