| java.lang.Object | |
| ↳ | android.app.ActivityOptions |
Helper class for building an options Bundle that can be used with
Context.startActivity(Intent, Bundle) and related methods.
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | EXTRA_USAGE_TIME_REPORT |
A long in the extras delivered by requestUsageTimeReport(PendingIntent) that contains
the total time (in ms) the user spent in the app flow.
|
|||||||||
| String | EXTRA_USAGE_TIME_REPORT_PACKAGES |
A Bundle in the extras delivered by requestUsageTimeReport(PendingIntent) that contains
detailed information about the time spent in each package associated with the app;
each key is a package name, whose value is a long containing the time (in ms).
|
|||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Create a basic ActivityOptions that has no special animation associated with it.
| |||||||||||
Create an ActivityOptions specifying an animation where the new
activity is revealed from a small originating area of the screen to
its final full representation.
| |||||||||||
Create an ActivityOptions specifying a custom animation to run when
the activity is displayed.
| |||||||||||
Create an ActivityOptions specifying an animation where the new
activity is scaled from a small originating area of the screen to
its final full representation.
| |||||||||||
Create an ActivityOptions to transition between Activities using cross-Activity scene
animations.
| |||||||||||
Create an ActivityOptions to transition between Activities using cross-Activity scene
animations.
| |||||||||||
If set along with Intent.FLAG_ACTIVITY_NEW_DOCUMENT then the task being launched will not be
presented to the user but will instead be only available through the recents task list.
| |||||||||||
Create an ActivityOptions specifying an animation where a thumbnail
is scaled from a given position to the new activity window that is
being started.
| |||||||||||
Ask the the system track that time the user spends in the app being launched, and
report it back once done.
| |||||||||||
Returns the created options as a Bundle, which can be passed to
Context.startActivity(Intent, Bundle) and related methods.
| |||||||||||
Update the current values in this ActivityOptions from those supplied
in otherOptions.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
A long in the extras delivered by requestUsageTimeReport(PendingIntent) that contains
the total time (in ms) the user spent in the app flow.
A Bundle in the extras delivered by requestUsageTimeReport(PendingIntent) that contains
detailed information about the time spent in each package associated with the app;
each key is a package name, whose value is a long containing the time (in ms).
Create a basic ActivityOptions that has no special animation associated with it. Other options can still be set.
Create an ActivityOptions specifying an animation where the new activity is revealed from a small originating area of the screen to its final full representation.
| source | The View that the new activity is animating from. This defines the coordinate space for startX and startY. |
|---|---|
| startX | The x starting location of the new activity, relative to source. |
| startY | The y starting location of the activity, relative to source. |
| width | The initial width of the new activity. |
| height | The initial height of the new activity. |
Create an ActivityOptions specifying a custom animation to run when the activity is displayed.
| context | Who is defining this. This is the application that the animation resources will be loaded from. |
|---|---|
| enterResId | A resource ID of the animation resource to use for the incoming activity. Use 0 for no animation. |
| exitResId | A resource ID of the animation resource to use for the outgoing activity. Use 0 for no animation. |
Create an ActivityOptions specifying an animation where the new activity is scaled from a small originating area of the screen to its final full representation.
If the Intent this is being used with has not set its
Intent.setSourceBounds,
those bounds will be filled in for you based on the initial
bounds passed in here.
| source | The View that the new activity is animating from. This defines the coordinate space for startX and startY. |
|---|---|
| startX | The x starting location of the new activity, relative to source. |
| startY | The y starting location of the activity, relative to source. |
| width | The initial width of the new activity. |
| height | The initial height of the new activity. |
Create an ActivityOptions to transition between Activities using cross-Activity scene animations. This method carries the position of multiple shared elements to the started Activity. The position of the first element in sharedElements will be used as the epicenter for the exit Transition. The position of the associated shared element in the launched Activity will be the epicenter of its entering Transition.
This requires FEATURE_ACTIVITY_TRANSITIONS to be
enabled on the calling Activity to cause an exit transition. The same must be in
the called Activity to get an entering transition.
| activity | The Activity whose window contains the shared elements. |
|---|---|
| sharedElements | The names of the shared elements to transfer to the called Activity and their associated Views. The Views must each have a unique shared element name. |
Create an ActivityOptions to transition between Activities using cross-Activity scene
animations. This method carries the position of one shared element to the started Activity.
The position of sharedElement will be used as the epicenter for the
exit Transition. The position of the shared element in the launched Activity will be the
epicenter of its entering Transition.
This requires FEATURE_ACTIVITY_TRANSITIONS to be
enabled on the calling Activity to cause an exit transition. The same must be in
the called Activity to get an entering transition.
| activity | The Activity whose window contains the shared elements. |
|---|---|
| sharedElement | The View to transition to the started Activity. |
| sharedElementName | The shared element name as used in the target Activity. This must not be null. |
If set along with Intent.FLAG_ACTIVITY_NEW_DOCUMENT then the task being launched will not be presented to the user but will instead be only available through the recents task list. In addition, the new task wil be affiliated with the launching activity's task. Affiliated tasks are grouped together in the recents task list.
This behavior is not supported for activities with launchMode values of
singleInstance or singleTask.
Create an ActivityOptions specifying an animation where a thumbnail is scaled from a given position to the new activity window that is being started.
If the Intent this is being used with has not set its
Intent.setSourceBounds,
those bounds will be filled in for you based on the initial
thumbnail location and size provided here.
| source | The View that this thumbnail is animating from. This defines the coordinate space for startX and startY. |
|---|---|
| thumbnail | The bitmap that will be shown as the initial thumbnail of the animation. |
| startX | The x starting location of the bitmap, relative to source. |
| startY | The y starting location of the bitmap, relative to source. |
Ask the the system track that time the user spends in the app being launched, and
report it back once done. The report will be sent to the given receiver, with
the extras EXTRA_USAGE_TIME_REPORT and EXTRA_USAGE_TIME_REPORT_PACKAGES
filled in.
The time interval tracked is from launching this activity until the user leaves that activity's flow. They are considered to stay in the flow as long as new activities are being launched or returned to from the original flow, even if this crosses package or task boundaries. For example, if the originator starts an activity to view an image, and while there the user selects to share, which launches their email app in a new task, and they complete the share, the time during that entire operation will be included until they finally hit back from the original image viewer activity.
The user is considered to complete a flow once they switch to another activity that is not part of the tracked flow. This may happen, for example, by using the notification shade, launcher, or recents to launch or switch to another app. Simply going in to these navigation elements does not break the flow (although the launcher and recents stops time tracking of the session); it is the act of going somewhere else that completes the tracking.
| receiver | A broadcast receiver that willl receive the report. |
|---|
Returns the created options as a Bundle, which can be passed to
Context.startActivity(Intent, Bundle) and related methods.
Note that the returned Bundle is still owned by the ActivityOptions
object; you must not modify it, but can supply it to the startActivity
methods that take an options Bundle.
Update the current values in this ActivityOptions from those supplied in otherOptions. Any values defined in otherOptions replace those in the base options.
Developers