Class SmartDeviceRerouter

java.lang.Object

de.pottgames.tuningfork.router.SmartDeviceRerouter

All Implemented Interfaces:

com.badlogic.gdx.utils.Disposable, AudioDeviceRerouter

public class SmartDeviceRerouter
extends Object
implements AudioDeviceRerouter

The SmartDeviceRerouter checks every 1.5 seconds (configurable) whether the connection to the audio device still exists and whether it is the optimal connection. If not, it tries to establish a connection with the following prioritization:

• desired device
• current default device

The router is able to restore a previously lost connection to the desired device when it becomes available again. When not connected to the desired device, the router will establish a connection to the default device and also keep track of it, so when the user selects a new default device in the OS, the router will do the same accordingly.

Constructor Summary

Constructors

Constructor	Description
SmartDeviceRerouter()	Creates a new SmartDeviceRerouter with the default check interval.
SmartDeviceRerouter(long checkInterval)	Creates a new SmartDeviceRerouter with the given check interval for the background thread.

Method Summary

Modifier and Type	Method	Description
void	dispose()
void	onDisconnect()	Gets called when a disconnect to the audio device is detected.
void	setup(long device, String desiredDeviceSpecifier, ContextAttributes attributes)	This method is called before run.
void	start()	Starts the thread.
void	updateContextAttributes(ContextAttributes attributes)	This method gets called whenever the OpenAL context attributes change.
void	updateDesiredDevice(String desiredDeviceSpecifier)	This method gets called when the user changes the device at runtime via AudioDevice.switchToDevice(String).

Methods inherited from class Object

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

Constructor Details

SmartDeviceRerouter

public SmartDeviceRerouter()

Creates a new SmartDeviceRerouter with the default check interval.

SmartDeviceRerouter

public SmartDeviceRerouter(long checkInterval)

Creates a new SmartDeviceRerouter with the given check interval for the background thread.

Parameters:

checkInterval - sleep time of the background thread in milliseconds

Method Details

setup

public void setup(long device,
 String desiredDeviceSpecifier,
 ContextAttributes attributes)

Description copied from interface: AudioDeviceRerouter

This method is called before run.

Specified by:

setup in interface AudioDeviceRerouter

Parameters:

device - the OpenAL device handle

desiredDeviceSpecifier - the device specifier that was specified in AudioDeviceConfig.setDeviceSpecifier(String)

attributes - the context attributes

updateDesiredDevice

public void updateDesiredDevice(String desiredDeviceSpecifier)

Description copied from interface: AudioDeviceRerouter

This method gets called when the user changes the device at runtime via AudioDevice.switchToDevice(String).

Specified by:

updateDesiredDevice in interface AudioDeviceRerouter

Parameters:

desiredDeviceSpecifier - the device name

updateContextAttributes

public void updateContextAttributes(ContextAttributes attributes)

Description copied from interface: AudioDeviceRerouter

This method gets called whenever the OpenAL context attributes change.

Specified by:

updateContextAttributes in interface AudioDeviceRerouter

Parameters:

attributes - the context attributes

start

public void start()

Starts the thread.

Specified by:

start in interface AudioDeviceRerouter

onDisconnect

public void onDisconnect()

Description copied from interface: AudioDeviceRerouter

Gets called when a disconnect to the audio device is detected.

Specified by:

onDisconnect in interface AudioDeviceRerouter

dispose

public void dispose()

Specified by:

dispose in interface com.badlogic.gdx.utils.Disposable