org.deepsymmetry.beatlink

Interface SyncListener

public interface SyncListener

The listener interface for receiving sync control messages. Classes that are interested in knowing when they are being instructed to turn sync mode on or off, or to become the tempo master, can implement this interface. The listener object created is then registered using BeatFinder.addSyncListener(SyncListener). Whenever a relevant message is received, the setSyncMode(boolean) or becomeMaster() method in the listener object is invoked.

Author:

James Elliott

Method Summary

Modifier and Type	Method and Description
void	becomeMaster() Invoked when we have received a message telling us to take over the role of tempo master.
void	setSyncMode(boolean synced) Invoked when we have received a message telling us to turn sync mode on or off.

Method Detail

setSyncMode

void setSyncMode(boolean synced)

Invoked when we have received a message telling us to turn sync mode on or off.

To reduce latency, sync commands 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:

synced - will be true when we should turn sync mode on

becomeMaster

void becomeMaster()

Invoked when we have received a message telling us to take over the role of tempo master.

To reduce latency, sync commands 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.