public class Intent extends Object implements Parcelable, Cloneable
startActivity
to
launch an Activity
,
broadcastIntent
to
send it to any interested BroadcastReceiver
components,
and Context.startService(android.content.Intent)
or
Context.bindService(android.content.Intent, android.content.ServiceConnection, int)
to communicate with a
background Service
.
An Intent provides a facility for performing late runtime binding between the code in different applications. Its most significant use is in the launching of activities, where it can be thought of as the glue between activities. It is basically a passive data structure holding an abstract description of an action to be performed.
For information about how to create and resolve intents, read the Intents and Intent Filters developer guide.
The primary pieces of information in an intent are:
action -- The general action to be performed, such as
ACTION_VIEW
, ACTION_EDIT
, ACTION_MAIN
,
etc.
data -- The data to operate on, such as a person record
in the contacts database, expressed as a Uri
.
Some examples of action/data pairs are:
ACTION_VIEW
content://contacts/people/1 -- Display
information about the person whose identifier is "1".
ACTION_DIAL
content://contacts/people/1 -- Display
the phone dialer with the person filled in.
ACTION_VIEW
tel:123 -- Display
the phone dialer with the given number filled in. Note how the
VIEW action does what what is considered the most reasonable thing for
a particular URI.
ACTION_DIAL
tel:123 -- Display
the phone dialer with the given number filled in.
ACTION_EDIT
content://contacts/people/1 -- Edit
information about the person whose identifier is "1".
ACTION_VIEW
content://contacts/people/ -- Display
a list of people, which the user can browse through. This example is a
typical top-level entry into the Contacts application, showing you the
list of people. Selecting a particular person to view would result in a
new intent { ACTION_VIEW
content://contacts/N }
being used to start an activity to display that person.
In addition to these primary attributes, there are a number of secondary attributes that you can also include with an intent:
category -- Gives additional information about the action
to execute. For example, CATEGORY_LAUNCHER
means it should
appear in the Launcher as a top-level application, while
CATEGORY_ALTERNATIVE
means it should be included in a list
of alternative actions the user can perform on a piece of data.
type -- Specifies an explicit type (a MIME type) of the intent data. Normally the type is inferred from the data itself. By setting this attribute, you disable that evaluation and force an explicit type.
component -- Specifies an explicit name of a component class to use for the intent. Normally this is determined by looking at the other information in the intent (the action, data/type, and categories) and matching that with a component that can handle it. If this attribute is set then none of the evaluation is performed, and this component is used exactly as is. By specifying this attribute, all of the other Intent attributes become optional.
extras -- This is a Bundle
of any additional information.
This can be used to provide extended information to the component.
For example, if we have a action to send an e-mail message, we could
also include extra pieces of data here to supply a subject, body,
etc.
Here are some examples of other operations you can specify as intents using these additional parameters:
ACTION_MAIN
with category CATEGORY_HOME
--
Launch the home screen.
ACTION_GET_CONTENT
with MIME type
vnd.android.cursor.item/phone
-- Display the list of people's phone numbers, allowing the user to
browse through them and pick one and return it to the parent activity.
ACTION_GET_CONTENT
with MIME type
*/* and category CATEGORY_OPENABLE
-- Display all pickers for data that can be opened with
ContentResolver.openInputStream()
,
allowing the user to pick one of them and then some data inside of it
and returning the resulting URI to the caller. This can be used,
for example, in an e-mail application to allow the user to pick some
data to include as an attachment.
There are a variety of standard Intent action and category constants
defined in the Intent class, but applications can also define their own.
These strings use java style scoping, to ensure they are unique -- for
example, the standard ACTION_VIEW
is called
"android.intent.action.VIEW".
Put together, the set of actions, data types, categories, and extra data defines a language for the system allowing for the expression of phrases such as "call john smith's cell". As applications are added to the system, they can extend this language by adding new actions, types, and categories, or they can modify the behavior of existing phrases by supplying their own activities that handle them.
There are two primary forms of intents you will use.
Explicit Intents have specified a component (via
setComponent(android.content.ComponentName)
or setClass(android.content.Context, java.lang.Class<?>)
), which provides the exact
class to be run. Often these will not include any other information,
simply being a way for an application to launch various internal
activities it has as the user interacts with the application.
Implicit Intents have not specified a component; instead, they must include enough information for the system to determine which of the available components is best to run for that intent.
When using implicit intents, given such an arbitrary intent we need to
know what to do with it. This is handled by the process of Intent
resolution, which maps an Intent to an Activity
,
BroadcastReceiver
, or Service
(or sometimes two or
more activities/receivers) that can handle it.
The intent resolution mechanism basically revolves around matching an
Intent against all of the <intent-filter> descriptions in the
installed application packages. (Plus, in the case of broadcasts, any BroadcastReceiver
objects explicitly registered with Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
.) More
details on this can be found in the documentation on the IntentFilter
class.
There are three pieces of information in the Intent that are used for
resolution: the action, type, and category. Using this information, a query
is done on the PackageManager
for a component that can handle the
intent. The appropriate component is determined based on the intent
information supplied in the AndroidManifest.xml
file as
follows:
The action, if given, must be listed by the component as one it handles.
The type is retrieved from the Intent's data, if not already supplied in the Intent. Like the action, if a type is included in the intent (either explicitly or implicitly in its data), then this must be listed by the component as one it handles.
content:
URI and where no explicit
type is included in the Intent, instead the scheme of the
intent data (such as http:
or mailto:
) is
considered. Again like the action, if we are matching a scheme it
must be listed by the component as one it can handle.
The categories, if supplied, must all be listed
by the activity as categories it handles. That is, if you include
the categories CATEGORY_LAUNCHER
and
CATEGORY_ALTERNATIVE
, then you will only resolve to components
with an intent that lists both of those categories.
Activities will very often need to support the
CATEGORY_DEFAULT
so that they can be found by
Context.startActivity()
.
For example, consider the Note Pad sample application that allows user to browse through a list of notes data and view details about individual items. Text in italics indicate places were you would replace a name with one specific to your own package.
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.notepad"> <application android:icon="@drawable/app_notes" android:label="@string/app_name"> <provider android:authorities="com.google.provider.NotePad" /> <activity android:label="@string/title_notes_list"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter> <action android:name="android.intent.action.VIEW" /> <action android:name="android.intent.action.EDIT" /> <action android:name="android.intent.action.PICK" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" /> </intent-filter> <intent-filter> <action android:name="android.intent.action.GET_CONTENT" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter> </activity> <activity android:label="@string/title_note"> <intent-filter android:label="@string/resolve_edit"> <action android:name="android.intent.action.VIEW" /> <action android:name="android.intent.action.EDIT" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter> <intent-filter> <action android:name="android.intent.action.INSERT" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" /> </intent-filter> </activity> <activity android:label="@string/title_edit_title" android:theme="@android:style/Theme.Dialog"> <intent-filter android:label="@string/resolve_title"> <action android:name="com.android.notepad.action.EDIT_TITLE" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.ALTERNATIVE" /> <category android:name="android.intent.category.SELECTED_ALTERNATIVE" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter> </activity> </application> </manifest>
The first activity,
com.android.notepad.NotesList
, serves as our main
entry into the app. It can do three things as described by its three intent
templates:
<intent-filter> <action android:name="android.intent.action.MAIN
" /> <category android:name="android.intent.category.LAUNCHER
" /> </intent-filter>
This provides a top-level entry into the NotePad application: the standard MAIN action is a main entry point (not requiring any other information in the Intent), and the LAUNCHER category says that this entry point should be listed in the application launcher.
<intent-filter> <action android:name="android.intent.action.VIEW
" /> <action android:name="android.intent.action.EDIT
" /> <action android:name="android.intent.action.PICK
" /> <category android:name="android.intent.category.DEFAULT
" /> <data mimeType:name="vnd.android.cursor.dir/vnd.google.note" /> </intent-filter>
This declares the things that the activity can do on a directory of
notes. The type being supported is given with the <type> tag, where
vnd.android.cursor.dir/vnd.google.note
is a URI from which
a Cursor of zero or more items (vnd.android.cursor.dir
) can
be retrieved which holds our note pad data (vnd.google.note
).
The activity allows the user to view or edit the directory of data (via
the VIEW and EDIT actions), or to pick a particular note and return it
to the caller (via the PICK action). Note also the DEFAULT category
supplied here: this is required for the
Context.startActivity
method to resolve your
activity when its component name is not explicitly specified.
<intent-filter> <action android:name="android.intent.action.GET_CONTENT
" /> <category android:name="android.intent.category.DEFAULT
" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter>
This filter describes the ability return to the caller a note selected by
the user without needing to know where it came from. The data type
vnd.android.cursor.item/vnd.google.note
is a URI from which
a Cursor of exactly one (vnd.android.cursor.item
) item can
be retrieved which contains our note pad data (vnd.google.note
).
The GET_CONTENT action is similar to the PICK action, where the activity
will return to its caller a piece of data selected by the user. Here,
however, the caller specifies the type of data they desire instead of
the type of data the user will be picking from.
Given these capabilities, the following intents will resolve to the NotesList activity:
{ action=android.app.action.MAIN } matches all of the activities that can be used as top-level entry points into an application.
{ action=android.app.action.MAIN, category=android.app.category.LAUNCHER } is the actual intent used by the Launcher to populate its top-level list.
{ action=android.intent.action.VIEW data=content://com.google.provider.NotePad/notes } displays a list of all the notes under "content://com.google.provider.NotePad/notes", which the user can browse through and see the details on.
{ action=android.app.action.PICK data=content://com.google.provider.NotePad/notes } provides a list of the notes under "content://com.google.provider.NotePad/notes", from which the user can pick a note whose data URL is returned back to the caller.
{ action=android.app.action.GET_CONTENT type=vnd.android.cursor.item/vnd.google.note } is similar to the pick action, but allows the caller to specify the kind of data they want back so that the system can find the appropriate activity to pick something of that data type.
The second activity,
com.android.notepad.NoteEditor
, shows the user a single
note entry and allows them to edit it. It can do two things as described
by its two intent templates:
<intent-filter android:label="@string/resolve_edit"> <action android:name="android.intent.action.VIEW
" /> <action android:name="android.intent.action.EDIT
" /> <category android:name="android.intent.category.DEFAULT
" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter>
The first, primary, purpose of this activity is to let the user interact
with a single note, as decribed by the MIME type
vnd.android.cursor.item/vnd.google.note
. The activity can
either VIEW a note or allow the user to EDIT it. Again we support the
DEFAULT category to allow the activity to be launched without explicitly
specifying its component.
<intent-filter> <action android:name="android.intent.action.INSERT
" /> <category android:name="android.intent.category.DEFAULT
" /> <data android:mimeType="vnd.android.cursor.dir/vnd.google.note" /> </intent-filter>
The secondary use of this activity is to insert a new note entry into an existing directory of notes. This is used when the user creates a new note: the INSERT action is executed on the directory of notes, causing this activity to run and have the user create the new note data which it then adds to the content provider.
Given these capabilities, the following intents will resolve to the NoteEditor activity:
{ action=android.intent.action.VIEW data=content://com.google.provider.NotePad/notes/{ID} } shows the user the content of note {ID}.
{ action=android.app.action.EDIT data=content://com.google.provider.NotePad/notes/{ID} } allows the user to edit the content of note {ID}.
{ action=android.app.action.INSERT data=content://com.google.provider.NotePad/notes } creates a new, empty note in the notes list at "content://com.google.provider.NotePad/notes" and allows the user to edit it. If they keep their changes, the URI of the newly created note is returned to the caller.
The last activity,
com.android.notepad.TitleEditor
, allows the user to
edit the title of a note. This could be implemented as a class that the
application directly invokes (by explicitly setting its component in
the Intent), but here we show a way you can publish alternative
operations on existing data:
<intent-filter android:label="@string/resolve_title"> <action android:name="com.android.notepad.action.EDIT_TITLE" /> <category android:name="android.intent.category.DEFAULT
" /> <category android:name="android.intent.category.ALTERNATIVE
" /> <category android:name="android.intent.category.SELECTED_ALTERNATIVE
" /> <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> </intent-filter>
In the single intent template here, we
have created our own private action called
com.android.notepad.action.EDIT_TITLE
which means to
edit the title of a note. It must be invoked on a specific note
(data type vnd.android.cursor.item/vnd.google.note
) like the previous
view and edit actions, but here displays and edits the title contained
in the note data.
In addition to supporting the default category as usual, our title editor
also supports two other standard categories: ALTERNATIVE and
SELECTED_ALTERNATIVE. Implementing
these categories allows others to find the special action it provides
without directly knowing about it, through the
PackageManager.queryIntentActivityOptions(android.content.ComponentName, android.content.Intent[], android.content.Intent, int)
method, or
more often to build dynamic menu items with
Menu.addIntentOptions(int, int, int, android.content.ComponentName, android.content.Intent[], android.content.Intent, int, android.view.MenuItem[])
. Note that in the intent
template here was also supply an explicit name for the template
(via android:label="@string/resolve_title"
) to better control
what the user sees when presented with this activity as an alternative
action to the data they are viewing.
Given these capabilities, the following intent will resolve to the TitleEditor activity:
{ action=com.android.notepad.action.EDIT_TITLE data=content://com.google.provider.NotePad/notes/{ID} } displays and allows the user to edit the title associated with note {ID}.
These are the current standard actions that Intent defines for launching
activities (usually through Context.startActivity(android.content.Intent)
. The most
important, and by far most frequently used, are ACTION_MAIN
and
ACTION_EDIT
.
ACTION_MAIN
ACTION_VIEW
ACTION_ATTACH_DATA
ACTION_EDIT
ACTION_PICK
ACTION_CHOOSER
ACTION_GET_CONTENT
ACTION_DIAL
ACTION_CALL
ACTION_SEND
ACTION_SENDTO
ACTION_ANSWER
ACTION_INSERT
ACTION_DELETE
ACTION_RUN
ACTION_SYNC
ACTION_PICK_ACTIVITY
ACTION_SEARCH
ACTION_WEB_SEARCH
ACTION_FACTORY_TEST
These are the current standard actions that Intent defines for receiving
broadcasts (usually through Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
or a
<receiver> tag in a manifest).
ACTION_TIME_TICK
ACTION_TIME_CHANGED
ACTION_TIMEZONE_CHANGED
ACTION_BOOT_COMPLETED
ACTION_PACKAGE_ADDED
ACTION_PACKAGE_CHANGED
ACTION_PACKAGE_REMOVED
ACTION_PACKAGE_RESTARTED
ACTION_PACKAGE_DATA_CLEARED
ACTION_UID_REMOVED
ACTION_BATTERY_CHANGED
ACTION_POWER_CONNECTED
ACTION_POWER_DISCONNECTED
ACTION_SHUTDOWN
These are the current standard categories that can be used to further
clarify an Intent via addCategory(java.lang.String)
.
CATEGORY_DEFAULT
CATEGORY_BROWSABLE
CATEGORY_TAB
CATEGORY_ALTERNATIVE
CATEGORY_SELECTED_ALTERNATIVE
CATEGORY_LAUNCHER
CATEGORY_INFO
CATEGORY_HOME
CATEGORY_PREFERENCE
CATEGORY_TEST
CATEGORY_CAR_DOCK
CATEGORY_DESK_DOCK
CATEGORY_LE_DESK_DOCK
CATEGORY_HE_DESK_DOCK
CATEGORY_CAR_MODE
CATEGORY_APP_MARKET
These are the current standard fields that can be used as extra data via
putExtra(java.lang.String, boolean)
.
EXTRA_ALARM_COUNT
EXTRA_BCC
EXTRA_CC
EXTRA_CHANGED_COMPONENT_NAME
EXTRA_DATA_REMOVED
EXTRA_DOCK_STATE
EXTRA_DOCK_STATE_HE_DESK
EXTRA_DOCK_STATE_LE_DESK
EXTRA_DOCK_STATE_CAR
EXTRA_DOCK_STATE_DESK
EXTRA_DOCK_STATE_UNDOCKED
EXTRA_DONT_KILL_APP
EXTRA_EMAIL
EXTRA_INITIAL_INTENTS
EXTRA_INTENT
EXTRA_KEY_EVENT
EXTRA_ORIGINATING_URI
EXTRA_PHONE_NUMBER
EXTRA_REFERRER
EXTRA_REMOTE_INTENT_TOKEN
EXTRA_REPLACING
EXTRA_SHORTCUT_ICON
EXTRA_SHORTCUT_ICON_RESOURCE
EXTRA_SHORTCUT_INTENT
EXTRA_STREAM
EXTRA_SHORTCUT_NAME
EXTRA_SUBJECT
EXTRA_TEMPLATE
EXTRA_TEXT
EXTRA_TITLE
EXTRA_UID
These are the possible flags that can be used in the Intent via
setFlags(int)
and addFlags(int)
. See setFlags(int)
for a list
of all possible flags.
Modifier and Type | Class and Description |
---|---|
static class |
Intent.FilterComparison
Wrapper class holding an Intent and implementing comparisons on it for
the purpose of filtering.
|
static class |
Intent.ShortcutIconResource
Represents a shortcut/live folder icon resource.
|
Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>
Modifier and Type | Field and Description |
---|---|
static String |
ACTION_ADVANCED_SETTINGS_CHANGED
Broadcast Action: The user has switched on advanced settings in the settings app:
|
static String |
ACTION_AIRPLANE_MODE_CHANGED
Broadcast Action: The user has switched the phone into or out of Airplane Mode.
|
static String |
ACTION_ALARM_CHANGED
Alarm Changed Action: This is broadcast when the AlarmClock
application's alarm is set or unset.
|
static String |
ACTION_ALL_APPS
Activity Action: List all available applications
|
static String |
ACTION_ANALOG_AUDIO_DOCK_PLUG
Broadcast Action: An analog audio speaker/headset plugged in or unplugged.
|
static String |
ACTION_ANSWER
Activity Action: Handle an incoming phone call.
|
static String |
ACTION_APP_ERROR
Activity Action: The user pressed the "Report" button in the crash/ANR dialog.
|
static String |
ACTION_ASSIST
Activity Action: Perform assist action.
|
static String |
ACTION_ATTACH_DATA
Used to indicate that some piece of data should be attached to some other
place.
|
static String |
ACTION_BATTERY_CHANGED
Broadcast Action: This is a sticky broadcast containing the
charging state, level, and other information about the battery.
|
static String |
ACTION_BATTERY_LOW
Broadcast Action: Indicates low battery condition on the device.
|
static String |
ACTION_BATTERY_OKAY
Broadcast Action: Indicates the battery is now okay after being low.
|
static String |
ACTION_BOOT_COMPLETED
Broadcast Action: This is broadcast once, after the system has finished
booting.
|
static String |
ACTION_BUG_REPORT
Activity Action: Show activity for reporting a bug.
|
static String |
ACTION_CALL
Activity Action: Perform a call to someone specified by the data.
|
static String |
ACTION_CALL_BUTTON
Activity Action: The user pressed the "call" button to go to the dialer
or other appropriate UI for placing a call.
|
static String |
ACTION_CALL_EMERGENCY
Activity Action: Perform a call to an emergency number specified by the
data.
|
static String |
ACTION_CALL_PRIVILEGED
Activity action: Perform a call to any number (emergency or not)
specified by the data.
|
static String |
ACTION_CAMERA_BUTTON
Broadcast Action: The "Camera Button" was pressed.
|
static String |
ACTION_CHOOSER
Activity Action: Display an activity chooser, allowing the user to pick
what they want to before proceeding.
|
static String |
ACTION_CLEAR_DNS_CACHE
Clear DNS Cache Action: This is broadcast when networks have changed and old
DNS entries should be tossed.
|
static String |
ACTION_CLOSE_SYSTEM_DIALOGS
Broadcast Action: This is broadcast when a user action should request a
temporary system dialog to dismiss.
|
static String |
ACTION_CONFIGURATION_CHANGED
Broadcast Action: The current device
Configuration
(orientation, locale, etc) has changed. |
static String |
ACTION_CREATE_SHORTCUT
Activity Action: Creates a shortcut.
|
static String |
ACTION_DATE_CHANGED
Broadcast Action: The date has changed.
|
static String |
ACTION_DEFAULT
A synonym for
ACTION_VIEW , the "standard" action that is
performed on a piece of data. |
static String |
ACTION_DELETE
Activity Action: Delete the given data from its container.
|
static String |
ACTION_DEVICE_STORAGE_FULL
Broadcast Action: A sticky broadcast that indicates a memory full
condition on the device.
|
static String |
ACTION_DEVICE_STORAGE_LOW
Broadcast Action: A sticky broadcast that indicates low memory
condition on the device
This is a protected intent that can only be sent by the system. |
static String |
ACTION_DEVICE_STORAGE_NOT_FULL
Broadcast Action: Indicates memory full condition on the device
no longer exists.
|
static String |
ACTION_DEVICE_STORAGE_OK
Broadcast Action: Indicates low memory condition on the device no longer exists
This is a protected intent that can only be sent by the system. |
static String |
ACTION_DIAL
Activity Action: Dial a number as specified by the data.
|
static String |
ACTION_DIGITAL_AUDIO_DOCK_PLUG
Broadcast Action: A digital audio speaker/headset plugged in or unplugged.
|
static String |
ACTION_DOCK_EVENT
Broadcast Action: A sticky broadcast for changes in the physical
docking state of the device.
|
static String |
ACTION_DREAMING_STARTED
Broadcast Action: Sent after the system starts dreaming.
|
static String |
ACTION_DREAMING_STOPPED
Broadcast Action: Sent after the system stops dreaming.
|
static String |
ACTION_EDIT
Activity Action: Provide explicit editable access to the given data.
|
static String |
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
Broadcast Action: Resources for a set of packages (which were
previously unavailable) are currently
available since the media on which they exist is available.
|
static String |
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
Broadcast Action: Resources for a set of packages are currently
unavailable since the media on which they exist is unavailable.
|
static String |
ACTION_FACTORY_TEST
Activity Action: Main entry point for factory tests.
|
static String |
ACTION_GET_CONTENT
Activity Action: Allow the user to select a particular kind of data and
return it.
|
static String |
ACTION_GTALK_SERVICE_CONNECTED
Broadcast Action: A GTalk connection has been established.
|
static String |
ACTION_GTALK_SERVICE_DISCONNECTED
Broadcast Action: A GTalk connection has been disconnected.
|
static String |
ACTION_HDMI_AUDIO_PLUG
Broadcast Action: A HMDI cable was plugged or unplugged
|
static String |
ACTION_HEADSET_PLUG
Broadcast Action: Wired Headset plugged in or unplugged.
|
static String |
ACTION_INPUT_METHOD_CHANGED
Broadcast Action: An input method has been changed.
|
static String |
ACTION_INSERT
Activity Action: Insert an empty item into the given container.
|
static String |
ACTION_INSERT_OR_EDIT
Activity Action: Pick an existing item, or insert a new item, and then edit it.
|
static String |
ACTION_INSTALL_PACKAGE
Activity Action: Launch application installer.
|
static String |
ACTION_LOCALE_CHANGED
Broadcast Action: The current device's locale has changed.
|
static String |
ACTION_MAIN
Activity Action: Start as a main entry point, does not expect to
receive data.
|
static String |
ACTION_MANAGE_NETWORK_USAGE
Activity Action: Show settings for managing network data usage of a
specific application.
|
static String |
ACTION_MANAGE_PACKAGE_STORAGE
Broadcast Action: Indicates low memory condition notification acknowledged by user
and package management should be started.
|
static String |
ACTION_MEDIA_BAD_REMOVAL
Broadcast Action: External media was removed from SD card slot, but mount point was not unmounted.
|
static String |
ACTION_MEDIA_BUTTON
Broadcast Action: The "Media Button" was pressed.
|
static String |
ACTION_MEDIA_CHECKING
Broadcast Action: External media is present, and being disk-checked
The path to the mount point for the checking media is contained in the Intent.mData field.
|
static String |
ACTION_MEDIA_EJECT
Broadcast Action: User has expressed the desire to remove the external storage media.
|
static String |
ACTION_MEDIA_MOUNTED
Broadcast Action: External media is present and mounted at its mount point.
|
static String |
ACTION_MEDIA_NOFS
Broadcast Action: External media is present, but is using an incompatible fs (or is blank)
The path to the mount point for the checking media is contained in the Intent.mData field.
|
static String |
ACTION_MEDIA_REMOVED
Broadcast Action: External media has been removed.
|
static String |
ACTION_MEDIA_SCANNER_FINISHED
Broadcast Action: The media scanner has finished scanning a directory.
|
static String |
ACTION_MEDIA_SCANNER_SCAN_FILE
Broadcast Action: Request the media scanner to scan a file and add it to the media database.
|
static String |
ACTION_MEDIA_SCANNER_STARTED
Broadcast Action: The media scanner has started scanning a directory.
|
static String |
ACTION_MEDIA_SHARED
Broadcast Action: External media is unmounted because it is being shared via USB mass storage.
|
static String |
ACTION_MEDIA_UNMOUNTABLE
Broadcast Action: External media is present but cannot be mounted.
|
static String |
ACTION_MEDIA_UNMOUNTED
Broadcast Action: External media is present, but not mounted at its mount point.
|
static String |
ACTION_MEDIA_UNSHARED
Broadcast Action: External media is no longer being shared via USB mass storage.
|
static String |
ACTION_MY_PACKAGE_REPLACED
Broadcast Action: A new version of your application has been installed
over an existing one.
|
static String |
ACTION_NEW_OUTGOING_CALL
Broadcast Action: An outgoing call is about to be placed.
|
static String |
ACTION_PACKAGE_ADDED
Broadcast Action: A new application package has been installed on the
device.
|
static String |
ACTION_PACKAGE_CHANGED
Broadcast Action: An existing application package has been changed (e.g.
|
static String |
ACTION_PACKAGE_DATA_CLEARED
Broadcast Action: The user has cleared the data of a package.
|
static String |
ACTION_PACKAGE_FIRST_LAUNCH
Broadcast Action: Sent to the installer package of an application
when that application is first launched (that is the first time it
is moved out of the stopped state).
|
static String |
ACTION_PACKAGE_FULLY_REMOVED
Broadcast Action: An existing application package has been completely
removed from the device.
|
static String |
ACTION_PACKAGE_INSTALL
Deprecated.
This constant has never been used.
|
static String |
ACTION_PACKAGE_NEEDS_VERIFICATION
Broadcast Action: Sent to the system package verifier when a package
needs to be verified.
|
static String |
ACTION_PACKAGE_REMOVED
Broadcast Action: An existing application package has been removed from
the device.
|
static String |
ACTION_PACKAGE_REPLACED
Broadcast Action: A new version of an application package has been
installed, replacing an existing version that was previously installed.
|
static String |
ACTION_PACKAGE_RESTARTED
Broadcast Action: The user has restarted a package, and all of its
processes have been killed.
|
static String |
ACTION_PACKAGE_VERIFIED
Broadcast Action: Sent to the system package verifier when a package is
verified.
|
static String |
ACTION_PASTE
Activity Action: Create a new item in the given container, initializing it
from the current contents of the clipboard.
|
static String |
ACTION_PICK
Activity Action: Pick an item from the data, returning what was selected.
|
static String |
ACTION_PICK_ACTIVITY
Activity Action: Pick an activity given an intent, returning the class
selected.
|
static String |
ACTION_POWER_CONNECTED
Broadcast Action: External power has been connected to the device.
|
static String |
ACTION_POWER_DISCONNECTED
Broadcast Action: External power has been removed from the device.
|
static String |
ACTION_POWER_USAGE_SUMMARY
Activity Action: Show power usage information to the user.
|
static String |
ACTION_PRE_BOOT_COMPLETED
Broadcast Action: hook for permforming cleanup after a system update.
|
static String |
ACTION_PROVIDER_CHANGED
Broadcast Action: Some content providers have parts of their namespace
where they publish new events or items that the user may be especially
interested in.
|
static String |
ACTION_QUERY_PACKAGE_RESTART |
static String |
ACTION_QUICK_CLOCK
Sent when the user taps on the clock widget in the system's "quick settings" area.
|
static String |
ACTION_REBOOT
Broadcast Action: Have the device reboot.
|
static String |
ACTION_REMOTE_INTENT
Broadcast Action: a remote intent is to be broadcasted.
|
static String |
ACTION_REQUEST_SHUTDOWN
Activity Action: Start this activity to request system shutdown.
|
static String |
ACTION_RUN
Activity Action: Run the data, whatever that means.
|
static String |
ACTION_SCREEN_OFF
Broadcast Action: Sent after the screen turns off.
|
static String |
ACTION_SCREEN_ON
Broadcast Action: Sent after the screen turns on.
|
static String |
ACTION_SEARCH
Activity Action: Perform a search.
|
static String |
ACTION_SEARCH_LONG_PRESS
Activity Action: Start action associated with long pressing on the
search key.
|
static String |
ACTION_SEND
Activity Action: Deliver some data to someone else.
|
static String |
ACTION_SEND_MULTIPLE
Activity Action: Deliver multiple data to someone else.
|
static String |
ACTION_SENDTO
Activity Action: Send a message to someone specified by the data.
|
static String |
ACTION_SET_WALLPAPER
Activity Action: Show settings for choosing wallpaper
|
static String |
ACTION_SHUTDOWN
Broadcast Action: Device is shutting down.
|
static String |
ACTION_SYNC
Activity Action: Perform a data synchronization.
|
static String |
ACTION_SYNC_STATE_CHANGED
Sync State Changed Action: This is broadcast when the sync starts or stops or when one has
been failing for a long time.
|
static String |
ACTION_SYSTEM_TUTORIAL
Activity Action: Start the platform-defined tutorial
|
static String |
ACTION_TIME_CHANGED
Broadcast Action: The time was set.
|
static String |
ACTION_TIME_TICK
Broadcast Action: The current time has changed.
|
static String |
ACTION_TIMEZONE_CHANGED
Broadcast Action: The timezone has changed.
|
static String |
ACTION_UID_REMOVED
Broadcast Action: A user ID has been removed from the system.
|
static String |
ACTION_UMS_CONNECTED
Deprecated.
replaced by android.os.storage.StorageEventListener
|
static String |
ACTION_UMS_DISCONNECTED
Deprecated.
replaced by android.os.storage.StorageEventListener
|
static String |
ACTION_UNINSTALL_PACKAGE
Activity Action: Launch application uninstaller.
|
static String |
ACTION_UPGRADE_SETUP
Activity Action: Setup wizard to launch after a platform update.
|
static String |
ACTION_USB_AUDIO_ACCESSORY_PLUG
Broadcast Action: A USB audio accessory was plugged in or unplugged.
|
static String |
ACTION_USB_AUDIO_DEVICE_PLUG
Broadcast Action: A USB audio device was plugged in or unplugged.
|
static String |
ACTION_USER_ADDED
Broadcast sent to the system when a user is added.
|
static String |
ACTION_USER_BACKGROUND
Sent when a user switch is happening, causing the process's user to be
sent to the background.
|
static String |
ACTION_USER_FOREGROUND
Sent when a user switch is happening, causing the process's user to be
brought to the foreground.
|
static String |
ACTION_USER_INFO_CHANGED
Broadcast sent to the system when a user's information changes.
|
static String |
ACTION_USER_INITIALIZE
Sent the first time a user is starting, to allow system apps to
perform one time initialization.
|
static String |
ACTION_USER_PRESENT
Broadcast Action: Sent when the user is present after device wakes up (e.g when the
keyguard is gone).
|
static String |
ACTION_USER_REMOVED
Broadcast sent to the system when a user is removed.
|
static String |
ACTION_USER_STARTED
Broadcast sent by the system when a user is started.
|
static String |
ACTION_USER_STARTING
Broadcast sent when a user is in the process of starting.
|
static String |
ACTION_USER_STOPPED
Broadcast sent to the system when a user is stopped.
|
static String |
ACTION_USER_STOPPING
Broadcast sent when a user is going to be stopped.
|
static String |
ACTION_USER_SWITCHED
Broadcast sent to the system when the user switches.
|
static String |
ACTION_VIEW
Activity Action: Display the data to the user.
|
static String |
ACTION_VOICE_COMMAND
Activity Action: Start Voice Command.
|
static String |
ACTION_WALLPAPER_CHANGED
Deprecated.
Modern applications should use
WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER to have the wallpaper
shown behind their UI, rather than watching for this broadcast and
rendering the wallpaper on their own. |
static String |
ACTION_WEB_SEARCH
Activity Action: Perform a web search.
|
static String |
CATEGORY_ALTERNATIVE
Set if the activity should be considered as an alternative action to
the data the user is currently viewing.
|
static String |
CATEGORY_APP_BROWSER
Used with
ACTION_MAIN to launch the browser application. |
static String |
CATEGORY_APP_CALCULATOR
Used with
ACTION_MAIN to launch the calculator application. |
static String |
CATEGORY_APP_CALENDAR
Used with
ACTION_MAIN to launch the calendar application. |
static String |
CATEGORY_APP_CONTACTS
Used with
ACTION_MAIN to launch the contacts application. |
static String |
CATEGORY_APP_EMAIL
Used with
ACTION_MAIN to launch the email application. |
static String |
CATEGORY_APP_GALLERY
Used with
ACTION_MAIN to launch the gallery application. |
static String |
CATEGORY_APP_MAPS
Used with
ACTION_MAIN to launch the maps application. |
static String |
CATEGORY_APP_MARKET
This activity allows the user to browse and download new applications.
|
static String |
CATEGORY_APP_MESSAGING
Used with
ACTION_MAIN to launch the messaging application. |
static String |
CATEGORY_APP_MUSIC
Used with
ACTION_MAIN to launch the music application. |
static String |
CATEGORY_BROWSABLE
Activities that can be safely invoked from a browser must support this
category.
|
static String |
CATEGORY_CAR_DOCK
An activity to run when device is inserted into a car dock.
|
static String |
CATEGORY_CAR_MODE
Used to indicate that the activity can be used in a car environment.
|
static String |
CATEGORY_DEFAULT
Set if the activity should be an option for the default action
(center press) to perform on a piece of data.
|
static String |
CATEGORY_DESK_DOCK
An activity to run when device is inserted into a car dock.
|
static String |
CATEGORY_DEVELOPMENT_PREFERENCE
This activity is a development preference panel.
|
static String |
CATEGORY_EMBED
Capable of running inside a parent activity container.
|
static String |
CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST
To be used as code under test for framework instrumentation tests.
|
static String |
CATEGORY_HE_DESK_DOCK
An activity to run when device is inserted into a digital (high end) dock.
|
static String |
CATEGORY_HOME
This is the home activity, that is the first activity that is displayed
when the device boots.
|
static String |
CATEGORY_INFO
Provides information about the package it is in; typically used if
a package does not contain a
CATEGORY_LAUNCHER to provide
a front-door to the user without having to be shown in the all apps list. |
static String |
CATEGORY_LAUNCHER
Should be displayed in the top-level launcher.
|
static String |
CATEGORY_LE_DESK_DOCK
An activity to run when device is inserted into a analog (low end) dock.
|
static String |
CATEGORY_MONKEY
This activity may be exercised by the monkey or other automated test tools.
|
static String |
CATEGORY_OPENABLE
Used to indicate that a GET_CONTENT intent only wants URIs that can be opened with
ContentResolver.openInputStream.
|
static String |
CATEGORY_PREFERENCE
This activity is a preference panel.
|
static String |
CATEGORY_SAMPLE_CODE
To be used as a sample code example (not part of the normal user
experience).
|
static String |
CATEGORY_SELECTED_ALTERNATIVE
Set if the activity should be considered as an alternative selection
action to the data the user has currently selected.
|
static String |
CATEGORY_TAB
Intended to be used as a tab inside of a containing TabActivity.
|
static String |
CATEGORY_TEST
To be used as a test (not part of the normal user experience).
|
static String |
CATEGORY_UNIT_TEST
To be used as a unit test (run through the Test Harness).
|
static Parcelable.Creator<Intent> |
CREATOR |
static String |
EXTRA_ALARM_COUNT
Used as an int extra field in
AlarmManager intents
to tell the application being invoked how many pending alarms are being
delievered with the intent. |
static String |
EXTRA_ALLOW_REPLACE
Deprecated.
As of
Build.VERSION_CODES.JELLY_BEAN , Android
will no longer show an interstitial message about updating existing
applications so this is no longer needed. |
static String |
EXTRA_BCC
A String[] holding e-mail addresses that should be blind carbon copied.
|
static String |
EXTRA_BUG_REPORT
Used as a parcelable extra field in
ACTION_APP_ERROR , containing
the bug report. |
static String |
EXTRA_CC
A String[] holding e-mail addresses that should be carbon copied.
|
static String |
EXTRA_CHANGED_COMPONENT_NAME
Deprecated.
See
EXTRA_CHANGED_COMPONENT_NAME_LIST ; this field
will contain only the first name in the list. |
static String |
EXTRA_CHANGED_COMPONENT_NAME_LIST
This field is part of
ACTION_PACKAGE_CHANGED ,
and contains a string array of all of the components that have changed. |
static String |
EXTRA_CHANGED_PACKAGE_LIST
This field is part of
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE ,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains a string array of all of the components that have changed. |
static String |
EXTRA_CHANGED_UID_LIST
This field is part of
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE ,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains an integer array of uids of all of the components
that have changed. |
static String |
EXTRA_CLIENT_INTENT |
static String |
EXTRA_CLIENT_LABEL |
static String |
EXTRA_DATA_REMOVED
Used as a boolean extra field in
ACTION_PACKAGE_REMOVED
intents to indicate whether this represents a full uninstall (removing
both the code and its data) or a partial uninstall (leaving its data,
implying that this is an update). |
static String |
EXTRA_DOCK_STATE
Used as an int extra field in
ACTION_DOCK_EVENT
intents to request the dock state. |
static int |
EXTRA_DOCK_STATE_CAR
Used as an int value for
EXTRA_DOCK_STATE
to represent that the phone is in a car dock. |
static int |
EXTRA_DOCK_STATE_DESK
Used as an int value for
EXTRA_DOCK_STATE
to represent that the phone is in a desk dock. |
static int |
EXTRA_DOCK_STATE_HE_DESK
Used as an int value for
EXTRA_DOCK_STATE
to represent that the phone is in a digital (high end) dock. |
static int |
EXTRA_DOCK_STATE_LE_DESK
Used as an int value for
EXTRA_DOCK_STATE
to represent that the phone is in a analog (low end) dock. |
static int |
EXTRA_DOCK_STATE_UNDOCKED
Used as an int value for
EXTRA_DOCK_STATE
to represent that the phone is not in any dock. |
static String |
EXTRA_DONT_KILL_APP
Used as a boolean extra field in
ACTION_PACKAGE_REMOVED or
ACTION_PACKAGE_CHANGED intents to override the default action
of restarting the application. |
static String |
EXTRA_EMAIL
A String[] holding e-mail addresses that should be delivered to.
|
static String |
EXTRA_HTML_TEXT
A constant String that is associated with the Intent, used with
ACTION_SEND to supply an alternative to EXTRA_TEXT
as HTML formatted text. |
static String |
EXTRA_INITIAL_INTENTS
A Parcelable[] of
Intent or
LabeledIntent objects as set with
putExtra(String, Parcelable[]) of additional activities to place
a the front of the list of choices, when shown to the user with a
ACTION_CHOOSER . |
static String |
EXTRA_INSTALL_RESULT
Package manager install result code.
|
static String |
EXTRA_INSTALLER_PACKAGE_NAME
Used as a string extra field with
ACTION_INSTALL_PACKAGE to install a
package. |
static String |
EXTRA_INTENT
An Intent describing the choices you would like shown with
ACTION_PICK_ACTIVITY . |
static String |
EXTRA_KEY_CONFIRM
Set to true in
ACTION_REQUEST_SHUTDOWN to request confirmation from the user
before shutting down. |
static String |
EXTRA_KEY_EVENT
A
KeyEvent object containing the event that
triggered the creation of the Intent it is in. |
static String |
EXTRA_LOCAL_ONLY
Used to indicate that a
ACTION_GET_CONTENT intent should only return
data that is on the local device. |
static String |
EXTRA_NOT_UNKNOWN_SOURCE
Used as a boolean extra field with
ACTION_INSTALL_PACKAGE to install a
package. |
static String |
EXTRA_ORIGINATING_UID
Used as an int extra field with
ACTION_INSTALL_PACKAGE and
#ACTION_VIEW} to indicate the uid of the package that initiated the install |
static String |
EXTRA_ORIGINATING_URI
Used as a URI extra field with
ACTION_INSTALL_PACKAGE and
ACTION_VIEW to indicate the URI from which the local APK in the Intent
data field originated from. |
static String |
EXTRA_PACKAGES |
static String |
EXTRA_PHONE_NUMBER
A String holding the phone number originally entered in
ACTION_NEW_OUTGOING_CALL , or the actual
number to call in a ACTION_CALL . |
static String |
EXTRA_REFERRER
Used as a URI extra field with
ACTION_INSTALL_PACKAGE and
ACTION_VIEW to indicate the HTTP referrer URI associated with the Intent
data field or EXTRA_ORIGINATING_URI . |
static String |
EXTRA_REMOTE_INTENT_TOKEN
Used in the extra field in the remote intent.
|
static String |
EXTRA_REMOVED_FOR_ALL_USERS |
static String |
EXTRA_REPLACING
Used as a boolean extra field in
ACTION_PACKAGE_REMOVED
intents to indicate that this is a replacement of the package, so this
broadcast will immediately be followed by an add broadcast for a
different version of the same package. |
static String |
EXTRA_RETURN_RESULT
Used as a boolean extra field with
ACTION_INSTALL_PACKAGE or
ACTION_UNINSTALL_PACKAGE . |
static String |
EXTRA_SHORTCUT_ICON
The name of the extra used to define the icon, as a Bitmap, of a shortcut.
|
static String |
EXTRA_SHORTCUT_ICON_RESOURCE
The name of the extra used to define the icon, as a ShortcutIconResource, of a shortcut.
|
static String |
EXTRA_SHORTCUT_INTENT
The name of the extra used to define the Intent of a shortcut.
|
static String |
EXTRA_SHORTCUT_NAME
The name of the extra used to define the name of a shortcut.
|
static String |
EXTRA_STREAM
A content: URI holding a stream of data associated with the Intent,
used with
ACTION_SEND to supply the data being sent. |
static String |
EXTRA_SUBJECT
A constant string holding the desired subject line of a message.
|
static String |
EXTRA_TEMPLATE
The initial data to place in a newly created record.
|
static String |
EXTRA_TEXT
A constant CharSequence that is associated with the Intent, used with
ACTION_SEND to supply the literal data to be sent. |
static String |
EXTRA_TITLE
A CharSequence dialog title to provide to the user when used with a
ACTION_CHOOSER . |
static String |
EXTRA_UID
Used as an int extra field in
ACTION_UID_REMOVED
intents to supply the uid the package had been assigned. |
static String |
EXTRA_UNINSTALL_ALL_USERS
Specify whether the package should be uninstalled for all users.
|
static String |
EXTRA_USER_HANDLE
The userHandle carried with broadcast intents related to addition, removal and switching of users
-
ACTION_USER_ADDED , ACTION_USER_REMOVED and ACTION_USER_SWITCHED . |
static int |
FILL_IN_ACTION
Use with
fillIn(android.content.Intent, int) to allow the current action value to be
overwritten, even if it is already set. |
static int |
FILL_IN_CATEGORIES
Use with
fillIn(android.content.Intent, int) to allow the current categories to be
overwritten, even if they are already set. |
static int |
FILL_IN_CLIP_DATA
Use with
fillIn(android.content.Intent, int) to allow the current ClipData to be
overwritten, even if it is already set. |
static int |
FILL_IN_COMPONENT
Use with
fillIn(android.content.Intent, int) to allow the current component value to be
overwritten, even if it is already set. |
static int |
FILL_IN_DATA
Use with
fillIn(android.content.Intent, int) to allow the current data or type value
overwritten, even if it is already set. |
static int |
FILL_IN_PACKAGE
Use with
fillIn(android.content.Intent, int) to allow the current package value to be
overwritten, even if it is already set. |
static int |
FILL_IN_SELECTOR
Use with
fillIn(android.content.Intent, int) to allow the current selector to be
overwritten, even if it is already set. |
static int |
FILL_IN_SOURCE_BOUNDS
Use with
fillIn(android.content.Intent, int) to allow the current bounds rectangle to be
overwritten, even if it is already set. |
static int |
FLAG_ACTIVITY_BROUGHT_TO_FRONT
This flag is not normally set by application code, but set for you by
the system as described in the
launchMode documentation for the singleTask mode. |
static int |
FLAG_ACTIVITY_CLEAR_TASK
If set in an Intent passed to
Context.startActivity() ,
this flag will cause any existing task that would be associated with the
activity to be cleared before the activity is started. |
static int |
FLAG_ACTIVITY_CLEAR_TOP
If set, and the activity being launched is already running in the
current task, then instead of launching a new instance of that activity,
all of the other activities on top of it will be closed and this Intent
will be delivered to the (now on top) old activity as a new Intent.
|
static int |
FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
If set, this marks a point in the task's activity stack that should
be cleared when the task is reset.
|
static int |
FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
If set, the new activity is not kept in the list of recently launched
activities.
|
static int |
FLAG_ACTIVITY_FORWARD_RESULT
If set and this intent is being used to launch a new activity from an
existing one, then the reply target of the existing activity will be
transfered to the new activity.
|
static int |
FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
This flag is not normally set by application code, but set for you by
the system if this activity is being launched from history
(longpress home key).
|
static int |
FLAG_ACTIVITY_MULTIPLE_TASK
Do not use this flag unless you are implementing your own
top-level application launcher. Used in conjunction with
FLAG_ACTIVITY_NEW_TASK to disable the
behavior of bringing an existing task to the foreground. |
static int |
FLAG_ACTIVITY_NEW_TASK
If set, this activity will become the start of a new task on this
history stack.
|
static int |
FLAG_ACTIVITY_NO_ANIMATION
If set in an Intent passed to
Context.startActivity() ,
this flag will prevent the system from applying an activity transition
animation to go to the next activity state. |
static int |
FLAG_ACTIVITY_NO_HISTORY
If set, the new activity is not kept in the history stack.
|
static int |
FLAG_ACTIVITY_NO_USER_ACTION
If set, this flag will prevent the normal
Activity.onUserLeaveHint()
callback from occurring on the current frontmost activity before it is
paused as the newly-started activity is brought to the front. |
static int |
FLAG_ACTIVITY_PREVIOUS_IS_TOP
If set and this intent is being used to launch a new activity from an
existing one, the current activity will not be counted as the top
activity for deciding whether the new intent should be delivered to
the top instead of starting a new one.
|
static int |
FLAG_ACTIVITY_REORDER_TO_FRONT
If set in an Intent passed to
Context.startActivity() ,
this flag will cause the launched activity to be brought to the front of its
task's history stack if it is already running. |
static int |
FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
If set, and this activity is either being started in a new task or
bringing to the top an existing task, then it will be launched as
the front door of the task.
|
static int |
FLAG_ACTIVITY_SINGLE_TOP
If set, the activity will not be launched if it is already running
at the top of the history stack.
|
static int |
FLAG_ACTIVITY_TASK_ON_HOME
If set in an Intent passed to
Context.startActivity() ,
this flag will cause a newly launching task to be placed on top of the current
home activity task (if there is one). |
static int |
FLAG_DEBUG_LOG_RESOLUTION
A flag you can enable for debugging: when set, log messages will be
printed during the resolution of this intent to show you what has
been found to create the final resolved list.
|
static int |
FLAG_EXCLUDE_STOPPED_PACKAGES
If set, this intent will not match any components in packages that
are currently stopped.
|
static int |
FLAG_FROM_BACKGROUND
Can be set by the caller to indicate that this Intent is coming from
a background operation, not from direct user interaction.
|
static int |
FLAG_GRANT_READ_URI_PERMISSION
If set, the recipient of this Intent will be granted permission to
perform read operations on the Uri in the Intent's data and any URIs
specified in its ClipData.
|
static int |
FLAG_GRANT_WRITE_URI_PERMISSION
If set, the recipient of this Intent will be granted permission to
perform write operations on the Uri in the Intent's data and any URIs
specified in its ClipData.
|
static int |
FLAG_INCLUDE_STOPPED_PACKAGES
If set, this intent will always match any components in packages that
are currently stopped.
|
static int |
FLAG_RECEIVER_BOOT_UPGRADE
Set when this broadcast is for a boot upgrade, a special mode that
allows the broadcast to be sent before the system is ready and launches
the app process with no providers running in it.
|
static int |
FLAG_RECEIVER_FOREGROUND
If set, when sending a broadcast the recipient is allowed to run at
foreground priority, with a shorter timeout interval.
|
static int |
FLAG_RECEIVER_REGISTERED_ONLY
If set, when sending a broadcast only registered receivers will be
called -- no BroadcastReceiver components will be launched.
|
static int |
FLAG_RECEIVER_REGISTERED_ONLY_BEFORE_BOOT
If set, when sending a broadcast before boot has completed only
registered receivers will be called -- no BroadcastReceiver components
will be launched.
|
static int |
FLAG_RECEIVER_REPLACE_PENDING
If set, when sending a broadcast the new broadcast will replace
any existing pending broadcast that matches it.
|
static int |
IMMUTABLE_FLAGS |
static String |
METADATA_DOCK_HOME
Boolean that can be supplied as meta-data with a dock activity, to
indicate that the dock should take over the home key when it is active.
|
static String |
METADATA_SETUP_VERSION
A string associated with a
ACTION_UPGRADE_SETUP activity
describing the last run version of the platform that was setup. |
static int |
URI_INTENT_SCHEME
Flag for use with
toUri(int) and parseUri(java.lang.String, int) : the URI string
always has the "intent:" scheme. |
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE
Modifier | Constructor and Description |
---|---|
|
Intent()
Create an empty intent.
|
|
Intent(Context packageContext,
Class<?> cls)
Create an intent for a specific component.
|
|
Intent(Intent o)
Copy constructor.
|
protected |
Intent(Parcel in) |
|
Intent(String action)
Create an intent with a given action.
|
|
Intent(String action,
Uri uri)
Create an intent with a given action and for a given data url.
|
|
Intent(String action,
Uri uri,
Context packageContext,
Class<?> cls)
Create an intent for a specific component with a specified action and data.
|
Modifier and Type | Method and Description |
---|---|
Intent |
addCategory(String category)
Add a new category to the intent.
|
Intent |
addFlags(int flags)
Add additional flags to the intent (or with existing flags
value).
|
Object |
clone()
Creates and returns a copy of this
Object . |
Intent |
cloneFilter()
Make a clone of only the parts of the Intent that are relevant for
filter matching: the action, data, type, component, and categories.
|
static Intent |
createChooser(Intent target,
CharSequence title)
Convenience function for creating a
ACTION_CHOOSER Intent. |
int |
describeContents()
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
|
int |
fillIn(Intent other,
int flags)
Copy the contents of other in to this object, but only
where fields are not defined by this object.
|
boolean |
filterEquals(Intent other)
Determine if two intents are the same for the purposes of intent
resolution (filtering).
|
int |
filterHashCode()
Generate hash code that matches semantics of filterEquals().
|
String |
getAction()
Retrieve the general action to be performed, such as
ACTION_VIEW . |
boolean[] |
getBooleanArrayExtra(String name)
Retrieve extended data from the intent.
|
boolean |
getBooleanExtra(String name,
boolean defaultValue)
Retrieve extended data from the intent.
|
Bundle |
getBundleExtra(String name)
Retrieve extended data from the intent.
|
byte[] |
getByteArrayExtra(String name)
Retrieve extended data from the intent.
|
byte |
getByteExtra(String name,
byte defaultValue)
Retrieve extended data from the intent.
|
Set<String> |
getCategories()
Return the set of all categories in the intent.
|
char[] |
getCharArrayExtra(String name)
Retrieve extended data from the intent.
|
char |
getCharExtra(String name,
char defaultValue)
Retrieve extended data from the intent.
|
CharSequence[] |
getCharSequenceArrayExtra(String name)
Retrieve extended data from the intent.
|
ArrayList<CharSequence> |
getCharSequenceArrayListExtra(String name)
Retrieve extended data from the intent.
|
CharSequence |
getCharSequenceExtra(String name)
Retrieve extended data from the intent.
|
ClipData |
getClipData()
Return the
ClipData associated with this Intent. |
ComponentName |
getComponent()
Retrieve the concrete component associated with the intent.
|
Uri |
getData()
Retrieve data this intent is operating on.
|
String |
getDataString()
The same as
getData() , but returns the URI as an encoded
String. |
double[] |
getDoubleArrayExtra(String name)
Retrieve extended data from the intent.
|
double |
getDoubleExtra(String name,
double defaultValue)
Retrieve extended data from the intent.
|
Object |
getExtra(String name)
Deprecated.
|
Object |
getExtra(String name,
Object defaultValue)
Deprecated.
|
Bundle |
getExtras()
Retrieves a map of extended data from the intent.
|
int |
getFlags()
Retrieve any special flags associated with this intent.
|
float[] |
getFloatArrayExtra(String name)
Retrieve extended data from the intent.
|
float |
getFloatExtra(String name,
float defaultValue)
Retrieve extended data from the intent.
|
IBinder |
getIBinderExtra(String name)
Deprecated.
|
int[] |
getIntArrayExtra(String name)
Retrieve extended data from the intent.
|
ArrayList<Integer> |
getIntegerArrayListExtra(String name)
Retrieve extended data from the intent.
|
static Intent |
getIntent(String uri)
Deprecated.
Use
parseUri(java.lang.String, int) instead. |
static Intent |
getIntentOld(String uri) |
int |
getIntExtra(String name,
int defaultValue)
Retrieve extended data from the intent.
|
long[] |
getLongArrayExtra(String name)
Retrieve extended data from the intent.
|
long |
getLongExtra(String name,
long defaultValue)
Retrieve extended data from the intent.
|
String |
getPackage()
Retrieve the application package name this Intent is limited to.
|
Parcelable[] |
getParcelableArrayExtra(String name)
Retrieve extended data from the intent.
|
<T extends Parcelable> |
getParcelableArrayListExtra(String name)
Retrieve extended data from the intent.
|
<T extends Parcelable> |
getParcelableExtra(String name)
Retrieve extended data from the intent.
|
String |
getScheme()
Return the scheme portion of the intent's data.
|
Intent |
getSelector()
Return the specific selector associated with this Intent.
|
Serializable |
getSerializableExtra(String name)
Retrieve extended data from the intent.
|
short[] |
getShortArrayExtra(String name)
Retrieve extended data from the intent.
|
short |
getShortExtra(String name,
short defaultValue)
Retrieve extended data from the intent.
|
Rect |
getSourceBounds()
Get the bounds of the sender of this intent, in screen coordinates.
|
String[] |
getStringArrayExtra(String name)
Retrieve extended data from the intent.
|
ArrayList<String> |
getStringArrayListExtra(String name)
Retrieve extended data from the intent.
|
String |
getStringExtra(String name)
Retrieve extended data from the intent.
|
String |
getType()
Retrieve any explicit MIME type included in the intent.
|
boolean |
hasCategory(String category)
Check if a category exists in the intent.
|
boolean |
hasExtra(String name)
Returns true if an extra value is associated with the given name.
|
boolean |
hasFileDescriptors()
Returns true if the Intent's extras contain a parcelled file descriptor.
|
boolean |
isExcludingStopped() |
static Intent |
makeMainActivity(ComponentName mainActivity)
Create an intent to launch the main (root) activity of a task.
|
static Intent |
makeMainSelectorActivity(String selectorAction,
String selectorCategory)
Make an Intent for the main activity of an application, without
specifying a specific activity to run but giving a selector to find
the activity.
|
static Intent |
makeRestartActivityTask(ComponentName mainActivity)
Make an Intent that can be used to re-launch an application's task
in its base state.
|
boolean |
migrateExtraStreamToClipData()
|
static String |
normalizeMimeType(String type)
Normalize a MIME data type.
|
static Intent |
parseIntent(Resources resources,
XmlPullParser parser,
AttributeSet attrs)
Parses the "intent" element (and its children) from XML and instantiates
an Intent object.
|
static Intent |
parseUri(String uri,
int flags)
Create an intent from a URI.
|
Intent |
putCharSequenceArrayListExtra(String name,
ArrayList<CharSequence> value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
boolean value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
boolean[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
Bundle value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
byte value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
byte[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
char value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
char[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
CharSequence value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
CharSequence[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
double value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
double[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
float value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
float[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
IBinder value)
Deprecated.
|
Intent |
putExtra(String name,
int value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
int[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
long value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
long[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
Parcelable value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
Parcelable[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
Serializable value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
short value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
short[] value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
String value)
Add extended data to the intent.
|
Intent |
putExtra(String name,
String[] value)
Add extended data to the intent.
|
Intent |
putExtras(Bundle extras)
Add a set of extended data to the intent.
|
Intent |
putExtras(Intent src)
Copy all extras in 'src' in to this intent.
|
Intent |
putIntegerArrayListExtra(String name,
ArrayList<Integer> value)
Add extended data to the intent.
|
Intent |
putParcelableArrayListExtra(String name,
ArrayList<? extends Parcelable> value)
Add extended data to the intent.
|
Intent |
putStringArrayListExtra(String name,
ArrayList<String> value)
Add extended data to the intent.
|
void |
readFromParcel(Parcel in) |
void |
removeCategory(String category)
Remove a category from an intent.
|
void |
removeExtra(String name)
Remove extended data from the intent.
|
Intent |
replaceExtras(Bundle extras)
Completely replace the extras in the Intent with the given Bundle of
extras.
|
Intent |
replaceExtras(Intent src)
Completely replace the extras in the Intent with the extras in the
given Intent.
|
ComponentName |
resolveActivity(PackageManager pm)
Return the Activity component that should be used to handle this intent.
|
ActivityInfo |
resolveActivityInfo(PackageManager pm,
int flags)
Resolve the Intent into an
ActivityInfo
describing the activity that should execute the intent. |
String |
resolveType(ContentResolver resolver)
Return the MIME data type of this intent.
|
String |
resolveType(Context context)
Return the MIME data type of this intent.
|
String |
resolveTypeIfNeeded(ContentResolver resolver)
Return the MIME data type of this intent, only if it will be needed for
intent resolution.
|
Intent |
setAction(String action)
Set the general action to be performed.
|
void |
setAllowFds(boolean allowFds) |
Intent |
setClass(Context packageContext,
Class<?> cls)
Convenience for calling
setComponent(ComponentName) with the
name returned by a Class object. |
Intent |
setClassName(Context packageContext,
String className)
Convenience for calling
setComponent(android.content.ComponentName) with an
explicit class name. |
Intent |
setClassName(String packageName,
String className)
Convenience for calling
setComponent(android.content.ComponentName) with an
explicit application package name and class name. |
void |
setClipData(ClipData clip)
Set a
ClipData associated with this Intent. |
Intent |
setComponent(ComponentName component)
(Usually optional) Explicitly set the component to handle the intent.
|
Intent |
setData(Uri data)
Set the data this intent is operating on.
|
Intent |
setDataAndNormalize(Uri data)
Normalize and set the data this intent is operating on.
|
Intent |
setDataAndType(Uri data,
String type)
(Usually optional) Set the data for the intent along with an explicit
MIME data type.
|
Intent |
setDataAndTypeAndNormalize(Uri data,
String type)
(Usually optional) Normalize and set both the data Uri and an explicit
MIME data type.
|
void |
setExtrasClassLoader(ClassLoader loader)
Sets the ClassLoader that will be used when unmarshalling
any Parcelable values from the extras of this Intent.
|
Intent |
setFlags(int flags)
Set special flags controlling how this intent is handled.
|
Intent |
setPackage(String packageName)
(Usually optional) Set an explicit application package name that limits
the components this Intent will resolve to.
|
void |
setSelector(Intent selector)
Set a selector for this Intent.
|
void |
setSourceBounds(Rect r)
Set the bounds of the sender of this intent, in screen coordinates.
|
Intent |
setType(String type)
Set an explicit MIME data type.
|
Intent |
setTypeAndNormalize(String type)
Normalize and set an explicit MIME data type.
|
String |
toInsecureString() |
String |
toInsecureStringWithClip() |
String |
toShortString(boolean secure,
boolean comp,
boolean extras,
boolean clip) |
void |
toShortString(StringBuilder b,
boolean secure,
boolean comp,
boolean extras,
boolean clip) |
String |
toString()
Returns a string containing a concise, human-readable description of this
object.
|
String |
toURI()
Deprecated.
Use
toUri(int) instead. |
String |
toUri(int flags)
Convert this Intent into a String holding a URI representation of it.
|
void |
writeToParcel(Parcel out,
int flags)
Flatten this object in to a Parcel.
|
public static final String ACTION_MAIN
Input: nothing
Output: nothing
public static final String ACTION_VIEW
Input: getData()
is URI from which to retrieve data.
Output: nothing.
public static final String ACTION_DEFAULT
ACTION_VIEW
, the "standard" action that is
performed on a piece of data.public static final String ACTION_ATTACH_DATA
Input: getData()
is URI of data to be attached.
Output: nothing.
public static final String ACTION_EDIT
Input: getData()
is URI of data to be edited.
Output: nothing.
public static final String ACTION_INSERT_OR_EDIT
Input: getType()
is the desired MIME type of the item to create or edit.
The extras can contain type specific data to pass through to the editing/creating
activity.
Output: The URI of the item that was picked. This must be a content: URI so that any receiver can access it.
public static final String ACTION_PICK
Input: getData()
is URI containing a directory of data
(vnd.android.cursor.dir/*) from which to pick an item.
Output: The URI of the item that was picked.
public static final String ACTION_CREATE_SHORTCUT
Input: Nothing.
Output: An Intent representing the shortcut. The intent must contain three extras: SHORTCUT_INTENT (value: Intent), SHORTCUT_NAME (value: String), and SHORTCUT_ICON (value: Bitmap) or SHORTCUT_ICON_RESOURCE (value: ShortcutIconResource).
public static final String EXTRA_SHORTCUT_INTENT
ACTION_CREATE_SHORTCUT
,
Constant Field Valuespublic static final String EXTRA_SHORTCUT_NAME
ACTION_CREATE_SHORTCUT
,
Constant Field Valuespublic static final String EXTRA_SHORTCUT_ICON
ACTION_CREATE_SHORTCUT
,
Constant Field Valuespublic static final String EXTRA_SHORTCUT_ICON_RESOURCE
public static final String ACTION_CHOOSER
This action should be used when the user will naturally expect to select an activity in order to proceed. An example if when not to use it is when the user clicks on a "mailto:" link. They would naturally expect to go directly to their mail app, so startActivity() should be called directly: it will either launch the current preferred app, or put up a dialog allowing the user to pick an app to use and optionally marking that as preferred.
In contrast, if the user is selecting a menu item to send a picture they are viewing to someone else, there are many different things they may want to do at this point: send it through e-mail, upload it to a web service, etc. In this case the CHOOSER action should be used, to always present to the user a list of the things they can do, with a nice title given by the caller such as "Send this photo with:".
If you need to grant URI permissions through a chooser, you must specify
the permissions to be granted on the ACTION_CHOOSER Intent
in addition to the EXTRA_INTENT inside. This means using
setClipData(android.content.ClipData)
to specify the URIs to be granted as well as
FLAG_GRANT_READ_URI_PERMISSION
and/or
FLAG_GRANT_WRITE_URI_PERMISSION
as appropriate.
As a convenience, an Intent of this form can be created with the
createChooser(android.content.Intent, java.lang.CharSequence)
function.
Input: No data should be specified. get*Extra must have
a EXTRA_INTENT
field containing the Intent being executed,
and can optionally have a EXTRA_TITLE
field containing the
title text to display in the chooser.
Output: Depends on the protocol of EXTRA_INTENT
.
public static final String ACTION_GET_CONTENT
ACTION_PICK
in that here we
just say what kind of data is desired, not a URI of existing data from
which the user can pick. A ACTION_GET_CONTENT could allow the user to
create the data as it runs (for example taking a picture or recording a
sound), let them browse over the web and download the desired data,
etc.
There are two main ways to use this action: if you want a specific kind
of data, such as a person contact, you set the MIME type to the kind of
data you want and launch it with Context.startActivity(Intent)
.
The system will then launch the best application to select that kind
of data for you.
You may also be interested in any of a set of types of content the user can pick. For example, an e-mail application that wants to allow the user to add an attachment to an e-mail message can use this action to bring up a list of all of the types of content the user can attach.
In this case, you should wrap the GET_CONTENT intent with a chooser
(through createChooser(android.content.Intent, java.lang.CharSequence)
), which will give the proper interface
for the user to pick how to send your data and allow you to specify
a prompt indicating what they are doing. You will usually specify a
broad MIME type (such as image/* or */*), resulting in a
broad range of content types the user can select from.
When using such a broad GET_CONTENT action, it is often desirable to
only pick from data that can be represented as a stream. This is
accomplished by requiring the CATEGORY_OPENABLE
in the Intent.
Callers can optionally specify EXTRA_LOCAL_ONLY
to request that
the launched content chooser only returns results representing data that
is locally available on the device. For example, if this extra is set
to true then an image picker should not show any pictures that are available
from a remote server but not already on the local device (thus requiring
they be downloaded when opened).
Input: getType()
is the desired MIME type to retrieve. Note
that no URI is supplied in the intent, as there are no constraints on
where the returned data originally comes from. You may also include the
CATEGORY_OPENABLE
if you can only accept data that can be
opened as a stream. You may use EXTRA_LOCAL_ONLY
to limit content
selection to local data.
Output: The URI of the item that was picked. This must be a content: URI so that any receiver can access it.
public static final String ACTION_DIAL
Input: If nothing, an empty dialer is started; else getData()
is URI of a phone number to be dialed or a tel: URI of an explicit phone
number.
Output: nothing.
public static final String ACTION_CALL
Input: If nothing, an empty dialer is started; else getData()
is URI of a phone number to be dialed or a tel: URI of an explicit phone
number.
Output: nothing.
Note: there will be restrictions on which applications can initiate a
call; most applications should use the ACTION_DIAL
.
Note: this Intent cannot be used to call emergency
numbers. Applications can dial emergency numbers using
ACTION_DIAL
, however.
public static final String ACTION_CALL_EMERGENCY
Input: getData()
is URI of a phone number to be dialed or a
tel: URI of an explicit phone number.
Output: nothing.
public static final String ACTION_CALL_PRIVILEGED
Input: getData()
is URI of a phone number to be dialed or a
tel: URI of an explicit phone number.
Output: nothing.
public static final String ACTION_SENDTO
Input: getData()
is URI describing the target.
Output: nothing.
public static final String ACTION_SEND
When launching a SEND intent, you should usually wrap it in a chooser
(through createChooser(android.content.Intent, java.lang.CharSequence)
), which will give the proper interface
for the user to pick how to send your data and allow you to specify
a prompt indicating what they are doing.
Input: getType()
is the MIME type of the data being sent.
get*Extra can have either a EXTRA_TEXT
or EXTRA_STREAM
field, containing the data to be sent. If
using EXTRA_TEXT, the MIME type should be "text/plain"; otherwise it
should be the MIME type of the data in EXTRA_STREAM. Use */*
if the MIME type is unknown (this will only allow senders that can
handle generic data streams). If using EXTRA_TEXT
, you can
also optionally supply EXTRA_HTML_TEXT
for clients to retrieve
your text with HTML formatting.
As of Build.VERSION_CODES.JELLY_BEAN
, the data
being sent can be supplied through setClipData(ClipData)
. This
allows you to use FLAG_GRANT_READ_URI_PERMISSION
when sharing
content: URIs and other advanced features of ClipData
. If
using this approach, you still must supply the same data through the
EXTRA_TEXT
or EXTRA_STREAM
fields described below
for compatibility with old applications. If you don't set a ClipData,
it will be copied there for you when calling Context.startActivity(Intent)
.
Optional standard extras, which may be interpreted by some recipients as
appropriate, are: EXTRA_EMAIL
, EXTRA_CC
,
EXTRA_BCC
, EXTRA_SUBJECT
.
Output: nothing.
public static final String ACTION_SEND_MULTIPLE
Like ACTION_SEND
, except the data is multiple.
Input: getType()
is the MIME type of the data being sent.
get*ArrayListExtra can have either a EXTRA_TEXT
or EXTRA_STREAM
field, containing the data to be sent. If using
EXTRA_TEXT
, you can also optionally supply EXTRA_HTML_TEXT
for clients to retrieve your text with HTML formatting.
Multiple types are supported, and receivers should handle mixed types whenever possible. The right way for the receiver to check them is to use the content resolver on each URI. The intent sender should try to put the most concrete mime type in the intent type, but it can fall back to <type>/* or */* as needed.
e.g. if you are sending image/jpg and image/jpg, the intent's type can be image/jpg, but if you are sending image/jpg and image/png, then the intent's type should be image/*.
As of Build.VERSION_CODES.JELLY_BEAN
, the data
being sent can be supplied through setClipData(ClipData)
. This
allows you to use FLAG_GRANT_READ_URI_PERMISSION
when sharing
content: URIs and other advanced features of ClipData
. If
using this approach, you still must supply the same data through the
EXTRA_TEXT
or EXTRA_STREAM
fields described below
for compatibility with old applications. If you don't set a ClipData,
it will be copied there for you when calling Context.startActivity(Intent)
.
Optional standard extras, which may be interpreted by some recipients as
appropriate, are: EXTRA_EMAIL
, EXTRA_CC
,
EXTRA_BCC
, EXTRA_SUBJECT
.
Output: nothing.
public static final String ACTION_ANSWER
Input: nothing.
Output: nothing.
public static final String ACTION_INSERT
Input: getData()
is URI of the directory (vnd.android.cursor.dir/*)
in which to place the data.
Output: URI of the new data that was created.
public static final String ACTION_PASTE
Input: getData()
is URI of the directory (vnd.android.cursor.dir/*)
in which to place the data.
Output: URI of the new data that was created.
public static final String ACTION_DELETE
Input: getData()
is URI of data to be deleted.
Output: nothing.
public static final String ACTION_RUN
Input: ? (Note: this is currently specific to the test harness.)
Output: nothing.
public static final String ACTION_SYNC
Input: ?
Output: ?
public static final String ACTION_PICK_ACTIVITY
Input: get*Extra field EXTRA_INTENT
is an Intent
used with PackageManager.queryIntentActivities(android.content.Intent, int)
to determine the
set of activities from which to pick.
Output: Class name of the activity that was selected.
public static final String ACTION_SEARCH
Input: getStringExtra(SearchManager.QUERY)
is the text to search for. If empty, simply
enter your search results Activity with the search UI activated.
Output: nothing.
public static final String ACTION_SYSTEM_TUTORIAL
Input: getStringExtra(SearchManager.QUERY)
is the text to search for. If empty, simply
enter your search results Activity with the search UI activated.
Output: nothing.
public static final String ACTION_WEB_SEARCH
Input: getStringExtra(SearchManager.QUERY)
is the text to search for. If it is
a url starts with http or https, the site will be opened. If it is plain
text, Google search will be applied.
Output: nothing.
public static final String ACTION_ASSIST
Input: nothing Output: nothing.
public static final String ACTION_ALL_APPS
Input: Nothing.
Output: nothing.
public static final String ACTION_SET_WALLPAPER
Input: Nothing.
Output: Nothing.
public static final String ACTION_BUG_REPORT
Input: Nothing.
Output: Nothing.
public static final String ACTION_FACTORY_TEST
Input: nothing
Output: nothing
public static final String ACTION_CALL_BUTTON
Input: Nothing.
Output: Nothing.
public static final String ACTION_VOICE_COMMAND
Input: Nothing.
Output: Nothing.
public static final String ACTION_SEARCH_LONG_PRESS
Input: Nothing.
Output: Nothing.
public static final String ACTION_APP_ERROR
Input: No data is specified. The bug report is passed in using
an EXTRA_BUG_REPORT
field.
Output: Nothing.
EXTRA_BUG_REPORT
,
Constant Field Valuespublic static final String ACTION_POWER_USAGE_SUMMARY
Input: Nothing.
Output: Nothing.
public static final String ACTION_UPGRADE_SETUP
METADATA_SETUP_VERSION
, which defines the current version of
the platform for setup. The activity will be launched only if
Settings.Secure.LAST_SETUP_SHOWN
is not the
same value.
Input: Nothing.
Output: Nothing.
public static final String ACTION_MANAGE_NETWORK_USAGE
public static final String ACTION_INSTALL_PACKAGE
Input: The data must be a content: or file: URI at which the application
can be retrieved. As of
Output: If Build.VERSION_CODES.JELLY_BEAN_MR1
,
you can also use "package:EXTRA_INSTALLER_PACKAGE_NAME
, EXTRA_NOT_UNKNOWN_SOURCE
,
EXTRA_ALLOW_REPLACE
, and EXTRA_RETURN_RESULT
.
EXTRA_RETURN_RESULT
, returns whether the install
succeeded.
public static final String EXTRA_INSTALLER_PACKAGE_NAME
ACTION_INSTALL_PACKAGE
to install a
package. Specifies the installer package name; this package will receive the
ACTION_APP_ERROR
intent.public static final String EXTRA_NOT_UNKNOWN_SOURCE
ACTION_INSTALL_PACKAGE
to install a
package. Specifies that the application being installed should not be
treated as coming from an unknown source, but as coming from the app
invoking the Intent. For this to work you must start the installer with
startActivityForResult().public static final String EXTRA_ORIGINATING_URI
ACTION_INSTALL_PACKAGE
and
ACTION_VIEW
to indicate the URI from which the local APK in the Intent
data field originated from.public static final String EXTRA_REFERRER
ACTION_INSTALL_PACKAGE
and
ACTION_VIEW
to indicate the HTTP referrer URI associated with the Intent
data field or EXTRA_ORIGINATING_URI
.public static final String EXTRA_ORIGINATING_UID
ACTION_INSTALL_PACKAGE
and
#ACTION_VIEW} to indicate the uid of the package that initiated the install@Deprecated public static final String EXTRA_ALLOW_REPLACE
Build.VERSION_CODES.JELLY_BEAN
, Android
will no longer show an interstitial message about updating existing
applications so this is no longer needed.ACTION_INSTALL_PACKAGE
to install a
package. Tells the installer UI to skip the confirmation with the user
if the .apk is replacing an existing one.public static final String EXTRA_RETURN_RESULT
ACTION_INSTALL_PACKAGE
or
ACTION_UNINSTALL_PACKAGE
. Specifies that the installer UI should
return to the application the result code of the install/uninstall. The returned result
code will be Activity.RESULT_OK
on success or
Activity.RESULT_FIRST_USER
on failure.public static final String EXTRA_INSTALL_RESULT
public static final String ACTION_UNINSTALL_PACKAGE
Input: The data must be a package: URI whose scheme specific part is
the package name of the current installed package to be uninstalled.
You can optionally supply EXTRA_RETURN_RESULT
.
Output: If EXTRA_RETURN_RESULT
, returns whether the install
succeeded.
public static final String EXTRA_UNINSTALL_ALL_USERS
public static final String METADATA_SETUP_VERSION
ACTION_UPGRADE_SETUP
activity
describing the last run version of the platform that was setup.public static final String ACTION_SCREEN_OFF
This is a protected intent that can only be sent by the system.
public static final String ACTION_SCREEN_ON
This is a protected intent that can only be sent by the system.
public static final String ACTION_DREAMING_STOPPED
This is a protected intent that can only be sent by the system. It is only sent to registered receivers.
public static final String ACTION_DREAMING_STARTED
This is a protected intent that can only be sent by the system. It is only sent to registered receivers.
public static final String ACTION_USER_PRESENT
This is a protected intent that can only be sent by the system.
public static final String ACTION_TIME_TICK
Context.registerReceiver()
.
This is a protected intent that can only be sent by the system.
public static final String ACTION_TIME_CHANGED
public static final String ACTION_DATE_CHANGED
public static final String ACTION_TIMEZONE_CHANGED
This is a protected intent that can only be sent by the system.
public static final String ACTION_CLEAR_DNS_CACHE
public static final String ACTION_ALARM_CHANGED
public static final String ACTION_SYNC_STATE_CHANGED
public static final String ACTION_BOOT_COMPLETED
android.Manifest.permission#RECEIVE_BOOT_COMPLETED
permission
in order to receive this broadcast.
This is a protected intent that can only be sent by the system.
public static final String ACTION_CLOSE_SYSTEM_DIALOGS
@Deprecated public static final String ACTION_PACKAGE_INSTALL
Input: getData()
is the URI of the package file to download.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_ADDED
May include the following extras:
EXTRA_UID
containing the integer uid assigned to the new package.
EXTRA_REPLACING
is set to true if this is following
an ACTION_PACKAGE_REMOVED
broadcast for the same package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_REPLACED
May include the following extras:
EXTRA_UID
containing the integer uid assigned to the new package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_MY_PACKAGE_REPLACED
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_REMOVED
EXTRA_UID
containing the integer uid previously assigned
to the package.
EXTRA_DATA_REMOVED
is set to true if the entire
application -- data and code -- is being removed.
EXTRA_REPLACING
is set to true if this will be followed
by an ACTION_PACKAGE_ADDED
broadcast for the same package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_FULLY_REMOVED
ACTION_PACKAGE_REMOVED
, but only set when
EXTRA_DATA_REMOVED
is true and
EXTRA_REPLACING
is false of that broadcast.
EXTRA_UID
containing the integer uid previously assigned
to the package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_CHANGED
EXTRA_UID
containing the integer uid assigned to the package.
EXTRA_CHANGED_COMPONENT_NAME_LIST
containing the class name
of the changed components.
EXTRA_DONT_KILL_APP
containing boolean field to override the
default action of restarting the application.
This is a protected intent that can only be sent by the system.
public static final String ACTION_QUERY_PACKAGE_RESTART
public static final String ACTION_PACKAGE_RESTARTED
EXTRA_UID
containing the integer uid assigned to the package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_DATA_CLEARED
ACTION_PACKAGE_RESTARTED
, after which all of
its persistent data is erased and this broadcast sent.
Note that the cleared package does not
receive this broadcast. The data contains the name of the package.
EXTRA_UID
containing the integer uid assigned to the package.
This is a protected intent that can only be sent by the system.
public static final String ACTION_UID_REMOVED
EXTRA_UID
.
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_FIRST_LAUNCH
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_NEEDS_VERIFICATION
This is a protected intent that can only be sent by the system.
public static final String ACTION_PACKAGE_VERIFIED
This is a protected intent that can only be sent by the system.
public static final String ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
EXTRA_CHANGED_PACKAGE_LIST
contains a
list of packages whose availability changed.
The extra data EXTRA_CHANGED_UID_LIST
contains a
list of uids of packages whose availability changed.
Note that the
packages in this list do not receive this broadcast.
The specified set of packages are now available on the system.
Includes the following extras:
EXTRA_CHANGED_PACKAGE_LIST
is the set of packages
whose resources(were previously unavailable) are currently available.
EXTRA_CHANGED_UID_LIST
is the set of uids of the
packages whose resources(were previously unavailable)
are currently available.
This is a protected intent that can only be sent by the system.
public static final String ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
EXTRA_CHANGED_PACKAGE_LIST
contains a
list of packages whose availability changed.
The extra data EXTRA_CHANGED_UID_LIST
contains a
list of uids of packages whose availability changed.
The specified set of packages can no longer be
launched and are practically unavailable on the system.
Inclues the following extras:
EXTRA_CHANGED_PACKAGE_LIST
is the set of packages
whose resources are no longer available.
EXTRA_CHANGED_UID_LIST
is the set of packages
whose resources are no longer available.
This is a protected intent that can only be sent by the system.
@Deprecated public static final String ACTION_WALLPAPER_CHANGED
WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER
to have the wallpaper
shown behind their UI, rather than watching for this broadcast and
rendering the wallpaper on their own.WallpaperManager
for retrieving the new wallpaper.
This should only be used to determine when the wallpaper
has changed to show the new wallpaper to the user. You should certainly
never, in response to this, change the wallpaper or other attributes of
it such as the suggested size. That would be crazy, right? You'd cause
all kinds of loops, especially if other apps are doing similar things,
right? Of course. So please don't do this.public static final String ACTION_CONFIGURATION_CHANGED
Configuration
(orientation, locale, etc) has changed. When such a change happens, the
UIs (view hierarchy) will need to be rebuilt based on this new
information; for the most part, applications don't need to worry about
this, because the system will take care of stopping and restarting the
application to make sure it sees the new changes. Some system code that
can not be restarted will need to watch for this action and handle it
appropriately.
You can not receive this through components declared
in manifests, only by explicitly registering for it with
Context.registerReceiver()
.
This is a protected intent that can only be sent by the system.
Configuration
,
Constant Field Valuespublic static final String ACTION_LOCALE_CHANGED
This is a protected intent that can only be sent by the system.
public static final String ACTION_BATTERY_CHANGED
BatteryManager
for documentation on the
contents of the Intent.
You can not receive this through components declared
in manifests, only by explicitly registering for it with
Context.registerReceiver()
. See ACTION_BATTERY_LOW
,
ACTION_BATTERY_OKAY
, ACTION_POWER_CONNECTED
,
and ACTION_POWER_DISCONNECTED
for distinct battery-related
broadcasts that are sent and can be received through manifest
receivers.
This is a protected intent that can only be sent by the system.
public static final String ACTION_BATTERY_LOW
This is a protected intent that can only be sent by the system.
public static final String ACTION_BATTERY_OKAY
ACTION_BATTERY_LOW
once the battery has
gone back up to an okay state.
This is a protected intent that can only be sent by the system.
public static final String ACTION_POWER_CONNECTED
This is a protected intent that can only be sent by the system.
public static final String ACTION_POWER_DISCONNECTED
This is a protected intent that can only be sent by the system.
public static final String ACTION_SHUTDOWN
This is a protected intent that can only be sent by the system.
public static final String ACTION_REQUEST_SHUTDOWN
EXTRA_KEY_CONFIRM
can be set to true
to request confirmation from the user before shutting down.
This is a protected intent that can only be sent by the system.
public static final String ACTION_DEVICE_STORAGE_LOW
This is a protected intent that can only be sent by the system.
public static final String ACTION_DEVICE_STORAGE_OK
This is a protected intent that can only be sent by the system.
public static final String ACTION_DEVICE_STORAGE_FULL
This is a protected intent that can only be sent by the system.
public static final String ACTION_DEVICE_STORAGE_NOT_FULL
This is a protected intent that can only be sent by the system.
public static final String ACTION_MANAGE_PACKAGE_STORAGE
@Deprecated public static final String ACTION_UMS_CONNECTED
@Deprecated public static final String ACTION_UMS_DISCONNECTED
public static final String ACTION_MEDIA_REMOVED
public static final String ACTION_MEDIA_UNMOUNTED
public static final String ACTION_MEDIA_CHECKING
public static final String ACTION_MEDIA_NOFS
public static final String ACTION_MEDIA_MOUNTED
public static final String ACTION_MEDIA_SHARED
public static final String ACTION_MEDIA_UNSHARED
public static final String ACTION_MEDIA_BAD_REMOVAL
public static final String ACTION_MEDIA_UNMOUNTABLE
public static final String ACTION_MEDIA_EJECT
public static final String ACTION_MEDIA_SCANNER_STARTED
public static final String ACTION_MEDIA_SCANNER_FINISHED
public static final String ACTION_MEDIA_SCANNER_SCAN_FILE
public static final String ACTION_MEDIA_BUTTON
EXTRA_KEY_EVENT
, containing the key event that
caused the broadcast.public static final String ACTION_CAMERA_BUTTON
EXTRA_KEY_EVENT
, containing the key event that
caused the broadcast.public static final String ACTION_GTALK_SERVICE_CONNECTED
public static final String ACTION_GTALK_SERVICE_DISCONNECTED
public static final String ACTION_INPUT_METHOD_CHANGED
public static final String ACTION_AIRPLANE_MODE_CHANGED
Broadcast Action: The user has switched the phone into or out of Airplane Mode. One or more radios have been turned off or on. The intent will have the following extra value:
This is a protected intent that can only be sent by the system.
public static final String ACTION_PROVIDER_CHANGED
The data of the intent identifies which part of which provider changed. When queried through the content resolver, the data URI will return the data set in question.
The intent will have the following extra values:
public static final String ACTION_HEADSET_PLUG
The intent will have the following extra values:
public static final String ACTION_ANALOG_AUDIO_DOCK_PLUG
The intent will have the following extra values:
public static final String ACTION_DIGITAL_AUDIO_DOCK_PLUG
The intent will have the following extra values:
public static final String ACTION_HDMI_AUDIO_PLUG
The intent will have the following extra values:
public static final String ACTION_USB_AUDIO_ACCESSORY_PLUG
The intent will have the following extra values:
public static final String ACTION_USB_AUDIO_DEVICE_PLUG
The intent will have the following extra values:
public static final String ACTION_ADVANCED_SETTINGS_CHANGED
Broadcast Action: The user has switched on advanced settings in the settings app:
This is a protected intent that can only be sent by the system.
public static final String ACTION_NEW_OUTGOING_CALL
The Intent will have the following extra value:
EXTRA_PHONE_NUMBER
-
the phone number originally intended to be dialed.Once the broadcast is finished, the resultData is used as the actual
number to call. If null
, no call will be placed.
It is perfectly acceptable for multiple receivers to process the outgoing call in turn: for example, a parental control application might verify that the user is authorized to place the call at that time, then a number-rewriting application might add an area code if one was not specified.
For consistency, any receiver whose purpose is to prohibit phone calls should have a priority of 0, to ensure it will see the final phone number to be dialed. Any receiver whose purpose is to rewrite phone numbers to be called should have a positive priority. Negative priorities are reserved for the system for this broadcast; using them may cause problems.
Any BroadcastReceiver receiving this Intent must not abort the broadcast.
Emergency calls cannot be intercepted using this mechanism, and other calls cannot be modified to call emergency numbers using this mechanism.
You must hold the
android.Manifest.permission#PROCESS_OUTGOING_CALLS
permission to receive this Intent.
This is a protected intent that can only be sent by the system.
public static final String ACTION_REBOOT
This is a protected intent that can only be sent by the system.
public static final String ACTION_DOCK_EVENT
The intent will have the following extra values:
EXTRA_DOCK_STATE
- the current dock
state, indicating which dock the device is physically in.This is intended for monitoring the current physical dock state.
See UiModeManager
for the normal API dealing with
dock mode changes.
public static final String ACTION_REMOTE_INTENT
public static final String ACTION_PRE_BOOT_COMPLETED
public static final String ACTION_USER_INITIALIZE
ACTION_BOOT_COMPLETED
is sent. This is sent as a foreground
broadcast, since it is part of a visible user interaction; be as quick
as possible when handling it.public static final String ACTION_USER_FOREGROUND
Context.registerReceiver
. It is sent to the user that is going to the
foreground. This is sent as a foreground
broadcast, since it is part of a visible user interaction; be as quick
as possible when handling it.public static final String ACTION_USER_BACKGROUND
Context.registerReceiver
. It is sent to the user that is going to the
background. This is sent as a foreground
broadcast, since it is part of a visible user interaction; be as quick
as possible when handling it.public static final String ACTION_USER_ADDED
android.Manifest.permission#MANAGE_USERS
to receive this broadcast.public static final String ACTION_USER_STARTED
public static final String ACTION_USER_STARTING
android.Manifest.permission#INTERACT_ACROSS_USERS
to receive
this broadcast. This is sent as a background broadcast, since
its result is not part of the primary UX flow; to safely keep track of
started/stopped state of a user you can use this in conjunction with
ACTION_USER_STOPPING
. It is not generally safe to use with
other user state broadcasts since those are foreground broadcasts so can
execute in a different order.public static final String ACTION_USER_STOPPING
android.Manifest.permission#INTERACT_ACROSS_USERS
to receive
this broadcast. The user will not stop until all receivers have
handled the broadcast. This is sent as a background broadcast, since
its result is not part of the primary UX flow; to safely keep track of
started/stopped state of a user you can use this in conjunction with
ACTION_USER_STARTING
. It is not generally safe to use with
other user state broadcasts since those are foreground broadcasts so can
execute in a different order.public static final String ACTION_USER_STOPPED
ACTION_PACKAGE_RESTARTED
, but for an entire user instead of a
specific package. This is only sent to registered receivers, not manifest
receivers. It is sent to all running users except the one that
has just been stopped (which is no longer running).public static final String ACTION_USER_REMOVED
android.Manifest.permission#MANAGE_USERS
to receive this broadcast.public static final String ACTION_USER_SWITCHED
android.Manifest.permission#MANAGE_USERS
to receive this broadcast.public static final String ACTION_USER_INFO_CHANGED
EXTRA_USER_HANDLE
to indicate which user's information changed.
This is only sent to registered receivers, not manifest receivers. It is sent to the user
whose information has changed.public static final String ACTION_QUICK_CLOCK
public static final String CATEGORY_DEFAULT
public static final String CATEGORY_BROWSABLE
public static final String CATEGORY_ALTERNATIVE
CATEGORY_SELECTED_ALTERNATIVE
for an alternative action that
applies to the selection in a list of items.
Supporting this category means that you would like your activity to be displayed in the set of alternative things the user can do, usually as part of the current activity's options menu. You will usually want to include a specific label in the <intent-filter> of this action describing to the user what it does.
The action of IntentFilter with this category is important in that it
describes the specific action the target will perform. This generally
should not be a generic action (such as ACTION_VIEW
, but rather
a specific name such as "com.android.camera.action.CROP. Only one
alternative of any particular action will be shown to the user, so using
a specific action like this makes sure that your alternative will be
displayed while also allowing other applications to provide their own
overrides of that particular action.
public static final String CATEGORY_SELECTED_ALTERNATIVE
CATEGORY_ALTERNATIVE
, but is used in activities showing a list
of items from which the user can select, giving them alternatives to the
default action that will be performed on it.public static final String CATEGORY_TAB
public static final String CATEGORY_LAUNCHER
public static final String CATEGORY_INFO
CATEGORY_LAUNCHER
to provide
a front-door to the user without having to be shown in the all apps list.public static final String CATEGORY_HOME
public static final String CATEGORY_PREFERENCE
public static final String CATEGORY_DEVELOPMENT_PREFERENCE
public static final String CATEGORY_EMBED
public static final String CATEGORY_APP_MARKET
public static final String CATEGORY_MONKEY
public static final String CATEGORY_TEST
public static final String CATEGORY_UNIT_TEST
public static final String CATEGORY_SAMPLE_CODE
public static final String CATEGORY_OPENABLE
public static final String CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST
public static final String CATEGORY_CAR_DOCK
ACTION_MAIN
to launch an activity. For more
information, see UiModeManager
.public static final String CATEGORY_DESK_DOCK
ACTION_MAIN
to launch an activity. For more
information, see UiModeManager
.public static final String CATEGORY_LE_DESK_DOCK
ACTION_MAIN
to launch an activity. For more
information, see UiModeManager
.public static final String CATEGORY_HE_DESK_DOCK
ACTION_MAIN
to launch an activity. For more
information, see UiModeManager
.public static final String CATEGORY_CAR_MODE
public static final String CATEGORY_APP_BROWSER
ACTION_MAIN
to launch the browser application.
The activity should be able to browse the Internet.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_CALCULATOR
ACTION_MAIN
to launch the calculator application.
The activity should be able to perform standard arithmetic operations.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_CALENDAR
ACTION_MAIN
to launch the calendar application.
The activity should be able to view and manipulate calendar entries.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_CONTACTS
ACTION_MAIN
to launch the contacts application.
The activity should be able to view and manipulate address book entries.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_EMAIL
ACTION_MAIN
to launch the email application.
The activity should be able to send and receive email.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_GALLERY
ACTION_MAIN
to launch the gallery application.
The activity should be able to view and manipulate image and video files
stored on the device.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_MAPS
ACTION_MAIN
to launch the maps application.
The activity should be able to show the user's current location and surroundings.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_MESSAGING
ACTION_MAIN
to launch the messaging application.
The activity should be able to send and receive text messages.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String CATEGORY_APP_MUSIC
ACTION_MAIN
to launch the music application.
The activity should be able to play, browse, or manipulate music files
stored on the device.
NOTE: This should not be used as the primary key of an Intent,
since it will not result in the app launching with the correct
action and category. Instead, use this with
makeMainSelectorActivity(String, String)
to generate a main
Intent with this category in the selector.
public static final String EXTRA_TEMPLATE
ACTION_INSERT
. The data here is a Map containing the same
fields as would be given to the underlying ContentProvider.insert()
call.public static final String EXTRA_TEXT
ACTION_SEND
to supply the literal data to be sent. Note that
this may be a styled CharSequence, so you must use
Bundle.getCharSequence()
to
retrieve it.public static final String EXTRA_HTML_TEXT
ACTION_SEND
to supply an alternative to EXTRA_TEXT
as HTML formatted text. Note that you must also supply
EXTRA_TEXT
.public static final String EXTRA_STREAM
ACTION_SEND
to supply the data being sent.public static final String EXTRA_EMAIL
public static final String EXTRA_CC
public static final String EXTRA_BCC
public static final String EXTRA_SUBJECT
public static final String EXTRA_INTENT
ACTION_PICK_ACTIVITY
.public static final String EXTRA_TITLE
ACTION_CHOOSER
.public static final String EXTRA_INITIAL_INTENTS
Intent
or
LabeledIntent
objects as set with
putExtra(String, Parcelable[])
of additional activities to place
a the front of the list of choices, when shown to the user with a
ACTION_CHOOSER
.public static final String EXTRA_KEY_EVENT
KeyEvent
object containing the event that
triggered the creation of the Intent it is in.public static final String EXTRA_KEY_CONFIRM
ACTION_REQUEST_SHUTDOWN
to request confirmation from the user
before shutting down.
public static final String EXTRA_DONT_KILL_APP
ACTION_PACKAGE_REMOVED
or
ACTION_PACKAGE_CHANGED
intents to override the default action
of restarting the application.public static final String EXTRA_PHONE_NUMBER
ACTION_NEW_OUTGOING_CALL
, or the actual
number to call in a ACTION_CALL
.public static final String EXTRA_UID
ACTION_UID_REMOVED
intents to supply the uid the package had been assigned. Also an optional
extra in ACTION_PACKAGE_REMOVED
or
ACTION_PACKAGE_CHANGED
for the same
purpose.public static final String EXTRA_PACKAGES
public static final String EXTRA_DATA_REMOVED
ACTION_PACKAGE_REMOVED
intents to indicate whether this represents a full uninstall (removing
both the code and its data) or a partial uninstall (leaving its data,
implying that this is an update).public static final String EXTRA_REMOVED_FOR_ALL_USERS
public static final String EXTRA_REPLACING
ACTION_PACKAGE_REMOVED
intents to indicate that this is a replacement of the package, so this
broadcast will immediately be followed by an add broadcast for a
different version of the same package.public static final String EXTRA_ALARM_COUNT
AlarmManager
intents
to tell the application being invoked how many pending alarms are being
delievered with the intent. For one-shot alarms this will always be 1.
For recurring alarms, this might be greater than 1 if the device was
asleep or powered off at the time an earlier alarm would have been
delivered.public static final String EXTRA_DOCK_STATE
ACTION_DOCK_EVENT
intents to request the dock state. Possible values are
EXTRA_DOCK_STATE_UNDOCKED
,
EXTRA_DOCK_STATE_DESK
, or
EXTRA_DOCK_STATE_CAR
, or
EXTRA_DOCK_STATE_LE_DESK
, or
EXTRA_DOCK_STATE_HE_DESK
.public static final int EXTRA_DOCK_STATE_UNDOCKED
EXTRA_DOCK_STATE
to represent that the phone is not in any dock.public static final int EXTRA_DOCK_STATE_DESK
EXTRA_DOCK_STATE
to represent that the phone is in a desk dock.public static final int EXTRA_DOCK_STATE_CAR
EXTRA_DOCK_STATE
to represent that the phone is in a car dock.public static final int EXTRA_DOCK_STATE_LE_DESK
EXTRA_DOCK_STATE
to represent that the phone is in a analog (low end) dock.public static final int EXTRA_DOCK_STATE_HE_DESK
EXTRA_DOCK_STATE
to represent that the phone is in a digital (high end) dock.public static final String METADATA_DOCK_HOME
public static final String EXTRA_BUG_REPORT
ACTION_APP_ERROR
, containing
the bug report.public static final String EXTRA_REMOTE_INTENT_TOKEN
@Deprecated public static final String EXTRA_CHANGED_COMPONENT_NAME
EXTRA_CHANGED_COMPONENT_NAME_LIST
; this field
will contain only the first name in the list.public static final String EXTRA_CHANGED_COMPONENT_NAME_LIST
ACTION_PACKAGE_CHANGED
,
and contains a string array of all of the components that have changed.public static final String EXTRA_CHANGED_PACKAGE_LIST
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains a string array of all of the components that have changed.public static final String EXTRA_CHANGED_UID_LIST
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains an integer array of uids of all of the components
that have changed.public static final String EXTRA_CLIENT_LABEL
public static final String EXTRA_CLIENT_INTENT
public static final String EXTRA_LOCAL_ONLY
ACTION_GET_CONTENT
intent should only return
data that is on the local device. This is a boolean extra; the default
is false. If true, an implementation of ACTION_GET_CONTENT should only allow
the user to select media that is already on the device, not requiring it
be downloaded from a remote service when opened. Another way to look
at it is that such content should generally have a "_data" column to the
path of the content on local external storage.public static final String EXTRA_USER_HANDLE
ACTION_USER_ADDED
, ACTION_USER_REMOVED
and ACTION_USER_SWITCHED
.public static final int FLAG_GRANT_READ_URI_PERMISSION
public static final int FLAG_GRANT_WRITE_URI_PERMISSION
public static final int FLAG_FROM_BACKGROUND
public static final int FLAG_DEBUG_LOG_RESOLUTION
public static final int FLAG_EXCLUDE_STOPPED_PACKAGES
public static final int FLAG_INCLUDE_STOPPED_PACKAGES
FLAG_EXCLUDE_STOPPED_PACKAGES
is not set. If both of these
flags are set, this one wins (it allows overriding of exclude for
places where the framework may automatically set the exclude flag).public static final int FLAG_ACTIVITY_NO_HISTORY
noHistory
attribute.public static final int FLAG_ACTIVITY_SINGLE_TOP
public static final int FLAG_ACTIVITY_NEW_TASK
This flag is generally used by activities that want to present a "launcher" style behavior: they give the user a list of separate things that can be done, which otherwise run completely independently of the activity launching them.
When using this flag, if a task is already running for the activity
you are now starting, then a new activity will not be started; instead,
the current task will simply be brought to the front of the screen with
the state it was last in. See FLAG_ACTIVITY_MULTIPLE_TASK
for a flag
to disable this behavior.
This flag can not be used when the caller is requesting a result from the activity being launched.
public static final int FLAG_ACTIVITY_MULTIPLE_TASK
FLAG_ACTIVITY_NEW_TASK
to disable the
behavior of bringing an existing task to the foreground. When set,
a new task is always started to host the Activity for the
Intent, regardless of whether there is already an existing task running
the same thing.
Because the default system does not include graphical task management, you should not use this flag unless you provide some way for a user to return back to the tasks you have launched.
This flag is ignored if
FLAG_ACTIVITY_NEW_TASK
is not set.
See Tasks and Back Stack for more information about tasks.
public static final int FLAG_ACTIVITY_CLEAR_TOP
For example, consider a task consisting of the activities: A, B, C, D. If D calls startActivity() with an Intent that resolves to the component of activity B, then C and D will be finished and B receive the given Intent, resulting in the stack now being: A, B.
The currently running instance of activity B in the above example will
either receive the new intent you are starting here in its
onNewIntent() method, or be itself finished and restarted with the
new intent. If it has declared its launch mode to be "multiple" (the
default) and you have not set FLAG_ACTIVITY_SINGLE_TOP
in
the same intent, then it will be finished and re-created; for all other
launch modes or if FLAG_ACTIVITY_SINGLE_TOP
is set then this
Intent will be delivered to the current instance's onNewIntent().
This launch mode can also be used to good effect in conjunction with
FLAG_ACTIVITY_NEW_TASK
: if used to start the root activity
of a task, it will bring any currently running instance of that task
to the foreground, and then clear it to its root state. This is
especially useful, for example, when launching an activity from the
notification manager.
See Tasks and Back Stack for more information about tasks.
public static final int FLAG_ACTIVITY_FORWARD_RESULT
Activity.setResult(int)
and have that result sent back to
the reply target of the original activity.public static final int FLAG_ACTIVITY_PREVIOUS_IS_TOP
public static final int FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
public static final int FLAG_ACTIVITY_BROUGHT_TO_FRONT
launchMode
documentation for the singleTask mode.public static final int FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
public static final int FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
public static final int FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
(typically as a result of
the user re-launching it from home), this activity and all on top of
it will be finished so that the user does not return to them, but
instead returns to whatever activity preceeded it.
This is useful for cases where you have a logical break in your application. For example, an e-mail application may have a command to view an attachment, which launches an image view activity to display it. This activity should be part of the e-mail application's task, since it is a part of the task the user is involved in. However, if the user leaves that task, and later selects the e-mail app from home, we may like them to return to the conversation they were viewing, not the picture attachment, since that is confusing. By setting this flag when launching the image viewer, that viewer and any activities it starts will be removed the next time the user returns to mail.
public static final int FLAG_ACTIVITY_NO_USER_ACTION
Activity.onUserLeaveHint()
callback from occurring on the current frontmost activity before it is
paused as the newly-started activity is brought to the front.
Typically, an activity can rely on that callback to indicate that an explicit user action has caused their activity to be moved out of the foreground. The callback marks an appropriate point in the activity's lifecycle for it to dismiss any notifications that it intends to display "until the user has seen them," such as a blinking LED.
If an activity is ever started via any non-user-driven events such as
phone-call receipt or an alarm handler, this flag should be passed to Context.startActivity
, ensuring that the pausing
activity does not think the user has acknowledged its notification.
public static final int FLAG_ACTIVITY_REORDER_TO_FRONT
Context.startActivity()
,
this flag will cause the launched activity to be brought to the front of its
task's history stack if it is already running.
For example, consider a task consisting of four activities: A, B, C, D.
If D calls startActivity() with an Intent that resolves to the component
of activity B, then B will be brought to the front of the history stack,
with this resulting order: A, C, D, B.
This flag will be ignored if FLAG_ACTIVITY_CLEAR_TOP
is also
specified.
public static final int FLAG_ACTIVITY_NO_ANIMATION
Context.startActivity()
,
this flag will prevent the system from applying an activity transition
animation to go to the next activity state. This doesn't mean an
animation will never run -- if another activity change happens that doesn't
specify this flag before the activity started here is displayed, then
that transition will be used. This flag can be put to good use
when you are going to do a series of activity operations but the
animation seen by the user shouldn't be driven by the first activity
change but rather a later one.public static final int FLAG_ACTIVITY_CLEAR_TASK
Context.startActivity()
,
this flag will cause any existing task that would be associated with the
activity to be cleared before the activity is started. That is, the activity
becomes the new root of an otherwise empty task, and any old activities
are finished. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK
.public static final int FLAG_ACTIVITY_TASK_ON_HOME
Context.startActivity()
,
this flag will cause a newly launching task to be placed on top of the current
home activity task (if there is one). That is, pressing back from the task
will always return the user to home even if that was not the last activity they
saw. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK
.public static final int FLAG_RECEIVER_REGISTERED_ONLY
public static final int FLAG_RECEIVER_REPLACE_PENDING
Intent.filterEquals
returning
true for the intents of the two broadcasts. When a match is found,
the new broadcast (and receivers associated with it) will replace the
existing one in the pending broadcast list, remaining at the same
position in the list.
This flag is most typically used with sticky broadcasts, which only care about delivering the most recent values of the broadcast to their receivers.
public static final int FLAG_RECEIVER_FOREGROUND
public static final int FLAG_RECEIVER_REGISTERED_ONLY_BEFORE_BOOT
FLAG_RECEIVER_REGISTERED_ONLY
is specified in the broadcast intent, this flag is unnecessary.
This flag is only for use by system sevices as a convenience to avoid having to implement a more complex mechanism around detection of boot completion.
public static final int FLAG_RECEIVER_BOOT_UPGRADE
public static final int IMMUTABLE_FLAGS
public static final int URI_INTENT_SCHEME
toUri(int)
and parseUri(java.lang.String, int)
: the URI string
always has the "intent:" scheme. This syntax can be used when you want
to later disambiguate between URIs that are intended to describe an
Intent vs. all others that should be treated as raw URIs. When used
with parseUri(java.lang.String, int)
, any other scheme will result in a generic
VIEW action for that raw URI.public static final int FILL_IN_ACTION
fillIn(android.content.Intent, int)
to allow the current action value to be
overwritten, even if it is already set.public static final int FILL_IN_DATA
fillIn(android.content.Intent, int)
to allow the current data or type value
overwritten, even if it is already set.public static final int FILL_IN_CATEGORIES
fillIn(android.content.Intent, int)
to allow the current categories to be
overwritten, even if they are already set.public static final int FILL_IN_COMPONENT
fillIn(android.content.Intent, int)
to allow the current component value to be
overwritten, even if it is already set.public static final int FILL_IN_PACKAGE
fillIn(android.content.Intent, int)
to allow the current package value to be
overwritten, even if it is already set.public static final int FILL_IN_SOURCE_BOUNDS
fillIn(android.content.Intent, int)
to allow the current bounds rectangle to be
overwritten, even if it is already set.public static final int FILL_IN_SELECTOR
fillIn(android.content.Intent, int)
to allow the current selector to be
overwritten, even if it is already set.public static final int FILL_IN_CLIP_DATA
fillIn(android.content.Intent, int)
to allow the current ClipData to be
overwritten, even if it is already set.public static final Parcelable.Creator<Intent> CREATOR
public Intent()
public Intent(Intent o)
public Intent(String action)
action
- The Intent action, such as ACTION_VIEW.public Intent(String action, Uri uri)
Note: scheme and host name matching in the Android framework is case-sensitive, unlike the formal RFC. As a result, you should always ensure that you write your Uri with these elements using lower case letters, and normalize any Uris you receive from outside of Android to ensure the scheme and host is lower case.
action
- The Intent action, such as ACTION_VIEW.uri
- The Intent data URI.public Intent(Context packageContext, Class<?> cls)
setComponent(android.content.ComponentName)
for more information on the repercussions of this.packageContext
- A Context of the application package implementing
this class.cls
- The component class that is to be used for the intent.setClass(android.content.Context, java.lang.Class<?>)
,
setComponent(android.content.ComponentName)
,
Intent(String, android.net.Uri , Context, Class)
public Intent(String action, Uri uri, Context packageContext, Class<?> cls)
Intent(String, android.net.Uri)
to
construct the Intent and then calling setClass(android.content.Context, java.lang.Class<?>)
to set its
class.
Note: scheme and host name matching in the Android framework is case-sensitive, unlike the formal RFC. As a result, you should always ensure that you write your Uri with these elements using lower case letters, and normalize any Uris you receive from outside of Android to ensure the scheme and host is lower case.
action
- The Intent action, such as ACTION_VIEW.uri
- The Intent data URI.packageContext
- A Context of the application package implementing
this class.cls
- The component class that is to be used for the intent.Intent(String, android.net.Uri)
,
Intent(Context, Class)
,
setClass(android.content.Context, java.lang.Class<?>)
,
setComponent(android.content.ComponentName)
protected Intent(Parcel in)
public static Intent createChooser(Intent target, CharSequence title)
ACTION_CHOOSER
Intent.
Builds a new ACTION_CHOOSER
Intent that wraps the given
target intent, also optionally supplying a title. If the target
intent has specified FLAG_GRANT_READ_URI_PERMISSION
or
FLAG_GRANT_WRITE_URI_PERMISSION
, then these flags will also be
set in the returned chooser intent, with its ClipData set appropriately:
either a direct reflection of getClipData()
if that is non-null,
or a new ClipData build from getData()
.
target
- The Intent that the user will be selecting an activity
to perform.title
- Optional title that will be displayed in the chooser.Context.startActivity()
and
related methods.public Object clone()
Object
Object
. The default
implementation returns a so-called "shallow" copy: It creates a new
instance of the same class and then copies the field values (including
object references) from this instance to the new instance. A "deep" copy,
in contrast, would also recursively clone nested objects. A subclass that
needs to implement this kind of cloning should call super.clone()
to create the new instance and then create deep copies of the nested,
mutable objects.public Intent cloneFilter()
public static Intent makeMainActivity(ComponentName mainActivity)
The returned Intent has the given Activity component as its explicit
component, ACTION_MAIN
as its action, and includes the
category CATEGORY_LAUNCHER
. This does not have
FLAG_ACTIVITY_NEW_TASK
set, though typically you will want
to do that through addFlags(int)
on the returned Intent.
mainActivity
- The main activity component that this Intent will
launch.setClass(android.content.Context, java.lang.Class<?>)
,
setComponent(android.content.ComponentName)
public static Intent makeMainSelectorActivity(String selectorAction, String selectorCategory)
The returned Intent has ACTION_MAIN
as its action, and includes the
category CATEGORY_LAUNCHER
. This does not have
FLAG_ACTIVITY_NEW_TASK
set, though typically you will want
to do that through addFlags(int)
on the returned Intent.
selectorAction
- The action name of the Intent's selector.selectorCategory
- The name of a category to add to the Intent's
selector.setSelector(Intent)
public static Intent makeRestartActivityTask(ComponentName mainActivity)
makeMainActivity(ComponentName)
,
but also sets the flags FLAG_ACTIVITY_NEW_TASK
and
FLAG_ACTIVITY_CLEAR_TASK
.mainActivity
- The activity component that is the root of the
task; this is the activity that has been published in the application's
manifest as the main launcher icon.@Deprecated public static Intent getIntent(String uri) throws URISyntaxException
parseUri(java.lang.String, int)
instead.parseUri(java.lang.String, int)
with 0 flags.URISyntaxException
public static Intent parseUri(String uri, int flags) throws URISyntaxException
toUri(int)
. If the Intent was not generate by toUri(), its data
will be the entire URI and its action will be ACTION_VIEW.
The URI given here must not be relative -- that is, it must include the scheme and full path.
uri
- The URI to turn into an Intent.flags
- Additional processing flags. Either 0 or
URI_INTENT_SCHEME
.URISyntaxException
- Throws URISyntaxError if the basic URI syntax
it bad (as parsed by the Uri class) or the Intent data within the
URI is invalid.toUri(int)
public static Intent getIntentOld(String uri) throws URISyntaxException
URISyntaxException
public String getAction()
ACTION_VIEW
. The action describes the general way the rest of
the information in the intent should be interpreted -- most importantly,
what to do with the data returned by getData()
.setAction(java.lang.String)
public Uri getData()
getScheme()
,
setData(android.net.Uri)
public String getDataString()
getData()
, but returns the URI as an encoded
String.public String getScheme()
This is the same as calling getData().getScheme() (and checking for null data).
getData()
public String getType()
resolveType(ContentResolver)
,
setType(java.lang.String)
public String resolveType(Context context)
getType()
,
resolveType(ContentResolver)
public String resolveType(ContentResolver resolver)
resolver
- A ContentResolver that can be used to determine the MIME
type of the intent's data.getType()
,
resolveType(Context)
public String resolveTypeIfNeeded(ContentResolver resolver)
resolver
- A ContentResolver that can be used to determine the MIME
type of the intent's data.public boolean hasCategory(String category)
category
- The category to check.getCategories()
,
addCategory(java.lang.String)
public Set<String> getCategories()
hasCategory(java.lang.String)
,
addCategory(java.lang.String)
public Intent getSelector()
setSelector(android.content.Intent)
for more information.setSelector(android.content.Intent)
public ClipData getClipData()
ClipData
associated with this Intent. If there is
none, returns null. See setClipData(android.content.ClipData)
for more information.#setClipData;
public void setExtrasClassLoader(ClassLoader loader)
loader
- a ClassLoader, or null to use the default loader
at the time of unmarshalling.public boolean hasExtra(String name)
name
- the extra's namepublic boolean hasFileDescriptors()
public void setAllowFds(boolean allowFds)
@Deprecated public Object getExtra(String name)
name
- The name of the desired item.public boolean getBooleanExtra(String name, boolean defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, boolean)
public byte getByteExtra(String name, byte defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, byte)
public short getShortExtra(String name, short defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, short)
public char getCharExtra(String name, char defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, char)
public int getIntExtra(String name, int defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, int)
public long getLongExtra(String name, long defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, long)
public float getFloatExtra(String name, float defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, float)
public double getDoubleExtra(String name, double defaultValue)
name
- The name of the desired item.defaultValue
- the value to be returned if no value of the desired
type is stored with the given name.putExtra(String, double)
public String getStringExtra(String name)
name
- The name of the desired item.putExtra(String, String)
public CharSequence getCharSequenceExtra(String name)
name
- The name of the desired item.putExtra(String, CharSequence)
public <T extends Parcelable> T getParcelableExtra(String name)
name
- The name of the desired item.putExtra(String, Parcelable)
public Parcelable[] getParcelableArrayExtra(String name)
name
- The name of the desired item.putExtra(String, Parcelable[])
public <T extends Parcelable> ArrayList<T> getParcelableArrayListExtra(String name)
name
- The name of the desired item.putParcelableArrayListExtra(String, ArrayList)
public Serializable getSerializableExtra(String name)
name
- The name of the desired item.putExtra(String, Serializable)
public ArrayList<Integer> getIntegerArrayListExtra(String name)
name
- The name of the desired item.putIntegerArrayListExtra(String, ArrayList)
public ArrayList<String> getStringArrayListExtra(String name)
name
- The name of the desired item.putStringArrayListExtra(String, ArrayList)
public ArrayList<CharSequence> getCharSequenceArrayListExtra(String name)
name
- The name of the desired item.putCharSequenceArrayListExtra(String, ArrayList)
public boolean[] getBooleanArrayExtra(String name)
name
- The name of the desired item.putExtra(String, boolean[])
public byte[] getByteArrayExtra(String name)
name
- The name of the desired item.putExtra(String, byte[])
public short[] getShortArrayExtra(String name)
name
- The name of the desired item.putExtra(String, short[])
public char[] getCharArrayExtra(String name)
name
- The name of the desired item.putExtra(String, char[])
public int[] getIntArrayExtra(String name)
name
- The name of the desired item.putExtra(String, int[])
public long[] getLongArrayExtra(String name)
name
- The name of the desired item.putExtra(String, long[])
public float[] getFloatArrayExtra(String name)
name
- The name of the desired item.putExtra(String, float[])
public double[] getDoubleArrayExtra(String name)
name
- The name of the desired item.putExtra(String, double[])
public String[] getStringArrayExtra(String name)
name
- The name of the desired item.putExtra(String, String[])
public CharSequence[] getCharSequenceArrayExtra(String name)
name
- The name of the desired item.putExtra(String, CharSequence[])
public Bundle getBundleExtra(String name)
name
- The name of the desired item.putExtra(String, Bundle)
@Deprecated public IBinder getIBinderExtra(String name)
name
- The name of the desired item.putExtra(String, IBinder)
@Deprecated public Object getExtra(String name, Object defaultValue)
name
- The name of the desired item.defaultValue
- The default value to return in case no item is
associated with the key 'name'putExtra(java.lang.String, boolean)
public Bundle getExtras()
public int getFlags()
setFlags(int)
and let the system
take the appropriate action with them.setFlags(int)
public boolean isExcludingStopped()
public String getPackage()
resolveActivity(android.content.pm.PackageManager)
,
setPackage(java.lang.String)
public ComponentName getComponent()
resolveActivity(android.content.pm.PackageManager)
,
setComponent(android.content.ComponentName)
public Rect getSourceBounds()
public ComponentName resolveActivity(PackageManager pm)
If getComponent()
returns an explicit class, that is returned
without any further consideration.
The activity must handle the CATEGORY_DEFAULT
Intent
category to be considered.
If getAction()
is non-NULL, the activity must handle this
action.
If resolveType(android.content.Context)
returns non-NULL, the activity must handle
this type.
If addCategory(java.lang.String)
has added any categories, the activity must
handle ALL of the categories specified.
If getPackage()
is non-NULL, only activity components in
that application package will be considered.
If there are no activities that satisfy all of these conditions, a null string is returned.
If multiple activities are found to satisfy the intent, the one with the highest priority will be used. If there are multiple activities with the same priority, the system will either pick the best activity based on user preference, or resolve to a system class that will allow the user to pick an activity and forward from there.
This method is implemented simply by calling
PackageManager.resolveActivity(android.content.Intent, int)
with the "defaultOnly" parameter
true.
This API is called for you as part of starting an activity from an intent. You do not normally need to call it yourself.
pm
- The package manager with which to resolve the Intent.setComponent(android.content.ComponentName)
,
getComponent()
,
resolveActivityInfo(android.content.pm.PackageManager, int)
public ActivityInfo resolveActivityInfo(PackageManager pm, int flags)
ActivityInfo
describing the activity that should execute the intent. Resolution
follows the same rules as described for resolveActivity(android.content.pm.PackageManager)
, but
you get back the completely information about the resolved activity
instead of just its class name.pm
- The package manager with which to resolve the Intent.flags
- Addition information to retrieve as per
PackageManager.getActivityInfo()
.resolveActivity(android.content.pm.PackageManager)
public Intent setAction(String action)
action
- An action name, such as ACTION_VIEW. Application-specific
actions should be prefixed with the vendor's package name.getAction()
public Intent setData(Uri data)
setType(java.lang.String)
or
setTypeAndNormalize(java.lang.String)
.
Note: scheme matching in the Android framework is
case-sensitive, unlike the formal RFC. As a result,
you should always write your Uri with a lower case scheme,
or use Uri.normalizeScheme()
or
setDataAndNormalize(android.net.Uri)
to ensure that the scheme is converted to lower case.
data
- The Uri of the data this intent is now targeting.getData()
,
setDataAndNormalize(android.net.Uri)
,
android.net.Intent#normalize
public Intent setDataAndNormalize(Uri data)
This method automatically clears any type that was
previously set (for example, by setType(java.lang.String)
).
The data Uri is normalized using
Uri.normalizeScheme()
before it is set,
so really this is just a convenience method for
setData(data.normalize())
data
- The Uri of the data this intent is now targeting.getData()
,
setType(java.lang.String)
,
Uri.normalizeScheme()
public Intent setType(String type)
This is used to create intents that only specify a type and not data, for example to indicate the type of data to return.
This method automatically clears any data that was
previously set (for example by setData(android.net.Uri)
).
Note: MIME type matching in the Android framework is
case-sensitive, unlike formal RFC MIME types. As a result,
you should always write your MIME types with lower case letters,
or use normalizeMimeType(java.lang.String)
or setTypeAndNormalize(java.lang.String)
to ensure that it is converted to lower case.
type
- The MIME type of the data being handled by this intent.getType()
,
setTypeAndNormalize(java.lang.String)
,
setDataAndType(android.net.Uri, java.lang.String)
,
normalizeMimeType(java.lang.String)
public Intent setTypeAndNormalize(String type)
This is used to create intents that only specify a type and not data, for example to indicate the type of data to return.
This method automatically clears any data that was
previously set (for example by setData(android.net.Uri)
).
The MIME type is normalized using
normalizeMimeType(java.lang.String)
before it is set,
so really this is just a convenience method for
setType(Intent.normalizeMimeType(type))
type
- The MIME type of the data being handled by this intent.getType()
,
setData(android.net.Uri)
,
normalizeMimeType(java.lang.String)
public Intent setDataAndType(Uri data, String type)
Note: MIME type and Uri scheme matching in the
Android framework is case-sensitive, unlike the formal RFC definitions.
As a result, you should always write these elements with lower case letters,
or use normalizeMimeType(java.lang.String)
or Uri.normalizeScheme()
or
setDataAndTypeAndNormalize(android.net.Uri, java.lang.String)
to ensure that they are converted to lower case.
data
- The Uri of the data this intent is now targeting.type
- The MIME type of the data being handled by this intent.setType(java.lang.String)
,
setData(android.net.Uri)
,
normalizeMimeType(java.lang.String)
,
Uri.normalizeScheme()
,
setDataAndTypeAndNormalize(android.net.Uri, java.lang.String)
public Intent setDataAndTypeAndNormalize(Uri data, String type)
The data Uri and the MIME type are normalize using
Uri.normalizeScheme()
and normalizeMimeType(java.lang.String)
before they are set, so really this is just a convenience method for
setDataAndType(data.normalize(), Intent.normalizeMimeType(type))
data
- The Uri of the data this intent is now targeting.type
- The MIME type of the data being handled by this intent.setType(java.lang.String)
,
setData(android.net.Uri)
,
setDataAndType(android.net.Uri, java.lang.String)
,
normalizeMimeType(java.lang.String)
,
Uri.normalizeScheme()
public Intent addCategory(String category)
category
- The desired category. This can be either one of the
predefined Intent categories, or a custom category in your own
namespace.hasCategory(java.lang.String)
,
removeCategory(java.lang.String)
public void removeCategory(String category)
category
- The category to remove.addCategory(java.lang.String)
public void setSelector(Intent selector)
An example of where this may be used is with things like
CATEGORY_APP_BROWSER
. This category allows you to build an
Intent that will launch the Browser application. However, the correct
main entry point of an application is actually ACTION_MAIN
CATEGORY_LAUNCHER
with setComponent(ComponentName)
used to specify the actual Activity to launch. If you launch the browser
with something different, undesired behavior may happen if the user has
previously or later launches it the normal way, since they do not match.
Instead, you can build an Intent with the MAIN action (but no ComponentName
yet specified) and set a selector with ACTION_MAIN
and
CATEGORY_APP_BROWSER
to point it specifically to the browser activity.
Setting a selector does not impact the behavior of
filterEquals(Intent)
and filterHashCode()
. This is part of the
desired behavior of a selector -- it does not impact the base meaning
of the Intent, just what kinds of things will be matched against it
when determining who can handle it.
You can not use both a selector and setPackage(String)
on
the same base Intent.
selector
- The desired selector Intent; set to null to not use
a special selector.public void setClipData(ClipData clip)
ClipData
associated with this Intent. This replaces any
previously set ClipData.
The ClipData in an intent is not used for Intent matching or other
such operations. Semantically it is like extras, used to transmit
additional data with the Intent. The main feature of using this over
the extras for data is that FLAG_GRANT_READ_URI_PERMISSION
and FLAG_GRANT_WRITE_URI_PERMISSION
will operate on any URI
items included in the clip data. This is useful, in particular, if
you want to transmit an Intent containing multiple content:
URIs for which the recipient may not have global permission to access the
content provider.
If the ClipData contains items that are themselves Intents, any grant flags in those Intents will be ignored. Only the top-level flags of the main Intent are respected, and will be applied to all Uri or Intent items in the clip (or sub-items of the clip).
The MIME type, label, and icon in the ClipData object are not directly used by Intent. Applications should generally rely on the MIME type of the Intent itself, not what it may find in the ClipData. A common practice is to construct a ClipData for use with an Intent with a MIME type of "*\/*".
clip
- The new clip to set. May be null to clear the current clip.public Intent putExtra(String name, boolean value)
name
- The name of the extra data, with package prefix.value
- The boolean data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getBooleanExtra(String, boolean)
public Intent putExtra(String name, byte value)
name
- The name of the extra data, with package prefix.value
- The byte data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getByteExtra(String, byte)
public Intent putExtra(String name, char value)
name
- The name of the extra data, with package prefix.value
- The char data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getCharExtra(String, char)
public Intent putExtra(String name, short value)
name
- The name of the extra data, with package prefix.value
- The short data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getShortExtra(String, short)
public Intent putExtra(String name, int value)
name
- The name of the extra data, with package prefix.value
- The integer data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getIntExtra(String, int)
public Intent putExtra(String name, long value)
name
- The name of the extra data, with package prefix.value
- The long data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getLongExtra(String, long)
public Intent putExtra(String name, float value)
name
- The name of the extra data, with package prefix.value
- The float data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getFloatExtra(String, float)
public Intent putExtra(String name, double value)
name
- The name of the extra data, with package prefix.value
- The double data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getDoubleExtra(String, double)
public Intent putExtra(String name, String value)
name
- The name of the extra data, with package prefix.value
- The String data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getStringExtra(String)
public Intent putExtra(String name, CharSequence value)
name
- The name of the extra data, with package prefix.value
- The CharSequence data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getCharSequenceExtra(String)
public Intent putExtra(String name, Parcelable value)
name
- The name of the extra data, with package prefix.value
- The Parcelable data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getParcelableExtra(String)
public Intent putExtra(String name, Parcelable[] value)
name
- The name of the extra data, with package prefix.value
- The Parcelable[] data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getParcelableArrayExtra(String)
public Intent putParcelableArrayListExtra(String name, ArrayList<? extends Parcelable> value)
name
- The name of the extra data, with package prefix.value
- The ArrayListputExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getParcelableArrayListExtra(String)
public Intent putIntegerArrayListExtra(String name, ArrayList<Integer> value)
name
- The name of the extra data, with package prefix.value
- The ArrayListputExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getIntegerArrayListExtra(String)
public Intent putStringArrayListExtra(String name, ArrayList<String> value)
name
- The name of the extra data, with package prefix.value
- The ArrayListputExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getStringArrayListExtra(String)
public Intent putCharSequenceArrayListExtra(String name, ArrayList<CharSequence> value)
name
- The name of the extra data, with package prefix.value
- The ArrayListputExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getCharSequenceArrayListExtra(String)
public Intent putExtra(String name, Serializable value)
name
- The name of the extra data, with package prefix.value
- The Serializable data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getSerializableExtra(String)
public Intent putExtra(String name, boolean[] value)
name
- The name of the extra data, with package prefix.value
- The boolean array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getBooleanArrayExtra(String)
public Intent putExtra(String name, byte[] value)
name
- The name of the extra data, with package prefix.value
- The byte array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getByteArrayExtra(String)
public Intent putExtra(String name, short[] value)
name
- The name of the extra data, with package prefix.value
- The short array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getShortArrayExtra(String)
public Intent putExtra(String name, char[] value)
name
- The name of the extra data, with package prefix.value
- The char array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getCharArrayExtra(String)
public Intent putExtra(String name, int[] value)
name
- The name of the extra data, with package prefix.value
- The int array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getIntArrayExtra(String)
public Intent putExtra(String name, long[] value)
name
- The name of the extra data, with package prefix.value
- The byte array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getLongArrayExtra(String)
public Intent putExtra(String name, float[] value)
name
- The name of the extra data, with package prefix.value
- The float array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getFloatArrayExtra(String)
public Intent putExtra(String name, double[] value)
name
- The name of the extra data, with package prefix.value
- The double array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getDoubleArrayExtra(String)
public Intent putExtra(String name, String[] value)
name
- The name of the extra data, with package prefix.value
- The String array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getStringArrayExtra(String)
public Intent putExtra(String name, CharSequence[] value)
name
- The name of the extra data, with package prefix.value
- The CharSequence array data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getCharSequenceArrayExtra(String)
public Intent putExtra(String name, Bundle value)
name
- The name of the extra data, with package prefix.value
- The Bundle data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getBundleExtra(String)
@Deprecated public Intent putExtra(String name, IBinder value)
name
- The name of the extra data, with package prefix.value
- The IBinder data value.putExtras(android.content.Intent)
,
removeExtra(java.lang.String)
,
getIBinderExtra(String)
public Intent putExtras(Intent src)
src
- Contains the extras to copy.putExtra(java.lang.String, boolean)
public Intent putExtras(Bundle extras)
extras
- The Bundle of extras to add to this intent.putExtra(java.lang.String, boolean)
,
removeExtra(java.lang.String)
public Intent replaceExtras(Intent src)
src
- The exact extras contained in this Intent are copied
into the target intent, replacing any that were previously there.public Intent replaceExtras(Bundle extras)
extras
- The new set of extras in the Intent, or null to erase
all extras.public void removeExtra(String name)
putExtra(java.lang.String, boolean)
public Intent setFlags(int flags)
Context.startActivity()
and the
FLAG_RECEIVER_* flags are all for use with
Context.sendBroadcast()
.
See the Tasks and Back Stack documentation for important information on how some of these options impact the behavior of your application.
flags
- The desired flags.getFlags()
,
addFlags(int)
,
FLAG_GRANT_READ_URI_PERMISSION
,
FLAG_GRANT_WRITE_URI_PERMISSION
,
FLAG_DEBUG_LOG_RESOLUTION
,
FLAG_FROM_BACKGROUND
,
FLAG_ACTIVITY_BROUGHT_TO_FRONT
,
FLAG_ACTIVITY_CLEAR_TASK
,
FLAG_ACTIVITY_CLEAR_TOP
,
FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
,
FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
,
FLAG_ACTIVITY_FORWARD_RESULT
,
FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
,
FLAG_ACTIVITY_MULTIPLE_TASK
,
FLAG_ACTIVITY_NEW_TASK
,
FLAG_ACTIVITY_NO_ANIMATION
,
FLAG_ACTIVITY_NO_HISTORY
,
FLAG_ACTIVITY_NO_USER_ACTION
,
FLAG_ACTIVITY_PREVIOUS_IS_TOP
,
FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
,
FLAG_ACTIVITY_REORDER_TO_FRONT
,
FLAG_ACTIVITY_SINGLE_TOP
,
FLAG_ACTIVITY_TASK_ON_HOME
,
FLAG_RECEIVER_REGISTERED_ONLY
public Intent addFlags(int flags)
flags
- The new flags to set.setFlags(int)
public Intent setPackage(String packageName)
packageName
- The name of the application package to handle the
intent, or null to allow any application package.getPackage()
,
resolveActivity(android.content.pm.PackageManager)
public Intent setComponent(ComponentName component)
component
- The name of the application component to handle the
intent, or null to let the system find one for you.setClass(android.content.Context, java.lang.Class<?>)
,
setClassName(Context, String)
,
setClassName(String, String)
,
getComponent()
,
resolveActivity(android.content.pm.PackageManager)
public Intent setClassName(Context packageContext, String className)
setComponent(android.content.ComponentName)
with an
explicit class name.packageContext
- A Context of the application package implementing
this class.className
- The name of a class inside of the application package
that will be used as the component for this Intent.setComponent(android.content.ComponentName)
,
setClass(android.content.Context, java.lang.Class<?>)
public Intent setClassName(String packageName, String className)
setComponent(android.content.ComponentName)
with an
explicit application package name and class name.packageName
- The name of the package implementing the desired
component.className
- The name of a class inside of the application package
that will be used as the component for this Intent.setComponent(android.content.ComponentName)
,
setClass(android.content.Context, java.lang.Class<?>)
public Intent setClass(Context packageContext, Class<?> cls)
setComponent(ComponentName)
with the
name returned by a Class
object.packageContext
- A Context of the application package implementing
this class.cls
- The class name to set, equivalent to
setClassName(context, cls.getName())
.setComponent(android.content.ComponentName)
public void setSourceBounds(Rect r)
public int fillIn(Intent other, int flags)
setAction(java.lang.String)
.
setData(Uri)
,
setType(String)
, or setDataAndType(Uri, String)
.
addCategory(java.lang.String)
.
setPackage(java.lang.String)
.
setComponent(ComponentName)
or
related methods.
setSourceBounds(android.graphics.Rect)
.
setSelector(Intent)
.
setClipData(ClipData)
.
In addition, you can use the FILL_IN_ACTION
,
FILL_IN_DATA
, FILL_IN_CATEGORIES
, FILL_IN_PACKAGE
,
FILL_IN_COMPONENT
, FILL_IN_SOURCE_BOUNDS
,
FILL_IN_SELECTOR
, and FILL_IN_CLIP_DATA
to override
the restriction where the corresponding field will not be replaced if
it is already set.
Note: The component field will only be copied if FILL_IN_COMPONENT
is explicitly specified. The selector will only be copied if
FILL_IN_SELECTOR
is explicitly specified.
For example, consider Intent A with {data="foo", categories="bar"} and Intent B with {action="gotit", data-type="some/thing", categories="one","two"}.
Calling A.fillIn(B, Intent.FILL_IN_DATA) will result in A now containing: {action="gotit", data-type="some/thing", categories="bar"}.
other
- Another Intent whose values are to be used to fill in
the current one.flags
- Options to control which fields can be filled in.FILL_IN_ACTION
,
FILL_IN_DATA
, FILL_IN_CATEGORIES
, FILL_IN_PACKAGE
,
FILL_IN_COMPONENT
, FILL_IN_SOURCE_BOUNDS
, and
FILL_IN_SELECTOR
indicating which fields were changed.public boolean filterEquals(Intent other)
other
- The other Intent to compare against.public int filterHashCode()
filterEquals(android.content.Intent)
public String toString()
Object
getClass().getName() + '@' + Integer.toHexString(hashCode())
See Writing a useful
toString
method
if you intend implementing your own toString
method.
public String toInsecureString()
public String toInsecureStringWithClip()
public String toShortString(boolean secure, boolean comp, boolean extras, boolean clip)
public void toShortString(StringBuilder b, boolean secure, boolean comp, boolean extras, boolean clip)
@Deprecated public String toURI()
toUri(int)
instead.toUri(int)
with 0 flags.public String toUri(int flags)
Uri.parse(String)
. The URI contains the
Intent's data as the base URI, with an additional fragment describing
the action, categories, type, flags, package, component, and extras.
You can convert the returned string back to an Intent with
getIntent(java.lang.String)
.
flags
- Additional operating flags. Either 0 or
URI_INTENT_SCHEME
.public int describeContents()
Parcelable
describeContents
in interface Parcelable
public void writeToParcel(Parcel out, int flags)
Parcelable
writeToParcel
in interface Parcelable
out
- The Parcel in which the object should be written.flags
- Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE
.public void readFromParcel(Parcel in)
public static Intent parseIntent(Resources resources, XmlPullParser parser, AttributeSet attrs) throws XmlPullParserException, IOException
resources
- The Resources to use when inflating resources.parser
- The XML parser pointing at an "intent" tag.attrs
- The AttributeSet interface for retrieving extended
attribute data at the current parser location.XmlPullParserException
- If there was an XML parsing error.IOException
- If there was an I/O error.public static String normalizeMimeType(String type)
A normalized MIME type has white-space trimmed, content-type parameters removed, and is lower-case. This aligns the type with Android best practices for intent filtering.
For example, "text/plain; charset=utf-8" becomes "text/plain". "text/x-vCard" becomes "text/x-vcard".
All MIME types received from outside Android (such as user input, or external sources like Bluetooth, NFC, or the Internet) should be normalized before they are used to create an Intent.
type
- MIME data type to normalize#setType}
,
#setTypeAndNormalize}
public boolean migrateExtraStreamToClipData()
EXTRA_STREAM
in ACTION_SEND
and
ACTION_SEND_MULTIPLE
to ClipData
. Also inspects nested
intents in ACTION_CHOOSER
.