iOS
Android
Unity
REST Api
BDArenaPlayConnectorDelegate

Availability : ver 1.0 and later

Declared in : BDArenaPlayConnectorDelegate.h

Sample code : -

Overview

The delegates of the BDArenaConnector object must adopt the BDArenaPlayConnectorDelegate protocol in order to be notified about multiplayer module's events. Optional methods of the protocol allow the delegates to manage the registrations to the tables, the creation of challenges and the management of active matches.

Tasks

Error handling

- arenaPlay:requestDidFail:

 

Connection to daemon management

- arenaPlayConnectionDidClose

- arenaPlayConnectionEstabilished

- arenaPlayConnectionFailedWithError:

 

Managing tables

- arenaPlay:tablesListReceived:activeMatches:activePlayers:

- arenaPlay:paramReceived:forTableId:

- arenaPlay:registrationSuccessfullyCompletedToTable:withMatchId:

- arenaPlay:alreadyRegisteredToTableWithId:

- arenaPlay:unregistrationSuccessfullyCompletedFromTableWithId:

- arenaPlay:unregistrationFailedFromTableWithId:

- arenaPlay:notRegisteredToTableWithId:

- arenaPlay:playersListReceived:forTableId:

 

Managing matches

- arenaPlay:messageSuccessfullySent:inMatchWithId:

- arenaPlay:newMessageReceived:fromPlayer:inMatchWithId:

- arenaPlay:matchDidStart:

- arenaPlay:messageSuccessfullySent:toPlayerWithAuid:inMatchWithId:

- arenaPlay:matchSuccessfullyLeft:

- arenaPlay:leaveMatchWithId:didFailWithError:

- arenaPlay:playerWithAuid:leftMatchWithId:

- arenaPlay:playersListReceived:forMatchId:

 

Managing challenges

- arenaPlay:challengeCreationFailedWithError:

- arenaPlay:challengeCreationSuccessfullyCompletedWithChallengeId:
        withChallengeName:withParam:withPlayers:withMatchId:

- arenaPlay:challengeCancellationForId:failedWithError:

- arenaPlay:challengeCancellationSuccessfullyCompletedForChallengeWithId:

- arenaPlay:challengeWithId:cancelledWithReason:

- arenaPlay:challengeInvitationReceivedFromPlayer:
        withChallengeId:withChallengeName:withParam:withPlayers:withMatchId:

- arenaPlay:playerWithAuid:leftChallengeWithId:

- arenaPlay:leaveChallengeWithId:didFailWithError:

- arenaPlay:challengeSuccessfullyLeftForChallengeWithId:

- arenaPlay:invitationToChallengeWithId:refusedByPlayerWithAuid:

- arenaPlay:invitationToChallengeWithId:acceptedByPlayerWithAuid:

- arenaPlay:invitationSuccessfullyRefusedToChallengeWithId:

- arenaPlay:invitationRefusalToChallengeWithId:didFailWithError:

- arenaPlay:invitationSuccessfullyAcceptedToChallengeWithId:

- arenaPlay:invitationAcceptanceToChallengeWithId:didFailWithError:

- arenaPlay:readyToStartChallengeWithId:withName:withMatchId:
        withParam:withPlayers:andOrganizer:

- arenaPlay:startChallengeWithId:didFailWithError:

 

Asynchronous notifications 

- arenaPlay:status:receivedForPlayerWithAuid:

- arenaPlayLocalPlayerDidLoginFromDifferentDevice

- arenaPlay:didRemoveTableWithId:

 

 


 

 

 

 

 

arenaPlay:requestDidFail:

 

Notifies to the developers about failure events.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector requestDidFail:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This notification is called whenever a method call fails for unpredictable circumstances

(such as network connection failures or issues related to the device). 

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlayConnectionDidClose

 

Informs that the connection to the multiplayer daemon has been closed.

 

- (void) arenaPlayConnectionDidClose;

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlayConnectionEstabilished

 

Informs that the connection to the multiplayer daemon has been successfully estabilished.

 

- (void) arenaPlayConnectionEstabilished;

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlayConnectionFailedWithError:

 

Informs that some error occurred while trying to connect to the multiplayer daemon.

 

- (void) arenaPlayConnectionFailedWithError:(NSError*)error;

 

Parameters

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:tablesListReceived:activeMatches:activePlayers:

 

