com.dsi.ant.channel

Interface IAntChannelEventHandler

All Known Implementing Classes:

AntContinuousScanController.ChannelEventDispatcher

public interface IAntChannelEventHandler

This interface contains the method signature needed to handle required events from the ANT channel.

Since:

4.0

Method Summary

Methods

Modifier and Type	Method and Description
void	onChannelDeath() After this is called the channel object will be unusable.
void	onReceiveMessage(MessageFromAntType messageType, AntMessageParcel messageParcel) Receives ANT messages relating to this channel.

Method Detail

onReceiveMessage

void onReceiveMessage(MessageFromAntType messageType,
                    AntMessageParcel messageParcel)

Receives ANT messages relating to this channel. Implementations of this interface should construct the specific message object in com.dsi.ant.message.fromant for the message type. Each message class provides direct access to the contained values.

More details on ANT messages, and their contents can be found in the ANT Message Protocol and Usage document.

Parameters:

messageType - The unique identifier for the type of message.

messageParcel - The parceled ANT message received from the ANT Radio Service. This is simply the most basic representation of an ANT Message: Message ID and Message Content.

Since:

4.0

onChannelDeath

void onChannelDeath()

After this is called the channel object will be unusable. All future calls on the channel object will fail. Once this function is called, the channel is already dead and there is no need to call AntChannel.release(). Since this may or may not be called in conjunction with RemoteExceptions of the channel methods it is suggested to use a common handling routine with handling those exceptions.

Since:

4.0