Summary: Methods | Inherited Methods

ChooserManager

Kotlin |Java

public class ChooserManager
extends Object

java.lang.Object
↳	android.service.chooser.ChooserManager

Manages the creation, tracking, and retrieval of chooser sessions.

An Interactive Chooser Session allows apps to invoke the system Chooser without entirely covering app UI. Users may interact with both the app and Chooser, while bidirectional communication between the two ensures a consistent state.

Usage Example:

ChooserManager chooserManager = context.getSystemService(ChooserManager.class);
 if (chooserManager == null) {
     // handle the case when the interactive chooser session functionality is not supported.
 }

 // Construct the sharing intent
 Intent targetIntent = new Intent(Intent.ACTION_SEND);
 targetIntent.setType("text/plain");
 targetIntent.putExtra(Intent.EXTRA_TEXT, "This is a message that will be shared.");

 Intent chooserIntent = Intent.createChooser(targetIntent, null);

 // Start a new chooser session
 ChooserSession session = chooserManager.startSession(context, chooserIntent);
 ChooserSessionToken token = session.getToken();
 // Optionally, store the token int an activity saved state to re-associate with the session later

 // Later, to retrieve a session using a token:
 ChooserSessionToken retrievedToken = ... // obtain the stored token
 ChooserSession existingSession = chooserManager.getSession(retrievedToken);
 if (existingSession != null) {
 // Interact with the existing session
 }

See also:

Summary

Public methods
`ChooserSession`	`getSession(ChooserSessionToken token)` Returns a `ChooserSession` associated with this token or `null` if there is no active session.
`ChooserSession`	`startSession(Context context, Intent chooserIntent)` Starts a new interactive Chooser session.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

getSession

Added in Android Baklava

public ChooserSession getSession (ChooserSessionToken token)

Returns a ChooserSession associated with this token or null if there is no active session.

Parameters
`token`	`ChooserSessionToken`: `ChooserSessionToken`. This value cannot be `null`.

Returns
`ChooserSession`

See also:

ChooserSession.getToken()

startSession

Added in Android Baklava

public ChooserSession startSession (Context context, 
                Intent chooserIntent)

Starts a new interactive Chooser session. The method is idempotent and will start Chooser only once.

Parameters

Parameters
`context`	`Context`: This value cannot be `null`.
`chooserIntent`	`Intent`: an `Intent.ACTION_CHOOSER` intent that will be used as a base for the new Chooser session. An interactive Chooser session also supports the following chooser parameters: `Intent.EXTRA_ALTERNATE_INTENTS` `Intent.EXTRA_INITIAL_INTENTS` `Intent.EXTRA_EXCLUDE_COMPONENTS` `Intent.EXTRA_REPLACEMENT_EXTRAS` `Intent.EXTRA_CHOOSER_TARGETS` `Intent.EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER` `Intent.EXTRA_CHOOSER_RESULT_INTENT_SENDER` `Intent.EXTRA_CHOSEN_COMPONENT_INTENT_SENDER` See also `Intent.createChooser(Intent, CharSequence)`. This value cannot be `null`.

context

Context: This value cannot be null.

chooserIntent

Intent: an Intent.ACTION_CHOOSER intent that will be used as a base for the new Chooser session.

An interactive Chooser session also supports the following chooser parameters:

This value cannot be null.

Returns
`ChooserSession`	This value cannot be `null`.