SessionProvider

AI-generated Key Takeaways

• SessionProvider is an abstract base class for creating and managing Cast sessions in Android applications.

• It allows developers to support custom session types beyond the default provided by the Cast SDK.

• Subclasses must implement createSession() to construct new sessions and isSessionRecoverable() to determine if previous sessions can be resumed.

• The SDK uses the provided category string to uniquely identify sessions created by a specific SessionProvider.

• All SessionProvider methods should be called from the main thread to ensure thread safety.

public abstract class SessionProvider extends Object

An abstract base class for performing session construction. The SDK uses a subclass of SessionProvider to construct CastSession internally. If your app wants to support other types of Session then you should subclass this class. Subclasses must implement createSession(String) and isSessionRecoverable(), which will be called by the Cast SDK during the lifecycle of the session. All methods must be called from the main thread.

Protected Constructor Summary

SessionProvider(Context applicationContext, String category) Constructs a SessionProvider with a category string.

Public Method Summary

abstract Session	createSession(String sessionId) Constructs a new Session.
final String	getCategory() Returns the category string for this SessionProvider.
final Context	getContext() Returns the application Context used to construct this instance.
abstract boolean	isSessionRecoverable() Returns true if a previously constructed session can be resumed.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Protected Constructors

protected SessionProvider (Context applicationContext, String category)

Constructs a SessionProvider with a category string. The category uniquely identifies a Session created by this provider.

Parameters

applicationContext	The application Context of the calling app.
category	The category string used to create Session.

Public Methods

public abstract Session createSession (String sessionId)

Constructs a new Session. This method is called by the SDK to create a new session.

public final String getCategory ()

Returns the category string for this SessionProvider.

public final Context getContext ()

Returns the application Context used to construct this instance.

public abstract boolean isSessionRecoverable ()

Returns true if a previously constructed session can be resumed. Subclasses should check any persisted information about the previous session, such as a session ID, and return true only if it is possible to resume that session. This method is called by the SDK when it tries to resume a previously saved session.