Intent 类

定义

[Android.Runtime.Register("android/content/Intent", DoNotGenerateAcw=true)]
public class Intent : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.ICloneable

[<Android.Runtime.Register("android/content/Intent", DoNotGenerateAcw=true)>]
type Intent = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable

继承

Object

Object

Intent

派生

Android.Content.PM.LabeledIntent

属性

RegisterAttribute

实现

IParcelable IJavaObject IJavaPeerable ICloneable IDisposable

注解

意向是对要执行的操作的抽象说明。 它可用于Context#startActivity(Intent) startActivity启动android.app.Activity、android.content.Context#sendBroadcast(Intent) broadcastIntent将其发送到任何感兴趣的BroadcastReceiver BroadcastReceiver组件，或android.content.Context#startServiceandroid.content.Context#bindService与后台android.app.Service通信。

意向提供了在不同应用程序中执行代码之间的后期运行时绑定的工具。 其最重要的用途是在启动活动时，可以将其视为活动之间的粘附。 它基本上是一个被动数据结构，其中包含要执行的操作的抽象说明。

<div class=“special reference”><h3>Developer Guides</h3>

有关如何创建和解决意向的信息，请阅读 意向和意向筛选器 开发人员指南。

</Div>

“IntentStructure”><h3>意向结构</h3>

意向中的主要信息部分包括：

<ul><li>

<b>操作</b> -- 要执行的常规操作，例如 #ACTION_VIEW， #ACTION_EDIT， #ACTION_MAIN，等等。

</li li><>

<b>data</b> -- 要操作的数据，例如联系人数据库中的人员记录，表示为 a android.net.Uri。

</li></ul>

操作/数据对的一些示例包括：

<ul><li>

<b>#ACTION_VIEWcontent://contacts/people/1</b> -- 显示有关标识符为“1”的人员的信息。

</li li><>

<b>#ACTION_DIALcontent://contacts/people/1</b> -- 显示填充人员的电话拨号程序。

</li li><>

<b>#ACTION_VIEWtel：123</b> -- 显示填充给定号码的电话拨号程序。 请注意 VIEW 操作如何对特定 URI 执行被视为最合理的操作。

</li li><>

<b>#ACTION_DIALtel：123</b> -- 显示填充给定号码的电话拨号程序。

</li li><>

<b>#ACTION_EDITcontent://contacts/people/1</b> -- 编辑有关标识符为“1”的人员的信息。

</li li><>

<b>#ACTION_VIEWcontent://contacts/people/</b> -- 显示用户可以浏览的人员列表。 此示例是联系人应用程序的典型顶级条目，其中显示了人员列表。 选择要查看的特定人员将导致新的意向 {<b>#ACTION_VIEWcontent://contacts/people/N</b> } 用于启动显示该人员的活动。

</li></ul>

除了这些主要属性之外，还可以包含许多辅助属性：。除了这些主要属性外，还可以包含一些辅助属性：

<ul><li>

<b>category</b> -- 提供有关要执行的操作的其他信息。 例如， #CATEGORY_LAUNCHER 表示它应作为顶级应用程序显示在 Launcher 中，同时 #CATEGORY_ALTERNATIVE 意味着它应包含在用户可以对数据片段执行的替代操作列表中。

<li>

<b>类型</b> -- 指定意向数据的显式类型（MIME 类型）。 通常，从数据本身推断类型。 通过设置此属性，可以禁用该计算并强制显式类型。

<li>

<b>component</b> -- 指定要用于意向的组件类的显式名称。 通常，这可以通过查看意向中的其他信息（操作、数据类型和类别）以及将其与可以处理它的组件进行匹配来确定。 如果设置了此属性，则不会执行任何评估，并且此组件完全按原样使用。 通过指定此属性，所有其他意向属性都变为可选。

<li>

<b>extras</b> -- 这是 Bundle 任何其他信息。 这可用于向组件提供扩展信息。 例如，如果我们有一个发送电子邮件的操作，我们还可以在此处包含额外的数据片段来提供主题、正文等。

</ul>

下面是可以使用以下附加参数指定为意向的其他操作的一些示例：

<ul><li>

< > #ACTION_MAIN b 类别<#CATEGORY_HOME为 /b> - 启动主屏幕。

</li li><>

<b>#ACTION_GET_CONTENT 具有 MIME 类型 android.provider.Contacts.Phones#CONTENT_URI vnd.android.cursor.item/phone</b> -- 显示人员电话号码列表，允许用户浏览并选取一个，并将其返回到父活动。

