Package com.sportradar.livedata.sdk.feed.livescout.classes

Class LiveScoutFeedImpl

java.lang.Object

com.sportradar.livedata.sdk.feed.livescout.classes.LiveScoutFeedImpl

All Implemented Interfaces:

UserRequestManager, LiveScoutFeed

public class LiveScoutFeedImpl
extends Object
implements LiveScoutFeed

A LiveScoutFeed implementation used to manage live-scout feed.

Field Summary

Fields

Modifier and Type	Field	Description
protected Object	lock	Object lock to ensure closing of the feed is called only once
protected SdkLogger	sdkLogger	Sdk logging facility.

Constructor Summary

Constructors

Constructor	Description
LiveScoutFeedImpl(ProtocolManager<OutgoingMessage,LiveScoutEntityBase> protocolManager, LiveScoutUserRequestManager userRequestManager, LiveScoutDispatcher dispatcher, LiveScoutSettings settings)	Initializes a new instance of the LiveScoutFeedImpl class.

Method Summary

Modifier and Type	Method	Description
void	bookMatches(EventIdentifier[] eventIds)	Book the specified matches.
void	close()	Closes the communication channel with the live-scout server.
void	dispose()	Closes the current feed, and disposes all resources associated with it.
ConnectionParams	getConnectionParams()	Holds data about underlying connection parameters
void	getMatchList(int hoursBack, int hoursForward, boolean includeAvailable)	Get a list of matches
void	getMatchList(int hoursBack, int hoursForward, boolean includeAvailable, Collection<Long> sportIds, Collection<Long> matchIds)	Requests a list of available scout matches for a given time frame.
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.
boolean	isOpened()	Gets the value specifying whether the current feed is opened
void	open(LiveScoutFeedListener listener)	Opens the communication channel with the live-scout server
void	requestServerTime()	Makes a server time request.
void	subscribe(EventIdentifier[] eventIds)	Subscribe to specified matches.
void	subscribeToTest(EventIdentifier eventId, Integer messageDelay, Integer startMessage)	Request a full feed for the match, and then update messages will follow in the same pace as they were sent out live.
void	unsubscribe(EventIdentifier[] eventIds)	Un-subscribe from the specified matches.

Methods inherited from class java.lang.Object

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

Field Detail

lock

protected final Object lock

Object lock to ensure closing of the feed is called only once

sdkLogger

protected final SdkLogger sdkLogger

Sdk logging facility.

Constructor Detail

LiveScoutFeedImpl

public LiveScoutFeedImpl(ProtocolManager<OutgoingMessage,LiveScoutEntityBase> protocolManager,
                         LiveScoutUserRequestManager userRequestManager,
                         LiveScoutDispatcher dispatcher,
                         LiveScoutSettings settings)

Initializes a new instance of the LiveScoutFeedImpl class.

Parameters:

protocolManager - A ProtocolManager implementation used to manage the underlying protocol and related components

userRequestManager - The UserRequestManager used to process user requests.

dispatcher - A LiveScoutDispatcher implementation used to dispatch messages to the user.

settings - Provided settings.

Throws:

IllegalArgumentException - The protocolManager is a null reference or a userRequestManager is a null reference or a dispatcher is a null reference.

Method Detail

isOpened

public boolean isOpened()

Gets the value specifying whether the current feed is opened

Specified by:

isOpened in interface LiveScoutFeed

Returns:

the value specifying whether the current feed is opened

open

public void open(LiveScoutFeedListener listener)

Opens the communication channel with the live-scout server

Specified by:

open in interface LiveScoutFeed

Parameters:

listener - The LiveScoutFeedListener instance used to observe the current LiveScoutFeed

getConnectionParams

public ConnectionParams getConnectionParams()

Description copied from interface: LiveScoutFeed

Holds data about underlying connection parameters

Specified by:

getConnectionParams in interface LiveScoutFeed

Returns:

feed connection parameters

getMatchList

public void getMatchList(int hoursBack,
                         int hoursForward,
                         boolean includeAvailable,
                         Collection<Long> sportIds,
                         Collection<Long> matchIds)

Requests a list of available scout matches for a given time frame.

By default only matches you have access to will be sent. You can also request all available matches by setting the includeAvailable If this is done the reply will also include matches that are open for booking.

Specified by:

getMatchList in interface LiveScoutFeed

Parameters:

hoursBack - Specifies the open of the time frame

hoursForward - Specifies the end of the time frame

includeAvailable - Specifies whether matches available for booking should be included

sportIds - - filter by sports ids, nullable

matchIds - - filter by matches ids, nullable

getMatchList

public void getMatchList(int hoursBack,
                         int hoursForward,
                         boolean includeAvailable)

Description copied from interface: LiveScoutFeed

Get a list of matches

Specified by:

getMatchList in interface LiveScoutFeed

Parameters:

hoursBack - - number of hours back (from current time)

hoursForward - - number of hours forward (from current time)

includeAvailable - - include also available matches (which you have not booked yet)

requestServerTime

public void requestServerTime()

Description copied from interface: LiveScoutFeed

Makes a server time request. This method can block to prevent going over the server limits. Use this call in non SDK dispatcher thread!

Specified by:

requestServerTime in interface LiveScoutFeed

bookMatches

public void bookMatches(EventIdentifier[] eventIds)

Book the specified matches. Booked matches cannot be cancelled through this interface.

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(LiveScoutFeed, MatchBookingEntity) message in reply.

Specified by:

bookMatches in interface UserRequestManager

Parameters:

eventIds - The id of events to book

getSubscribedEvents

public EventIdentifier[] getSubscribedEvents()

Gets the ids of all subscribed matches.

Specified by:

getSubscribedEvents in interface UserRequestManager

Returns:

the ids of all subscribed matches.

subscribe

public void subscribe(EventIdentifier[] eventIds)

Subscribe to specified matches. LiveScout: Expect LiveScoutFeedListener.onMatchUpdateReceived(LiveScoutFeed, 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 LiveScout you must explicitly call UserRequestManager.subscribe(EventIdentifier[]) at open-up or no data will be received.

Specified by:

subscribe in interface UserRequestManager

Parameters:

eventIds - Array of event ids

unsubscribe

public void unsubscribe(EventIdentifier[] eventIds)

Un-subscribe from the specified matches. After this no more events associated with these matches will be sent. LiveScout: Expect LiveScoutFeedListener.onMatchStopped(LiveScoutFeed, MatchStopEntity) message in response.

Specified by:

unsubscribe in interface UserRequestManager

Parameters:

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

subscribeToTest

public void subscribeToTest(EventIdentifier eventId,
                            Integer messageDelay,
                            Integer startMessage)

Request a full feed for the match, and then update messages will follow in the same pace as they were sent out live.

This should only be used on the test server.

Specified by:

subscribeToTest in interface LiveScoutFeed

Parameters:

eventId - The id of the event.

messageDelay - Specifies how many milliseconds to wait between sending out each message

startMessage - Specifies which message to open replay on (how far into the match). If startMessage is greater than or equal to the number of messages for the match, a full feed for the finished match is sent out, and no more messages will follow after this.

getTestManager

public TestManager getTestManager()

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

Specified by:

getTestManager in interface UserRequestManager

Returns:

a TestManager implementation

close

public void close()

Closes the communication channel with the live-scout server.

Specified by:

close in interface LiveScoutFeed

dispose

public final void dispose()

Closes the current feed, and disposes all resources associated with it. Once the feed is disposed, it can n longer be used.

Specified by:

dispose in interface LiveScoutFeed