Returns the list of available tables, the number of active matches and the number of the connected players.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        tablesListReceived:(BDArenaTablesArray*)tables

        activeMatches:(NSInteger)activeMatches

        activePlayers:(NSInteger)activePlayers;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tables

    The array of available tables. This array contains objects of type BDArenaTableData

    that handle information about tables.

activeMatches

    The number of active matches.

activePlayers

    The number of players connected to the multiplayer daemon.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:paramReceived:forTableId:

 

Returns the param associated with a specific table.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        paramReceived:(NSString*)param

        forTableId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

param

    A user defined string set through the Arena Daemon's web panel.

tableId

    The table identifier.

 

Discussion

The param parameter can be used by the developer in order to associate a specific information

to a specific table for several purposes related to the application.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:registrationSuccessfullyCompletedToTable:withMatchId:

 

Informs that the registration to a specific table did succeed.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        registrationSuccessfullyCompletedToTable:(NSString*)tableId

        withMatchId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The table identifier.

matchId

    The match identifier associated with the table. Once all the table's available seats are occupied,

    the match will start and the developer will need this parameter in order to deliver messages

    to all the other players.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:alreadyRegisteredToTableWithId:

 

Informs that a request for registration to a specific table did fail because the local player

did already register to that table.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        alreadyRegisteredToTableWithId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The table identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:unregistrationSuccessfullyCompletedFromTableWithId:

 

Informs that the unregistration from a specific table did succeed.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        unregistrationSuccessfullyCompletedFromTableWithId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The table identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:unregistrationFailedFromTableWithId:

 

Informs that the unregistration from a specific table did fail.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        unregistrationFailedFromTableWithId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The table identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:notRegisteredToTableWithId:

 

Informs that the unregistration from a specific table did fail.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        notRegisteredToTableWithId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The table identifier.

 

Discussion

This event occurs if the local player tries to unregister from a table where he wasn't previously registered.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:playersListReceived:forTableId:

 

Retrieves the list of the players registered to a specific table.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        playersListReceived:(BDArenaPlayersArray*)players

        forTableId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

players

    An array of BDArenaPlayerData objects that brings information of the players registered to the table.

tableId

    The table identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:messageSuccessfullySent:inMatchWithId:

 

Informs that the local player has successfully sent a message in a specific match.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        messageSuccessfullySent:(NSString*)message

        inMatchWithId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

message

    The message string.

matchId

    The match identifier.

 

Discussion

In order to be able to send messages in a match, the local player needs to be one

of the participants to the match itself.

A message sent in a match is received by all the participants to that match.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:newMessageReceived:fromPlayer:inMatchWithId:

 

Informs the local player that a new message has been received.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        newMessageReceived:(NSString*)message

        fromPlayer:(BDArenaPlayerData*)playerData

        inMatchWithId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

message

    The message string.

playerData

    A BDArenaPlayerData object filled with the sender information.

matchId

    The match identifier.

 

Discussion

In order to be able to receive messages from other players in a match, the local player

and the sender player need to partecipate to the same specific match.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:matchDidStart:

 

Informs the local player that a new match has started.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector matchDidStart:(BDArenaMatchData*)matchData;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

matchData

    A BDArenaMatchData object that handles the match information.

 

Discussion

Only the players registered to a specific table are notified about the start of the match once

all the table's available seats are occupied.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:messageSuccessfullySent:toPlayerWithAuid:inMatchWithId:

 

Informs that the local player has successfully sent a message in a specific match to a specific player.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        messageSuccessfullySent:(NSString*)message

        toPlayerWithAuid:(NSInteger)auid

        inMatchWithId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

message

    The message string.

auid

    The Arena daemon Unique Id (auid) of the recipient player.

matchId

    The match identifier.

 

Discussion

In order to be able to send messages to a specific player in a match, the local player and

the sender player need to partecipate to the same specific match.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:matchSuccessfullyLeft:

 

Informs that the local player successfully left a specific match.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector matchSuccessfullyLeft:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

matchId

    The match identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:leaveMatchWithId:didFailWithError:

 

Informs that some error occurred while the local player trying to leave a specific match.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        leaveMatchWithId:(NSInteger)matchId

        didFailWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

matchId

    The match identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:playerWithAuid:leftMatchWithId:

 

Informs that a remote player did leave the match.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        playerWithAuid:(NSInteger)auid

        leftMatchWithId:(NSInteger)matchId; 

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