</li li><>

<b>#ACTION_GET_CONTENT 具有 MIME 类型和 */* 类别 #CATEGORY_OPENABLE</b> -- 显示可以打开 ContentResolver#openInputStream(Uri) ContentResolver.openInputStream()的数据的所有选取器，允许用户选取其中一个数据，然后在其中选取一些数据，并将生成的 URI 返回到调用方。 例如，这可用于电子邮件应用程序中，以允许用户选取一些要作为附件包含的数据。

</li></ul>

意向类中定义了各种标准意向操作和类别常量，但应用程序也可以定义自己的意向操作和类别常量。 这些字符串使用Java样式的范围，以确保它们是唯一的，例如，标准#ACTION_VIEW称为“android.intent.action.VIEW”。

组合起来，一组操作、数据类型、类别和额外数据为系统定义了一种语言，允许表达式短语，例如“调用 john smith 的单元格”。 随着应用程序添加到系统，它们可以通过添加新操作、类型和类别来扩展此语言，也可以通过提供处理它们的活动来修改现有短语的行为。

“IntentResolution”><h3>意向解析</h3>

你将使用两种主要形式的意向。

<ul><li>

<b>显式意向</b> 已指定组件（通过 #setComponent 或 #setClass），该组件提供要运行的确切类。 通常，这些信息不包括任何其他信息，只是应用程序在用户与应用程序交互时启动它拥有的各种内部活动的方法。

<li>

<b>隐式意向</b> 尚未指定组件;相反，它们必须包含足够的信息，以便系统确定哪些可用组件最适合为该意向运行。 </ul>

使用隐式意向时，鉴于这种任意意向，我们需要知道该意向的用途。 这由 em Intent resolution</em> 的过程进行处理，该进程<将意向映射到可以处理它的一个android.app.ActivityBroadcastReceiver、或android.app.Service（有时是两个或两个或更多个活动/>接收器）。

意向解析机制基本上围绕匹配意向与所有 已安装的应用程序包中的说明。 （另外，在广播的情况下，任何 BroadcastReceiver 显式注册的对象 Context#registerReceiver。有关此操作的更多详细信息，请参阅有关该类的文档 IntentFilter 。

意向中有三个用于解析的信息：操作、类型和类别。 使用此信息，可以对可以处理意向的组件执行 PackageManager 查询。 根据文件中提供的 AndroidManifest.xml 意向信息确定相应的组件，如下所示：

<ul><li>

< >如果给定，b 操作</b> 必须由组件作为它处理的操作列出。

<li>

<如果意向中尚未提供，则从意向的数据中检索 b>类型</b>。 与操作一样，如果意向中包含类型（显式或隐式包含在其数据中），则组件必须将其列为它处理的类型。

<li> 对于不是 content: URI 且意向中不包含显式类型的数据，而是<考虑意向数据的 http:mailto:b>方案</b>。 同样像操作一样，如果我们匹配某个方案，它必须由组件列出，因为它可以处理。 <li>

b 类别/b>（如果提供）必须<以活动处理类别的形式>列出所有</em>。<>< 也就是说，如果包含类别#CATEGORY_LAUNCHER，并且，则只会解析为包含这些类别的两><个/em> 的意向<的#CATEGORY_ALTERNATIVE组件。 活动通常需要支持#CATEGORY_DEFAULT这些活动，以便他们能够找到。Context#startActivity Context.startActivity()

</ul>

