com.sportradar.sdk.feed.common.interfaces

Interface UserRequestManager

All Known Subinterfaces:

LiveOddsBasedFeed, LiveOddsBaseUserRequestManager, LiveOddsFeed, LiveOddsUserRequestManager, LiveOddsWithOutrightsFeed, LiveOddsWithOutrightsUserRequestManager, LiveScoutFeed, LiveScoutUserRequestManager, RaceFeed, RaceUserRequestManager

public interface UserRequestManager

Represents a class used to process explicit user requests by generating and sending server messages.

Method Summary

Modifier and Type	Method and Description
void	bookMatches(EventIdentifier[] eventIds) Book the specified matches.
EventIdentifier[]	getSubscribedEvents() Gets the ids of all subscribed matches.
TestManager	getTestManager() When connected to the test server you can obtain a manager to manipulate it.
void	subscribe(EventIdentifier[] eventIds) Subscribe to specified matches.
void	unsubscribe(EventIdentifier[] eventIds) Un-subscribe from the specified matches.

Method Detail

bookMatches

void bookMatches(EventIdentifier[] eventIds)

Book the specified matches. Booked matches cannot be cancelled through this interface. This method can block to prevent going over the server limits. Use this call in non SDK dispatcher thread!

You should prefer using the Live Calendar on the Betradar website (http://www.betradar.com) which offers automatic booking for certain types of matches.

Note that booking matches will have a cost depending on the type of agreement you have with Sportradar.

LiveScout: Expect LiveScoutFeedListener.onMatchBooked(com.sportradar.sdk.feed.livescout.interfaces.LiveScoutFeed, com.sportradar.sdk.feed.livescout.entities.MatchBookingEntity) message in reply.

Parameters:

eventIds - Array of event ids to book

Throws:

IllegalArgumentException - if eventIds is a null reference.

getSubscribedEvents

EventIdentifier[] getSubscribedEvents()

Gets the ids of all subscribed matches.

Returns:

the ids of all subscribed matches.

getTestManager

TestManager getTestManager()

When connected to the test server you can obtain a manager to manipulate it.

Returns:

a TestManager implementation

subscribe

void subscribe(EventIdentifier[] eventIds)

Subscribe to specified matches. This method can block to prevent going over the server limits. Use this call in non SDK dispatcher thread! LiveOdds: If successful and you have "Enable response on register and unregister requests" enabled in the XML config, then expect LiveOddsBasedFeedListener.onMetaInfoReceived(LiveOddsBasedFeed, MetaInfoEntity) message with OddsReplyType = "register" in response.

LiveScout: Expect LiveScoutFeedListener.onMatchUpdateReceived(com.sportradar.sdk.feed.livescout.interfaces.LiveScoutFeed, com.sportradar.sdk.feed.livescout.entities.MatchUpdateEntity) message is response. If match subscription is successful, a full match update is sent out. Otherwise explanation will be given in the response message (e.g. you do not have access to the match or there are already two open subscriptions for the match).

With LiveOdds you will automatically receive interesting updates and you should not Subscribe() unless you explicitly called unsubscribe(EventIdentifier[]) manually for that match before.

With LiveScout you must explicitly call subscribe(EventIdentifier[]) at start-up or no data will be received.

Parameters:

eventIds - Array of eventIds

unsubscribe

void unsubscribe(EventIdentifier[] eventIds)

Un-subscribe from the specified matches. After this no more events associated with these matches will be sent. This method can block to prevent going over the server limits. Use this call in non SDK dispatcher thread!

LiveOdds: If successful and you have “Enable response on register and un-register requests" enabled in the XML config, then you should receive LiveOddsBasedFeedListener.onMetaInfoReceived(LiveOddsBasedFeed, MetaInfoEntity) message with OddsReplyType "unregister" in response.

LiveScout: Expect LiveScoutFeedListener.onMatchStopped(com.sportradar.sdk.feed.livescout.interfaces.LiveScoutFeed, com.sportradar.sdk.feed.livescout.entities.MatchStopEntity) message in response.

Parameters:

eventIds - Array of event ids from which to un-subscribe

Throws:

IllegalArgumentException - if eventIds is a null reference.