net.rim.blackberry.api.bbm.platform.io
Class BBMPlatformChannelListener

java.lang.Object
  |
  +--net.rim.blackberry.api.bbm.platform.io.BBMPlatformChannelListener

All Implemented Interfaces:

BBMPlatformConnectionListener

public abstract class BBMPlatformChannelListener

extends Object

implements BBMPlatformConnectionListener

BBMChannelListener is required for BBMPlatformChannel to be created, and provides callback methods for BBMPlatformChannel events.
Note that the Platform cannot guarantee all the packets will come in order, so applicaitons will have to make sure the sequence of events if needed.

Field Summary

Fields inherited from interface net.rim.blackberry.api.bbm.platform.io.BBMPlatformConnectionListener

CONTACT_INVITED_BY_ME, CONTACT_INVITING_ME

Constructor Summary

BBMPlatformChannelListener()
Creates a new instance of a BBMPlatformChannelListener.

Method Summary

void	joinRequestCanceled(BBMPlatformConnection connection, BBMPlatformIncomingJoinRequest request, int reasonCode) Called when the user, who is hosting a public connection, has received a join request from a contact but has not yet accepted it, and the contact tries to cancel the join request.
void	joinRequestReceived(BBMPlatformConnection connection, BBMPlatformIncomingJoinRequest request, String cookie) Called when the user, who is hosting a public connection, receives a join request to the connection.

Methods inherited from interface net.rim.blackberry.api.bbm.platform.io.BBMPlatformConnectionListener

contactDeclined, contactLeft, contactsInvited, contactsJoined, dataReceived

Constructor Detail

BBMPlatformChannelListener

public BBMPlatformChannelListener()

Creates a new instance of a BBMPlatformChannelListener.

Since:

BBM SDK 1.0

Method Detail

joinRequestCanceled

public void joinRequestCanceled(BBMPlatformConnection connection,
                                BBMPlatformIncomingJoinRequest request,
                                int reasonCode)

Called when the user, who is hosting a public connection, has received a join request from a contact but has not yet accepted it, and the contact tries to cancel the join request.

Parameters:

connection - the public connection the user is hosting.

request - the incoming request that has been canceled.

reasonCode - It's defined in IOErrorCode to explain why the request is canceled.

Since:

BBM SDK 1.0

joinRequestReceived

public void joinRequestReceived(BBMPlatformConnection connection,
                                BBMPlatformIncomingJoinRequest request,
                                String cookie)

Called when the user, who is hosting a public connection, receives a join request to the connection.

Parameters:

connection - the public connection the user is hosting.

request - the incoming request the host receives.

cookie - a string parameter defined and sent by the request sender, For example, it can be a game level.

Since:

BBM SDK 1.0