例如，请考虑 Note Pad 示例应用程序，该应用程序允许用户浏览笔记数据列表并查看有关各个项目的详细信息。 斜体中的文本指示将名称替换为特定于你自己的包的名称的位置。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
                  package="<i>com.android.notepad</i>"&gt;
                &lt;application android:icon="@drawable/app_notes"
                        android:label="@string/app_name"&gt;

                    &lt;provider class=".NotePadProvider"
                            android:authorities="<i>com.google.provider.NotePad</i>" /&gt;

                    &lt;activity class=".NotesList" android:label="@string/title_notes_list"&gt;
                        &lt;intent-filter&gt;
                            &lt;action android:name="android.intent.action.MAIN" /&gt;
                            &lt;category android:name="android.intent.category.LAUNCHER" /&gt;
                        &lt;/intent-filter&gt;
                        &lt;intent-filter&gt;
                            &lt;action android:name="android.intent.action.VIEW" /&gt;
                            &lt;action android:name="android.intent.action.EDIT" /&gt;
                            &lt;action android:name="android.intent.action.PICK" /&gt;
                            &lt;category android:name="android.intent.category.DEFAULT" /&gt;
                            &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
                        &lt;/intent-filter&gt;
                        &lt;intent-filter&gt;
                            &lt;action android:name="android.intent.action.GET_CONTENT" /&gt;
                            &lt;category android:name="android.intent.category.DEFAULT" /&gt;
                            &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
                        &lt;/intent-filter&gt;
                    &lt;/activity&gt;

                    &lt;activity class=".NoteEditor" android:label="@string/title_note"&gt;
                        &lt;intent-filter android:label="@string/resolve_edit"&gt;
                            &lt;action android:name="android.intent.action.VIEW" /&gt;
                            &lt;action android:name="android.intent.action.EDIT" /&gt;
                            &lt;category android:name="android.intent.category.DEFAULT" /&gt;
                            &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
                        &lt;/intent-filter&gt;

                        &lt;intent-filter&gt;
                            &lt;action android:name="android.intent.action.INSERT" /&gt;
                            &lt;category android:name="android.intent.category.DEFAULT" /&gt;
                            &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
                        &lt;/intent-filter&gt;

                    &lt;/activity&gt;

                    &lt;activity class=".TitleEditor" android:label="@string/title_edit_title"
                            android:theme="@android:style/Theme.Dialog"&gt;
                        &lt;intent-filter android:label="@string/resolve_title"&gt;
                            &lt;action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" /&gt;
                            &lt;category android:name="android.intent.category.DEFAULT" /&gt;
                            &lt;category android:name="android.intent.category.ALTERNATIVE" /&gt;
                            &lt;category android:name="android.intent.category.SELECTED_ALTERNATIVE" /&gt;
                            &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
                        &lt;/intent-filter&gt;
                    &lt;/activity&gt;

                &lt;/application&gt;
            &lt;/manifest&gt;

第一个活动 com.android.notepad.NotesList用作应用的主要条目。 它可以执行三件事，如其三个意向模板所述： <ol><li>

<intent-filter>
                <action android:name="{@link #ACTION_MAIN android.intent.action.MAIN}" />
                <category android:name="{@link #CATEGORY_LAUNCHER android.intent.category.LAUNCHER}" />
            </intent-filter>

这提供了记事本应用程序的顶级条目：标准 MAIN 操作是一个主要入口点（不需要意向中的其他任何信息），LAUNCHER 类别表示应将此入口点列在应用程序启动器中。

<li>

<intent-filter>
                <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
                <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
                <action android:name="{@link #ACTION_PICK android.intent.action.PICK}" />
                <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
                &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
            &lt;/intent-filter&gt;

这会声明活动可以在笔记目录中执行的操作。 支持的类型随 < 一起提供type>标记，其中 ，可以从中检索零个或多个项的游标（）的 URI，用于保存记事板数据（）。 活动允许用户查看或编辑数据目录（通过 VIEW 和 EDIT 操作），或选取特定笔记并将其返回到调用方（通过 PICK 操作）。 另请注意此处提供的 DEFAULT 类别：此方法<>在未显式指定其组件名称时解析活动所需的</em>Context#startActivity Context.startActivity。

<li>

<intent-filter>
                <action android:name="{@link #ACTION_GET_CONTENT android.intent.action.GET_CONTENT}" />
                <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
                &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
            &lt;/intent-filter&gt;

此筛选器描述返回到用户选择的笔记的调用方的功能，而无需知道其来自何处。 数据类型 vnd.android.cursor.item/vnd.google.note 是一个 URI，可以从中检索一个（vnd.android.cursor.item）项的游标，其中包含我们的记事板数据（vnd.google.note）。 GET_CONTENT操作类似于 PICK 操作，其中活动将返回到其调用方用户选择的数据片段。 但是，在这里，调用方指定他们所需的数据类型，而不是用户将从中选取的数据类型。

</ol>

鉴于这些功能，以下意向将解析为 NotesList 活动：

<ul><li>

<b>{ action=android.app.action.MAIN }</b> 匹配可用作应用程序中顶级入口点的所有活动。

<li>

<b>{ action=android.app.action.MAIN， category=android.app.category.LAUNCHER }</b> 是启动器用来填充其顶级列表的实际意向。

<li>

