com.tacttiles.api

Class RuntimeConnection

java.lang.Object

com.tacttiles.api.RuntimeConnection

public class RuntimeConnection
extends java.lang.Object

A RuntimeConnection represents a inter-process communication (IPC) connection with the Tact-Tiles Runtime Service app.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RuntimeConnection.RC_CMD Defines the compatible commands of the Tact-Tiles API RuntimeConnection clients.
static class	RuntimeConnection.RS_CMD Defines the compatible commands of the Tact-Tiles Runtime Service app.

Constructor Summary

Constructors

Constructor and Description
RuntimeConnection() Default constructor.

Method Summary

Modifier and Type	Method and Description
boolean	connect(Context appContext) Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access, starting it if necessary.
void	disconnect() Properly unregister this client.
protected void	onIPCMessage(int type, Bundle data) Called when this client receives a response from the service runtime.
protected void	onServiceConnected() Called when this adapter successfully connects to the service.
protected void	onServiceDisconnected() Called when this adapter is disconnected from the service.
void	requestBTDiscovery() Request a rescan of the available devices.
void	requestFocus(Device device) Request that all bluetooth messages received from a Tact-Tiles device to be redirected to this adapter.
static void	sendAnonymousIPCMessage(Context appContext, int type, Bundle data, Handler handler) Sends a request to the runtime service without the need to setup a new RuntimeConnection.
void	sendBTMessage(byte[] msg) Sends a request to send a bluetooth message to the device.
protected void	sendIPCMessage(int type, Bundle data) Sends a request to the runtime service.
void	vibratePhone(long[] pattern) Vibrates the phone.

Methods inherited from class java.lang.Object

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

Constructor Detail

RuntimeConnection

public RuntimeConnection()

Default constructor.

Method Detail

sendAnonymousIPCMessage

public static void sendAnonymousIPCMessage(Context appContext,
                                           int type,
                                           Bundle data,
                                           Handler handler)

Sends a request to the runtime service without the need to setup a new RuntimeConnection.

Parameters:

appContext - The current context of this application.

type - Type of the request, defined by RuntimeConnection.RS_CMD.

data - Bundle with the command arguments.

handler - The handler for the response message, if any.

vibratePhone

public void vibratePhone(long[] pattern)

Vibrates the phone.

Parameters:

pattern - Pattern as defined by alternating off-on values in milliseconds.

onIPCMessage

protected void onIPCMessage(int type,
                            Bundle data)

Called when this client receives a response from the service runtime.

Parameters:

type - Type of the request, defined by RuntimeConnection.RC_CMD.

data - Bundle with the command arguments.

sendIPCMessage

protected void sendIPCMessage(int type,
                              Bundle data)

Sends a request to the runtime service.

Parameters:

type - Type of the request, defined by RuntimeConnection.RS_CMD.

data - Bundle with the command arguments.

sendBTMessage

public void sendBTMessage(byte[] msg)

Sends a request to send a bluetooth message to the device.

Parameters:

msg - The message to be sent.

connect

public boolean connect(Context appContext)

Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access, starting it if necessary.

Parameters:

appContext - The current context of this application.

Returns:

disconnect

public void disconnect()

Properly unregister this client. This method should be called before destroying the connected client activity.

requestFocus

public void requestFocus(Device device)

Request that all bluetooth messages received from a Tact-Tiles device to be redirected to this adapter.

Parameters:

device - The device to be registered.

requestBTDiscovery

public void requestBTDiscovery()

Request a rescan of the available devices.

onServiceConnected

protected void onServiceConnected()

Called when this adapter successfully connects to the service.

onServiceDisconnected

protected void onServiceDisconnected()

Called when this adapter is disconnected from the service.