auid

    The Arena daemon Unique Id (auid) of the recipient player.

matchId

    The match identifier.

 

Discussion

This event occurs only if the local player and the remote player are participating in the same match.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:playersListReceived:forMatchId

 

Retrieves the list of the players that are playing a specific match.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        playersListReceived:(BDArenaPlayersArray*)players

        forMatchId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

players

    An array of BDArenaPlayerData objects that brings the information of the players

    that are playing the match.

matchId

    The match identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeCreationFailedWithError:

 

Informs that the attempt to create a challenge did fail.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector challengeCreationFailedWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This event is notified only to the local player when tries to create a new challenge and an error occurs.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeCreationSuccessfullyCompletedWithChallengeId:

        withChallengeName:withParam:withPlayers:withMatchId:

 

Informs that the attempt to create a challenge did succeed.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeCreationSuccessfullyCompletedWithChallengeId:(NSString*)challengeId

        withChallengeName:(NSString*)name

        withParam:(NSString*)param

        withPlayers:(BDArenaPlayersArray*)players

        withMatchId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

name

    An user defined string.

param

    A user defined string.

players

    An array of BDArenaPlayerData objects that brings the information of the players

    that have been invited to partecipate to the challenge.

matchId

    The match identifier associated with the challenge.

 

Discussion

This event is notified only to the local player when he successfully creates a new challenge. 

The param parameter can be used by the organizer of the challenge in order to associate

a specific information to the challenge itself.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeCancellationForId:failedWithError:

 

Informs that the attempt to cancel a previously created challenge did fail.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeCancellationForId:(NSString*)challengeId

        failedWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This event is notified only to the local player when tries to cancel a previously

created challenge and an error occurs. Only the organizer of a challenge can cancel it.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeCancellationSuccessfullyCompletedForChallengeWithId:

 

Informs that the attempt to cancel a previously created challenge did succeed.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeCancellationSuccessfullyCompletedForChallengeWithId:(NSString*)challengeId; 

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

 

Discussion

This event is notified only to the local player when he successfully cancel a previously created challenge.

Only the organizer of a challenge can cancel it.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeWithId:cancelledWithReason:

 

Informs that a specific challenge has been cancelled and returns the reason why.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeWithId:(NSString*)challengeId

        cancelledWithReason:(ARENA_CHALLENGE_CANCELLATION_REASON)reason;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

reason

    An ARENA_CHALLENGE_CANCELLATION_REASON value that specifies the reason of cancellation.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeInvitationReceivedFromPlayer:withChallengeId:

        withChallengeName:withParam:withPlayers:withMatchId:

 

Informs that the local player has been invited to join a new challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeInvitationReceivedFromPlayer:(BDArenaPlayerData*)organizer

        withChallengeId:(NSString*)challengeId

        withChallengeName:(NSString*)name

        withParam:(NSString*)param

        withPlayers:(BDArenaPlayersArray*)players

        withMatchId:(NSInteger)matchId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

organizer

    A BDArenaPlayerData object filled with the information of the organizer of the challenge.

challengeId

    The challenge identifier.

name

    An user defined string.

param

    An user defined string.

players

    An array of BDArenaPlayerData objects that brings the information of the players

    that have been invited to partecipate to the challenge.

matchId

    The match identifier associated with the challenge.

 

Discussion

This event is notified only to the player challenged when an organizer successfully creates

a new challenge. The param parameter can is set by the organizer of the challenge

in order to associate a specific information to the challenge itself.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:playerWithAuid:leftChallengeWithId:

 

Informs that a specific player left a challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        playerWithAuid:(NSInteger)auid

        leftChallengeWithId:(NSString*)challengeId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

auid

    The Arena daemon Unique Id (auid) of the player that left.

challengeId

    The challenge identifier.

 

Discussion

This event is notified to all participants of a challenge, including the organizer.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:leaveChallengeWithId:didFailWithError:

 

Informs that the local player did fail to leave a specific challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        leaveChallengeWithId:(NSString*)challengeId

        didFailWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:challengeSuccessfullyLeftForChallengeWithId:

 

Informs that the local player successfully left a specific challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        challengeSuccessfullyLeftForChallengeWithId:(NSString*)challengeId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationToChallengeWithId:refusedByPlayerWithAuid:

 

Informs that a remote player did refuse the invitation to join a challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationToChallengeWithId:(NSString*)challengeId

        refusedByPlayerWithAuid:(NSInteger)auid;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