<b>{ action=android.intent.action.VIEW data=content：//com.google.provider.NotePad/notes }</b> 显示“content://com.google.provider.NotePad/notes”下的所有笔记的列表，用户可以浏览并查看其详细信息。

<li>

<b>{ action=android.app.action.PICK data=content：//com.google.provider.NotePad/notes }</b> 提供了“content://com.google.provider.NotePad/notes”下的笔记列表，用户可以从中选取其数据 URL 返回给调用方的笔记。

<li>

<b>{ action=android.app.action.GET_CONTENT type=vnd.android.cursor.item/vnd.google.note }</b> 类似于选取操作，但允许调用方指定他们想要返回的数据类型，以便系统可以找到适当的活动来选取该数据类型的内容。

</ul>

第二个活动 com.android.notepad.NoteEditor向用户显示单个笔记条目，并允许他们对其进行编辑。 它可以按照其两个意向模板所述执行两项操作： <ol><li>

<intent-filter android:label="@string/resolve_edit">
                <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
                <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
                <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
                &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
            &lt;/intent-filter&gt;

此活动的第一个主要用途是让用户与单个笔记进行交互，如 MIME 类型 vnd.android.cursor.item/vnd.google.note所谴责。 活动可以查看笔记或允许用户编辑笔记。 同样，我们支持 DEFAULT 类别，以允许在不显式指定其组件的情况下启动活动。

<li>

<intent-filter>
                <action android:name="{@link #ACTION_INSERT android.intent.action.INSERT}" />
                <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
                &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
            &lt;/intent-filter&gt;

此活动的辅助用途是将新的笔记条目插入到现有笔记目录中。 当用户创建新笔记时，将使用此操作：在笔记目录中执行 INSERT 操作，导致此活动运行，并让用户创建新的笔记数据，然后它将其添加到内容提供程序。

</ol>

鉴于这些功能，以下意向将解析为 NoteEditor 活动：

<ul><li>

<b>{ action=android.intent.action.VIEW data=content：//com.google.provider.NotePad/notes/var>{ID}</<var> }</b> 向用户显示 note <var>{ID}</var> 的内容。

<li>

<b>{ action=android.app.action.EDIT data=content：//com.google.provider.NotePad/notes/<var>{ID}</var> }</b> 允许用户编辑 note <var>{ID}</var> 的内容。

<li>

<b>{ action=android.app.action.INSERT data=content：//com.google.provider.NotePad/notes }</b> 在“content://com.google.provider.NotePad/notes”的备注列表中创建新的空笔记，并允许用户对其进行编辑。 如果他们保留更改，新创建的便笺的 URI 将返回到调用方。

</ul>

最后一个活动 com.android.notepad.TitleEditor允许用户编辑笔记的标题。 这可以实现为应用程序直接调用的类（通过在意向中显式设置其组件），但此处我们演示了一种可以对现有数据发布替代操作的方法：

<intent-filter android:label="@string/resolve_title">
                &lt;action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" /&gt;
                &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
                &lt;category android:name="{@link #CATEGORY_ALTERNATIVE android.intent.category.ALTERNATIVE}" /&gt;
                &lt;category android:name="{@link #CATEGORY_SELECTED_ALTERNATIVE android.intent.category.SELECTED_ALTERNATIVE}" /&gt;
                &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
            &lt;/intent-filter&gt;

在此处的单个意向模板中，我们创建了自己的专用操作， com.android.notepad.action.EDIT_TITLE 即编辑笔记的标题。 它必须在特定的笔记（数据类型 vnd.android.cursor.item/vnd.google.note）上调用，如上一视图和编辑操作，但此处显示和编辑笔记数据中包含的标题。

除了像往常一样支持默认类别外，我们的游戏编辑器还支持其他两个标准类别：ALTERNATIVE 和 SELECTED_ALTERNATIVE。 通过实现这些类别，其他人可以查找它提供的特殊操作，而无需直接了解它， android.content.pm.PackageManager#queryIntentActivityOptions 或者更频繁地使用此方法生成动态菜单项 android.view.Menu#addIntentOptions。 请注意，此处的意向模板还提供了模板（通过 android:label="@string/resolve_title"）的显式名称，以更好地控制用户在将此活动呈现时看到的内容作为他们正在查看的数据的替代操作。

鉴于这些功能，以下意向将解析为 TitleEditor 活动：

<ul><li>

<b>{ action=com.android.notepad.action.EDIT_TITLE data=content：//com.google.provider.NotePad/notes/<var>{ID}</var> }</b> 显示并允许用户编辑与笔记 <var>{ID}</var> 关联的游戏。

</ul>

<h3>标准活动操作</h3>

这些是意向为启动活动定义的当前标准操作（通常通过 Context#startActivity。 最重要的，到目前为止，最常用的是 #ACTION_MAIN 和 #ACTION_EDIT。

<ul><li>#ACTION_ANSWER<><>#ACTION_EDIT<#ACTION_PICK>#ACTION_CHOOSER<>#ACTION_GET_CONTENT><#ACTION_DIAL>#ACTION_CALL<>#ACTION_SEND<><#ACTION_SENDTO<><>#ACTION_ATTACH_DATA<#ACTION_INSERT<#ACTION_SYNC>><#ACTION_RUN#ACTION_PICK_ACTIVITY><#ACTION_DELETE<>>>#ACTION_WEB_SEARCH><<>#ACTION_FACTORY_TEST#ACTION_MAIN><<#ACTION_VIEW<#ACTION_SEARCH/ul>

<h3>标准广播操作</h3>

这些是意向定义的用于接收广播的当前标准操作（通常通过 或 清单中的标记。

<ul><li>#ACTION_PACKAGE_RESTARTED<<<>#ACTION_PACKAGE_REMOVED<#ACTION_PACKAGE_CHANGED>><#ACTION_PACKAGES_SUSPENDED#ACTION_TIMEZONE_CHANGED>#ACTION_PACKAGE_DATA_CLEARED>><><#ACTION_TIME_CHANGED<#ACTION_BOOT_COMPLETED<#ACTION_PACKAGES_UNSUSPENDED><><#ACTION_TIME_TICK#ACTION_UID_REMOVED#ACTION_PACKAGE_ADDED<>>li#ACTION_POWER_DISCONNECTED<>>#ACTION_SHUTDOWN><<#ACTION_BATTERY_CHANGED>#ACTION_POWER_CONNECTED</ul>

<strong>Note： </strong>If your app targets Android 11 （API level 30） or higher， registering broadcast， such #ACTION_PACKAGES_SUSPENDED that includes package details in the extras receives a filtered list of apps or nothing. 详细了解如何管理包可见性。

<h3>标准类别</h3>

这些是可用于进一步阐明意向 #addCategory的当前标准类别。

<ul>li li><>#CATEGORY_ALTERNATIVE<><#CATEGORY_SELECTED_ALTERNATIVE<>#CATEGORY_LAUNCHER<#CATEGORY_TAB#CATEGORY_INFO><>#CATEGORY_HOME<>><#CATEGORY_PREFERENCE>#CATEGORY_LE_DESK_DOCK<><#CATEGORY_DESK_DOCK>><#CATEGORY_CAR_DOCK#CATEGORY_HE_DESK_DOCK>#CATEGORY_TEST<<>><#CATEGORY_APP_MARKET#CATEGORY_CAR_MODE<#CATEGORY_BROWSABLE<>#CATEGORY_VR_HOME#CATEGORY_DEFAULT></ul<>

<h3>标准额外数据</h3>

这些是可用作额外数据的 #putExtra当前标准字段。

<ul>li>#EXTRA_EMAIL<#EXTRA_DOCK_STATE_LE_DESK>#EXTRA_DOCK_STATE_CAR><<><>#EXTRA_CHANGED_COMPONENT_NAME<#EXTRA_DATA_REMOVED>#EXTRA_DOCK_STATE<>#EXTRA_DOCK_STATE_HE_DESK><#EXTRA_DOCK_STATE_DESK>#EXTRA_DOCK_STATE_UNDOCKED<>#EXTRA_DONT_KILL_APP<><<>#EXTRA_INITIAL_INTENTS<>#EXTRA_CC<#EXTRA_INTENT<#EXTRA_PHONE_NUMBER>><#EXTRA_ORIGINATING_URI#EXTRA_REFERRER><#EXTRA_KEY_EVENT<>>>#EXTRA_REPLACING><<>#EXTRA_SHORTCUT_ICON#EXTRA_ALARM_COUNT><<#EXTRA_BCC<#EXTRA_REMOTE_INTENT_TOKEN<>#EXTRA_SHORTCUT_ICON_RESOURCE<李><#EXTRA_SHORTCUT_INTENT丽>#EXTRA_STREAM<<>#EXTRA_SUBJECT<<#EXTRA_TEXT>#EXTRA_TEMPLATE#EXTRA_SHORTCUT_NAME<>>丽李丽<#EXTRA_TITLE>/乌尔>#EXTRA_UID<>#EXTRA_USER_INITIATED<>

<h3>标志</h3>

这些是可在意向中使用的可能标志，可通过 #setFlags 和 #addFlags。 请参阅 #setFlags 所有可能标志的列表。

Java文档android.content.Intent。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

        E.