auid

    The Arena daemon Unique Id (auid) of the player that left.

 

Discussion

This event is notified only to the organizer of the challenge.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationToChallengeWithId:acceptedByPlayerWithAuid:

 

Informs that a remote player did accept the invitation to join a challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationToChallengeWithId:(NSString*)challengeId

        acceptedByPlayerWithAuid:(NSInteger)auid;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

auid

    The Arena daemon Unique Id (auid) of the player that left.

 

Discussion

This event is notified only to the organizer of the challenge.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationSuccessfullyRefusedToChallengeWithId:

 

Informs that the local player successfully refused an invitation to join a specific challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationSuccessfullyRefusedToChallengeWithId:(NSString*)challengeId; 

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationRefusalToChallengeWithId:didFailWithError:

 

Informs that the waiver to participate in a challenge was not successful.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationRefusalToChallengeWithId:(NSString*)challengeId

        didFailWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationSuccessfullyAcceptedToChallengeWithId:

 

Informs that the acceptance to participate in a challenge was successful.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationSuccessfullyAcceptedToChallengeWithId:(NSString*)challengeId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:invitationAcceptanceToChallengeWithId:didFailWithError:

 

Informs that the acceptance to participate in a challenge was not successful.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        invitationAcceptanceToChallengeWithId:(NSString*)challengeId

        didFailWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:readyToStartChallengeWithId:withName:withMatchId:

        withParam:withPlayers:andOrganizer:

 

Informs that a specific challenge is ready to start.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        readyToStartChallengeWithId:(NSString*)challengeId

        withName:(NSString*)challengeName

        withMatchId:(NSInteger)matchId

        withParam:(NSString*)param

        withPlayers:(BDArenaPlayersArray*)players

        andOrganizer:(BDArenaPlayerData*)organizer;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

challengeName

    An user defined string.

matchId

    The match identifier associated with the challenge.

param

    An user defined string.

players

    An array of BDArenaPlayerData objects that brings the players that have been invited

    to partecipate to the challenge.

organizer

    BDArenaPlayerData object filled with the information of the organizer of the challenge.

 

Discussion

This event is notified only to the organizer of the challenge once all the challenged players 

have responded to the invitation. After that this event is received, the organizer

can do start the challenge by calling startChallengeWithId: method of BDArenaPlayConnector object.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:startChallengeWithId:didFailWithError:

 

Informs that the local player, if organizer of the challenge, did fail to start challenge.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        startChallengeWithId:(NSString*)challengeId

        didFailWithError:(NSError*)error;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

challengeId

    The challenge identifier.

error

    An NSError object containing the specific error that occurred.

    For more information about errors, check out the Errors Map section.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:status:receivedForPlayerWithAuid:

 

Returns the status information of a specific player.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector

        status:(ARENA_PLAYER_STATUS)status

        receivedForPlayerWithAuid:(NSInteger)auid;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

status

    An ARENA_PLAYER_STATUS value indicating the status of the requested player.

auid

    The Arena daemon Unique Id (auid) of the requested player.

 

Discussion

This event is notified only to the local player.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlayLocalPlayerDidLoginFromDifferentDevice

 

Informs that the local player did login from a different device.

 

- (void) arenaPlayLocalPlayerDidLoginFromDifferentDevice; 

 

Discussion

The multiplayer and chat daemons allow players to have only one session active.

If the local user, while connected to one of the daemons, tries to connect to the same daemons

through different devices, all previously estabilished connections are closed

by the system leaving active only the last incoming connection.
This behaviour is applied by ArenaDaemon in order to avoid duplication of players

and flooding actions to the platform.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h

 

 

 

arenaPlay:didRemoveTableWithId:

 

Informs that the administrator of the application did remove a specific table

from the multiplayer tables configuration.

 

- (void) arenaPlay:(BDArenaPlayConnector*)connector didRemoveTableWithId:(NSString*)tableId;

 

Parameters

connector

    The unique instance of BDArenaPlayConnector.

tableId

    The identifier of the removed table.

 

Discussion

This event is notified to all the players that did register to the removed table and that are waiting

for the match to start. If this event occurs, the application should notify the local player

that the table has been removed and the match won't never start.

 

Availability

available in SDK ver 1.0 and later

 

Declared in

BDArenaPlayConnectorDelegate.h